安装运行&升级备份

先选择需要的构建版本

公开版本包括 XiaoJV、XiaoJV WAF、Lucky、Lucky Docker、小满、万吉和万吉 Docker。各版本包含的模块不同，详见版本模块对照表。

这 7 种版本均内嵌 Web 管理界面；其中 Lucky Docker 和万吉 Docker 包含 Docker 管理模块。

不同构建、不同操作系统之间的配置通用，可以根据需要自由切换。实际可用功能取决于目标构建包含的模块，本地路径等环境相关设置需按目标系统调整。跨版本恢复请先阅读配置备份安全与版本兼容。

外网无法访问Lucky

在 配置目录 下创建 localips 文件，并将实际的 内网 IP 网段 或 特定内网 IP 填入，每行一条记录。

注意： 当 localips 文件 不为空 时，系统将 忽略默认内置网段。

默认内置内网网段：

• 10.0.0.0/8
• 172.16.0.0/12
• 169.254.0.0/16
• 192.168.0.0/16

安装Lucky

Lucky提供的便捷安装方式如下

1. OpenWrtIPK包

2. Docker镜像

3. 自动脚本安装

4. 半自动离线脚本安装方法

5. 手动运行

提示

不同安装方式安装的lucky可能会存在冲突，每次切换不同安装方式之前请先卸载干净之前的安装版本。
一键安装方式的卸载是再次执行安装指令，选项2完成卸载。
Openwrt IPK包的卸载方式是执行 依次执行下面三条指令完成卸载。
opkg remove lucky
opkg remove luci-i18n-lucky-zh-cn
opkg remove luci-app-lucky

OpenWrtIPK包

Lucky官方IPk包源码地址 ： https://github.com/gdy666/luci-app-lucky

警告

使用自定义OpenWrt固件编译时，需要手动勾选luci-app-lucky和lucky包才能在编译后的固件中包含Lucky。

警告

安装官方Lucky IPK包时，必须确保您的系统已经完全卸载了所有第三方的Lucky IPK包。
否则，安装完成后，很可能无法启动Lucky。
在安装官方IPK包之前，请务必确保已完全删除 /etc/config/lucky 和 /etc/init.d/lucky。
如果在安装IPK包前已经通过一键脚本方式安装，同样需要先卸载原先版本。执行多一遍安装脚本，选项2.

IPK包下载安装步骤

1. 打开 https://github.com/gdy666/luci-app-lucky/releases 页面
2. 先安装CPU架构相应Lucky核心IPK包
3. 再安装最新的luci-app-lucky_XXX_all.ipk 和 luci-i18n-lucky-zh-cn_XXX_all.ipk

Docker镜像

v3 Beta 镜像

警告

以下 v3 tag 用于拉取对应版本的最新 v3 Beta 镜像，Beta 版本可能持续更新；请根据需要选择镜像。

版本	Docker 镜像
万吉 Docker	gdy666/lucky:v3
Lucky Docker	gdy666/lucky:v3_lucky_docker
XiaoJV WAF	gdy666/lucky:v3_xiaojv_waf
万吉	gdy666/lucky:v3_wanji
小满	gdy666/lucky:v3_xiaoman
Lucky	gdy666/lucky:v3_lucky
XiaoJV	gdy666/lucky:v3_xiaojv

万吉 Docker v3 Beta 示例（host 模式并持久化配置）：

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

Docker Compose 示例：

services:
  lucky:
    image: gdy666/lucky:v3
    container_name: lucky
    volumes:
      - 容器外持久化路径:/app/conf
      - /var/run/docker.sock:/var/run/docker.sock
    network_mode: host
    restart: always

上面的 v3 配置默认使用万吉 Docker 镜像；如需其他版本，请将 image 替换为表格中对应的镜像。下方现有 Docker 命令和 Compose 示例使用 v2 tag。

#host模式, 同时支持IPv4/IPv6, Liunx系统推荐
docker run -d --name lucky --restart=always --net=host gdy666/lucky:v2
# 桥接模式, 只支持IPv4,windows 不推荐使用docker版本
docker run -d --name lucky --restart=always -p 16601:16601 gdy666/lucky:v2
#挂载主机目录, 删除容器后配置不会丢失。可替换 /root/luckyconf 为主机目录, 配置文件为lucky.conf
docker run -d --name lucky --restart=always --net=host -v /root/luckyconf:/app/conf gdy666/lucky:v2

注意

lucky >=v2.23.1 镜像版本在docker容器内部存放配置的文件夹路径是 /app/conf

docker compose

    services:
      lucky:
        image: gdy666/lucky:v2
        container_name: lucky
        volumes:
          - 容器外持久化路径:/app/conf
          - /var/run/docker.sock:/var/run/docker.sock
        network_mode: host
        restart: always

unraid 带图标的

    services:
      lucky:
        image: gdy666/lucky:v2
        container_name: lucky
        labels:
          net.unraid.docker.icon: "https://cdn.jsdelivr.net/gh/IceWhaleTech/CasaOS-AppStore@main/Apps/Lucky/icon.png"
          net.unraid.docker.webui: "http://[IP]:[PORT:16601]"
        volumes:
          - 容器外持久化路径:/app/conf
          - /var/run/docker.sock:/var/run/docker.sock
        network_mode: host
        restart: always

提示

v2.23.1之前的docker 镜像与最新版本的docker镜像不兼容，请备份配置文件后删除旧版本的容器，重新从v2标签拉取最新版本镜像重新创建容器。 容器内部的配置文件夹路径已从 /goodluck 调整为 /app/conf，构建新容器时请确保映射到新的配置路径。 由于本次改动较大，旧容器无法直接适配，需重新创建容器。为避免影响现有用户使用，更新短期内不会再推送到 DockerHub 的 latest 标签。请在 Lucky 设置页面底部备份配置后，从 v2 标签重新拉取镜像并创建容器。

警告

Linux环境不推荐使用bridge模式
在bridge模式下，Lucky不支持IPv6，而且IPv4也可能会出现端口无法访问的情况。
如果你遇到了端口无法访问的问题，请尝试使用host模式。
如果host模式仍然无法解决问题，你可以尝试更换其他端口。
总之，如果不必使用Docker，建议不要使用Docker。

警告

在Windows环境中，虽然可以通过Docker安装Lucky，但我们不推荐这种方法。
相较之下，我们建议使用安装服务的方式，以实现开机自动启动。
在Lucky后台设置页面的底部，您可以找到安装或卸载Windows服务的选项。
在安装服务之前，请确保已将Lucky文件放置在您希望的存储位置。
请注意：以服务形式启动的Lucky不会在系统托盘中显示图标，您需要通过Lucky后台设置页面(底部)来卸载Windows服务。
安装Windows服务需要管理员权限运行Lucky

自动脚本安装

提示

确认路由器设备已经开启SSH并获取root权限（带GUI桌面的Linux设备可使用自带终端安装）
使用SSH连接工具（如putty，JuiceSSH，系统自带终端等）路由器或Linux设备的SSH管理界面或终端界面，并切换到root用户
确认设备已经安装curl或者wget下载工具。
基于OpenWrt（小米官方系统、潘多拉、高恪等）的设备请使用如下命令安装curl
*** opkg update && opkg install curl #如已安装请忽略*** 之后在SSH界面执行如下安装命令，并按照后续提示完成安装
升级新版本只需重新运行安装指令,安装完成后在后台设置页面重启程序即可.
（如无法连接或出现SSL连接错误，请尝试更换各种不同的安装源！）

URL="http://release.66666.host"; curl -o /tmp/install.sh "$URL/install.sh" && sh /tmp/install.sh "$URL"

URL="http://release.66666.host"; wget -O  /tmp/install.sh "$URL/install.sh" && sh /tmp/install.sh "$URL"

URL="https://release.66666.host"; curl -o /tmp/install.sh "$URL/install.sh" && sh /tmp/install.sh "$URL"

URL="https://release.66666.host"; wget -O  /tmp/install.sh "$URL/install.sh" && sh /tmp/install.sh "$URL"

半自动离线脚本安装方法

将daji.sh下载上传到 /tmp/目录下
执行
chmod +x daji.sh  
赋予执行权限，然后运行
sh daji.sh
查看当前CPU架构，根据CPU架构选择合适的lucky tar.gz文件上传到/tmp目录下。
tar.gz 文件从github或者网盘/Q群下载。
再次执行sh daji.sh 选择1根据提示安装即可。

警告

大部分的设备/系统都已经预装了以下的大部分依赖，使用时如无影响可以无视之
bash/ash 必须 全部缺少时无法安装及运行脚本
curl/wget 必须 全部缺少时无法在线安装及更新，无法使用节点保存功能
systemd/rc.common 一般 全部缺少时只能使用保守模式,可能无法设置开机自动启动

手动运行

如果上述安装方式都不适合你的系统环境，你可以尝试手动安装Lucky，

参照 启动方式与参数

1. 找到适合你Linux系统的版本，下载tar.gz包，解压出lucky核心程序文件并将其复制到你想要存放的位置。

2. 手动运行Lucky二进制文件，并指定配置文件的位置。例如，如果你的Lucky二进制文件在 /usr/local/bin/lucky，配置文件在 /etc/lucky/lucky.conf，则可以使用以下命令启动Lucky：

#赋予lucky执行权限 chmod +x /usr/local/bin/lucky #启动lucky /usr/local/bin/lucky -c /etc/lucky/lucky.conf

3.Windows版直接双击运行即可。

启动方式与参数

信息

如果您已经使用openwrt IPK包、一键脚本安装、docker或者固件自带方式安装lucky，可以跳过启动方式与参数这一小节内容。

启动方式

lucky只需要一个单独的可执行文件，如果你熟悉Linux，就可以将lucky二进制文件放在任何你想要的位置。

启动参数

-c 指定配置文件位置，支持相对路径和绝对路径格式。
例如，-c daji.conf 表示将配置文件保存在lucky文件所在目录下，若配置文件不存在则会自动创建。
注意：2.x版本开始不再将所有模块配置保存在同一文件中，
因此可以通过
-cd 指定配置文件存放的文件夹位置。绝对路径格式。
同时2.x版本兼容-c参数，会从1.0的配置文件路径里面选择配置文件的文件夹作为新配置的存放位置。

以下参数需要2.10.0以上版本可用，需要确保当前lucky进程正常运行，无需指定配置文件夹，实时修改lucky配置。
-rCancelSafeURL 取消安全入口。
-rDisable2FA 禁用2FA验证。
-rResetUser 重置用户账号密码为 666：666。
-rRestart 重启lucky。
-rSetHttpAdminPort 设置lucky后台HTTP访问端口。
-rSetHttpsAdminPort 设置lucky后台HTTPS访问端口。
-rUnlock 立即解锁登录限制，无需重启lucky。

提示

在 Windows 环境下，双击运行 Lucky 时会将配置文件指定为 Lucky 目录下的 lucky.conf。
初次使用时，配置文件会自动创建，不需要理会日志中的“未指定配置文件路径，使用默认路径 Lucky 所在位置，默认配置文件名 lucky.conf”的提示。

默认登陆信息

默认登陆地址 : http://\{IP地址\}:16601
默认账号：666
默认密码：666

提示

从版本2.13.9开始，在默认配置中，外网访问开关处于关闭状态。然而，在 lucky_base.lkcf 配置初始化后的十分钟内，系统允许外网访问。如果在这十分钟内执行了配置保存操作，则外网访问开关的设置将优先生效。如果错过了这个时间，您需要通过删除 lucky_base.lkcf 配置文件并重启 Lucky 进程的方式，使 lucky_base.lkcf 配置再次初始化。

从版本2.13.9开始，如果未设置安全入口或未修改默认账号密码，将无法使用所有功能模块。如果您了解相关风险并确实不想进行设置，请在设置面板中启用禁用安全入口设置检查和禁用默认账号密码检查开关（此两个选项会闪烁提示）。

从版本 2.15.8 开始，可以通过配置目录下的 localips 文件记录 IP 信息，每行记录一个 IP 或网段的格式。当 localips 文件不为空时，默认内置的网段设置将失效。只需将您希望纳入内网 IP 范围的 IP 或网段添加到 localips 文件中即可，无需重启 lucky。

使用lucky前你一定要记住

马上修改你的用户名和密码
设置你的Lucky后台安全入口
定时备份你的Lukcy配置

提示

Lucky 具有很高的可定制性，支持各种自定义脚本的运行。
然而，一旦账号密码和后台入口泄露，可能会带来无法预料的后果。
因此，设置安全入口是非常重要的一件事。
当你设置安全入口为 666 后，访问 http://{IP}:16601 时将不会显示 Lucky 登录页面。
这时，你需要访问 http://{IP}:16601/666。因此，请尽量将安全入口设置复杂一些，并在外网访问时尽可能使用 HTTPS 方式。

2.0版本配置注意

2.0版本各模块配置分离，但恢复配置的时候同时支持
导入1.x版本备份的配置文件xx.conf, 注意：2.8版本后不再支持1.0配置
导入2.X版本备份的配置文件xx.zip
导入2.X版本备份的配置文件xx.zip里面的单个模块的配置 XX.lkcf(只恢复指定模块的配置，注意不要改动单模块配置的文件名)

升级Lucky

升级前保留原版本备份

旧版本配置在多数情况下可用于新版本，但新版生成或保存的配置、备份不保证能用于旧版。反复升级、降级可能造成配置丢失、功能异常或其他未知故障。

请优先使用与目标程序版本匹配的备份。升级前单独保留原版本备份并标注版本号；降级时优先恢复由该旧版本生成的备份。详见升级、降级与备份版本。

提示

在大多数环境中，包括 *** Docker *** 和以服务形式启动的 Windows 版 Lucky，
你可以通过在 Lucky 后台页面上传适合你系统版本的 XXX.tar.gz 文件来升级 Lucky。
如果在个别环境（例如个别docker）中使用此方式升级失败，请在备份好配置文件后重新安装最新版本的 Lucky。

备份还原配置

提示

在Lucky的设置页面底部，您可以轻松地执行备份和恢复配置操作。
请定期备份，并在每次升级前单独保留当前版本的备份；恢复前核对备份来源、版本和模块范围。

所有信息都应按明文敏感信息保管

请将 Lucky 中保存的所有信息按明文敏感信息保管，请勿分享配置或备份文件。请统一按“系统被攻破或文件泄露后，全部信息都可能被获取”来评估风险，无需逐项区分存储方式。

一旦系统被入侵或配置 / 备份文件泄露，请按全部信息可能已泄露处理：更换所有已保存密码及其他服务中复用的密码，并撤销或重置相关令牌、密钥。

不要养成在不同账号、网站和设备上使用同一密码的习惯。请分别设置独立强密码，建议使用密码管理器，并为支持的服务启用双因素验证（2FA）。

安全保管与处理步骤见配置备份安全与版本兼容。