本文最后更新于9 天前，其中的信息可能已经过时，如有错误请发送邮件到859811039@qq.com

介绍：

Lucky 是一款基于 Golang 开发的轻量全能网络工具，核心解决内网服务公网访问问题，支持 DDNS 动态域名、反向代理、端口转发、IPv4/IPv6 互转等功能，适用于 NAS、路由器、Linux 等多种设备，零代码即可配置使用。本教程将从基础认知、安装部署、核心功能配置、常见问题解决等方面，帮助你快速掌握 Lucky 的完整使用流程。

一、基础认知：先搞懂 Lucky 的核心价值与版本差异

1.1 核心功能（解决哪些痛点）

DDNS 动态域名：绑定动态公网 IP 到个人域名，IP 变化时自动更新，无需记忆复杂 IP 地址即可远程访问内网服务；
反向代理：用域名直接访问内网服务（如 NAS 影音库、私人网盘），无需记忆繁琐端口号；
端口转发：支持 IPv4/IPv6 互转，无公网 IPv4 时可通过 IPv6 穿透访问内网；
其他实用功能：网络唤醒、计划任务、ACME 自动证书申请、FTP/WebDAV 服务等。

1.2 版本差异（如何选择适合自己的版本）

版本类型	核心特点	适用场景
Lucky 轻量版	包含 DDNS、反向代理、端口转发等常用功能，资源占用少	路由器、资源有限的嵌入式设备（新手首选）
万吉（Wanji）全能版	在轻量版基础上增加 gRPC 反向代理、CorazaWAF、CloudFlare Tunnel 等功能	硬件资源充足的 NAS、Linux 主机，需要更全面功能
Core 精简版	移除前端文件，体积最小，仅保留核心功能	存储空间极有限的路由器（不推荐新手）

提示：Docker 镜像默认是万吉全能版，GitHub 主要发布轻量版，两者配置文件通用。

二、安装部署：覆盖 4 种主流设备场景

Lucky 支持多种安装方式，不同设备对应不同方案，以下是最常用的 4 种场景，新手建议优先选择 Docker 部署（简单高效）。

2.1 场景 1：NAS 设备（以绿联 NAS 为例，Docker 部署）

前置条件

NAS 已开机，且已安装 Docker（应用中心搜索“Docker”直接安装）；
拥有个人域名（阿里云、腾讯云等均可，用于 DDNS 解析）；
路由器已开启端口转发功能。

部署步骤

下载 Lucky 镜像：打开绿联 NAS 管理后台 → 应用中心 → 我的应用 → 打开 Docker；点击左侧【镜像管理】→ 右上角【搜索镜像】，输入“gdy666/lucky”，选择最新版（标有“latest”）下载，等待 1-2 分钟完成。
创建容器（关键配置）：
1. 选中已下载的镜像，点击【创建容器】；
2. 基础配置：容器名称自定义（如“Lucky 公网工具”），勾选“开机自动启动”；
3. 网络模式：必选【host 模式】，同时支持 IPv4/IPv6，避免端口访问失败（绿联 NAS 强烈推荐）；
4. 存储卷配置（避免配置丢失）：点击【添加目录】，在 NAS 中新建文件夹（如“Lucky 配置”）；容器路径固定填“/app/conf”（v2.23.1 及以上版本，旧版本为“/goodluck”），权限设为“读写”；
5. 其他参数默认，点击【创建】，容器自动启动。
访问后台初始化：
1. 打开浏览器，输入http://你的 NAS IP:16601（如 http://192.168.1.100:16601）；
2. 默认账号密码均为“666”，登录后立即点击左侧【设置】→ 修改密码，提升安全性。

飞牛应用商店里面的lucky安装教程
1.应用商店里面搜索lucky，并且安装，
2.安装成功以后打开，默认账号密码都是”666″，
3首先进去需要在最左边找到设置，然后在里面感觉他的提示设置安全入口，修改账号密码，
4.然后在最左边寻找”动态域名”进去，点击”添加任务”进去，
5.“任务名称”随便填，AccessKey ID和AccessKey Secrer哪里搞的域名去哪里获取，你可以问一下ai，
6.{ipv6Addr}和{ipv4Addr}你有公网v4就选择下面这个，有公网v6就选择上面那个，
7.”获取公网IP方式”选择可以选择最前面两个，那个获取能获取正确ip就选择那个，
8.“IP选择匹配规则”默认不填项，但是有些时候默认，比如你飞牛获取到了两个公网ip（比如v6，你频繁开关nas，就会给你下发了那个v6）你可以输入“1,”来切换，使用的ip是那一个，
9.添加同步记录，“备注”这里可以随便填写，“记录名”你的域名，“记录内容”，“记录类型”你有公网v4就选择v4，有公网v6就选择v6那个选项，
10.其他全部保存默认（你如果懂里面的详细，可以自行修改）
11.找到“web服务”进去，上面找到“添加web服务规则”进去，“web服务规则名称”你可以随便填写，“监听类型”你有公网v4就选择ipv4，有公网v6就选择ipv6，你也可以选择全部，“监听端口”你需要穿透那个东西就填它的端口，
12.“添加子规则”，“子规则名称”你可以随便填写，“子规则开关”启用，“前端地址”就是你的域名，“后端地址就是你穿透的ip地址加端口”
13.其他全部保存默认（你如果懂里面的详细，可以自行修改）
2.2 景 2：路由器（以华硕 AX86U Pro 梅林固件为例）

开启 SSH 功能：登录路由器后台 → 高级设置 → 系统管理 → 开启“Persistent JFFS2 partition”；找到【服务】→ 开启 SSH，选择“LAN only”，端口填 22，应用设置。
一键脚本安装：
1. 打开终端工具（如 FinalShell、Putty），输入 ssh 路由器用户名@路由器 IP，输入路由器密码登录；
2. 复制执行官方安装脚本： URL="https://release.66666.host"; curl -o /tmp/install.sh "$URL/install.sh" && sh /tmp/install.sh "$URL"；
3. 等待安装完成，访问 http://路由器 IP:16601，用默认账号密码登录初始化。

2.3 场景 3：Linux 主机（Docker 部署）

直接执行以下命令（host 模式，挂载配置目录）：

# 挂载主机目录（/root/luckyconf 可自定义），删除容器后配置不丢失
docker run -d --name lucky --restart=always --net=host -v /root/luckyconf:/app/conf gdy666/lucky:v2

访问 http://Linux 主机 IP:16601 完成初始化。

2.4 场景 4：Windows 系统

不推荐 Docker 版本，建议使用“安装服务”方式：

从官方地址（https://lucky666.cn/docs/install/）下载 Windows 版本安装包；
运行安装程序，完成后打开 Lucky 后台（http://localhost:16601）；
在后台【设置】底部，点击“安装 Windows 服务”，实现开机自动启动。

三、核心功能配置：3 个高频场景实战

3.1 场景 1：DDNS 动态域名（公网访问内网服务）

作用：将动态公网 IP 绑定到个人域名，无论 IP 如何变化，通过域名即可访问内网。

域名准备：在阿里云/腾讯云等服务商处注册域名，并完成实名认证。
添加 DDNS 规则：
1. 登录 Lucky 后台 → 左侧【动态域名】→ 点击【添加】；
2. 基础设置：
  - 规则名称：自定义（如“NAS 访问域名”）；
  - 域名：输入你的个人域名（如“nas.example.com”）；
  - 记录类型：选“A”（IPv4）或“AAAA”（IPv6），根据公网 IP 类型选择；
  - IP 获取方式：选“自动获取本地 IP”（内网设备）或“通过公网 API 获取”。
3. 服务商配置：
  - 选择对应的 DNS 服务商（如“阿里云”）；
  - 填入服务商的 AccessKey ID 和 AccessKey Secret（从服务商控制台获取）；
  - 其他参数默认（更新间隔建议 5 分钟）。
4. 点击【保存】，开启规则开关，Lucky 将自动同步 IP 到域名解析。

3.2 场景 2：反向代理（域名直接访问内网服务，免记端口）

作用：例如用“nas.example.com”直接访问内网 NAS 的 5000 端口服务，无需输入“http://IP:5000”。

登录 Lucky 后台 → 左侧【Web 服务】→ 【反向代理】→ 点击【添加】；
基础配置：
1. 规则名称：自定义（如“NAS 反向代理”）；
2. 域名：输入绑定的 DDNS 域名（如“nas.example.com”）；
3. 目标地址：输入内网服务的 IP 和端口（如“http://192.168.1.100:5000”）；
4. 端口：默认 80（HTTP），若需 HTTPS，需先申请证书（见 3.4 节）。
安全设置（可选）：
1. 开启“IP 黑白名单”：仅允许指定 IP 访问，提升安全性；
2. 开启“HTTP 基本认证”：设置用户名密码，访问时需验证。
点击【保存】，开启规则开关，即可通过域名访问内网服务。

3.3 场景 3：端口转发（IPv6 转 IPv4，无公网 IPv4 可用）

作用：当运营商仅提供公网 IPv6 时，通过端口转发实现外网 IPv6 访问内网 IPv4 服务。

登录 Lucky 后台 → 左侧【端口转发】→ 点击【添加】；
规则配置：
1. 规则名称：自定义（如“IPv6 转 NAS 端口”）；
2. 监听地址：选择本机 IPv6 地址（如“::”，表示所有 IPv6 地址）；
3. 监听端口：设置外网访问端口（如 5000）；
4. 目标地址：输入内网服务的 IPv4 地址和端口（如“192.168.1.100:5000”）；
5. 协议：选“TCP+UDP”（适配多数服务）。
高级设置（可选）：
1. 开启“黑白名单”：限制访问 IP；
2. 设置“定时开关”：指定规则生效时间（如仅工作时间开启）。
点击【保存】，开启规则开关，即可通过“[IPv6 地址]:5000”访问内网 NAS 服务。

3.4 进阶：ACME 自动申请 HTTPS 证书

登录 Lucky 后台 → 左侧【证书管理】→ 【ACME 证书】→ 点击【添加】；
配置参数：
1. 证书名称：自定义（如“NAS 域名证书”）；
2. 域名：输入需要认证的域名（如“nas.example.com”）；
3. 验证方式：选“DNS 验证”（推荐，无需开放 80 端口）；
4. DNS 服务商：选择域名所属服务商（如“阿里云”），填入 AccessKey 信息；
5. 邮箱：输入用于接收证书通知的邮箱。
点击【保存】，然后点击【申请证书】，Lucky 将自动完成申请和续签。

四、常见问题解决：3 个高频坑规避

4.1 容器启动失败，提示端口占用

原因：默认 16601 端口被其他服务占用。解决：① 换桥接模式并修改端口（主机端口填 16602，容器端口仍为 16601）；② 在设备后台查看已占用端口，避开冲突端口。

4.2 重启容器后配置全丢

原因：未配置存储卷或挂载路径错误。解决：重新编辑容器，按安装步骤中的存储卷配置，绑定设备本地文件夹和“/app/conf”容器路径（v2.23.1+），确保权限为“读写”。

4.3 外网无法访问 Lucky 后台或内网服务

解决步骤： 1. 检查路由器端口转发：确保已将 Lucky 相关端口（如 80、443、16601）转发到 Lucky 所在设备的 IP； 2. 配置内网 IP 白名单：在 Lucky 配置目录下创建“localips”文件，填入内网 IP 网段（如 192.168.1.0/24），每行一条，保存后重启容器； 3. 检查防火墙：关闭设备或路由器的防火墙，或放行相关端口。

五、进阶操作：配置备份与版本升级

5.1 配置备份与迁移

备份：直接复制 Lucky 配置目录（如 NAS 中的“Lucky 配置”文件夹、Linux 中的“/root/luckyconf”）到其他设备；
迁移：在新设备安装 Lucky 后，将备份的配置文件夹替换新设备的配置目录，重启 Lucky 即可。

5.2 版本升级

Docker 版本：删除旧容器（保留配置目录），重新拉取最新镜像创建容器（命令同 2.3 节）；
脚本安装版本：重新执行安装脚本，选择“升级”选项即可。

注意：升级前建议先备份配置文件，避免版本兼容问题导致配置丢失。

六、总结

Lucky 是一款功能强大且易用的网络工具，核心解决内网服务公网访问问题。新手可从 Docker 部署开始，先配置 DDNS 和反向代理实现基础的公网访问，再根据需求拓展端口转发、HTTPS 证书等功能。遇到问题时优先检查端口转发、存储卷配置和 IP 白名单，基本能解决绝大多数场景的故障。

官方文档：https://lucky666.cn/docs/（获取最新版本和详细功能说明）

介绍：