gdy666/lucky

项目介绍

Lucky 把家庭或小型网络里的常见网络运维工作收进一个 Web 管理界面：DDNS、反向代理与重定向、TCP/UDP 端口转发、SSL/TLS 证书申请与续期、STUN/Cloudflared/FRP 内网穿透，以及 WebDAV、Samba、FTP、FileBrowser、DLNA、Rclone 等文件服务；另外还提供 Wake-on-LAN、定时任务、Docker 管理、Web 终端、IP 过滤、安全组、Coraza WAF、第三方认证和 Passkey 管理（功能概览）。

它最初用于在路由器上把公网 IPv6 流量转发到内网 IPv4 设备，现在也能跑在 NAS 和服务器上。适合自己管理网络、希望把分散的脚本和守护进程合并到一处的人。

快速使用

准备：一台受支持的设备（Linux、Windows、macOS、OpenWrt 路由器、NAS 或 Docker 主机），以及一个自己可控的配置目录。

1. 先看构建版本对比，按平台从安装文档和发布包安装。OpenWrt 用户可使用 luci-app-lucky。NAS 应用商店里的版本和更新节奏可能不同。
2. 启动服务，在浏览器打开 http://DEVICE_IP:16601，默认用户名和密码均为 666（开始使用）。
3. 立即修改默认凭据、设置安全入口路径，并限制管理界面的访问范围。
4. 在界面中用 Quick Start 配置需要的模块，例如 DDNS、证书、Web 服务或端口转发。能否从外网访问还取决于公网地址、路由器和防火墙设置。
5. 升级、迁移或降级前先备份配置。

Linux 上使用 host 网络的 Docker 示例（官方文档的 v3 Beta 镜像，挂载配置目录）：

docker run -d \
  --name lucky \
  --restart=always \
  --net=host \
  -v /root/luckyconf:/app/conf \
  gdy666/lucky:v3

把 /root/luckyconf 换成宿主机上的目录，容器删除重建时配置仍会保留。v3 标签跟随 Beta 更新，旧镜像的容器内配置路径可能不同（Docker 示例）。

源码与许可

仓库使用 MIT 许可证，但公开源码只覆盖到 1.4.10 版本；之后的版本不再开源，与仓库里的历史代码存在差异。评估项目时应把当前发行版当作闭源二进制，具体说明见 README 的源码声明。

使用约束

功能是否可用取决于构建版本、平台和运行环境，选定版本前先查看构建对比和模块文档。Docker 管理等功能需要额外配置和权限，不要无必要地暴露 Docker socket（安装说明）。

对外暴露服务时，认证和网络过滤很关键：使用强密码、只开放必要端口、及时更新 Lucky 和它代理的服务。Web 终端、Docker 管理和文件服务尤其要收紧访问权限（安全说明）。

按照链接的使用说明，Lucky 会上报版本、操作系统类型、架构和随机生成的设备标识，该标识不包含 MAC 地址或磁盘序列号；部署前请阅读完整说明。跨版本恢复配置时，遵循兼容性指引。

HotRepo 点评

站内唯一一条记录是 2026-11-03 的 Go 语言日榜快照：Lucky 在该榜单位列第 9，当时总 Star 为 8,311、Fork 为 745。这一次观测只能说明该项目当天在 Go 社区受到关注，数据不足以判断趋势，也没有记录到全语言日榜名次。从技术上看，这是一个覆盖面广、相对成熟的工具，但开源范围有意受限：如果自托管用户希望用统一入口管理 DDNS、代理和证书，同时又接受当前版本是通过官方渠道发布的闭源二进制，它会是一个实用选择。