跳到主要内容

安装运行&升级备份

安装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镜像​

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

lucky 在docker容器内部存放配置的文件夹路径是 /goodluck

docker compose​

    services:
      lucky:
        image: gdy666/lucky
        container_name: lucky
        volumes:
          - 容器外持久化路径:/goodluck
        network_mode: host
        restart: always

unraid 带图标的​

    services:
      lucky:
        image: gdy666/lucky
        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:
          - 容器外持久化路径:/goodluck
        network_mode: host
        restart: always
提示

"在 Docker 安装的 Lucky 环境中，部分环境支持直接在 Lucky 后台上传 tar.gz 升级包进行升级。如果您的环境不支持此功能，请在 GoodLuck 对应的映射目录下创建一个名为 'bin' 的文件夹，并将相应架构的 tar.gz 升级包中的 'lucky' 文件放入该文件夹然后重启容器。Docker 版本中，'bin' 目录下的 Lucky 程序启动优先于容器内预置的 Lucky。当您混用多种升级方式并发现 Lucky 升级无效时，可以尝试删除 'bin' 目录下的 Lucky 文件，或将该文件替换为最新版本。

警告

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

警告

Windows环境可以使用Docker安装Lucky，但是并不推荐使用此方式。
相反，我们建议使用安装服务的方式来实现开机启动。
在Lucky后台设置页面下方可以找到安装/卸载Windows服务的选项。
在安装服务之前，请确保Lucky文件已经放置在你想要存放的位置。 安装Windows服务需要管理员权限运行Lucky

自动脚本安装​

提示

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

以安装2.14.0版本为例
提示

小米万兆官方系统SSH后 特别适配安装脚本

curl -o /tmp/install.sh https://6.66666.host:66/files/goluck_10k.sh && sh /tmp/install.sh https://6.66666.host:66/files 2.14.0
curl -o /tmp/install.sh http://6.66666.host:66/files/goluck_10k.sh && sh /tmp/install.sh http://6.66666.host:66/files/ 2.14.0

安装其它版本时请自行更改指令末尾的版本号

curl -o /tmp/install.sh   http://6.66666.host:66/files/golucky.sh  && sh /tmp/install.sh http://6.66666.host:66/files 2.14.0
wget -O /tmp/install.sh http://6.66666.host:66/files/golucky.sh  && sh /tmp/install.sh http://6.66666.host:66/files 2.14.0
curl -o /tmp/install.sh   https://6.66666.host:66/files/golucky.sh  && sh /tmp/install.sh https://6.66666.host:66/files 2.14.0
wget -O /tmp/install.sh https://6.66666.host:66/files/golucky.sh  && sh /tmp/install.sh https://6.66666.host:66/files 2.14.0

半自动离线脚本安装方法​

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

使用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的设置页面底部，您可以轻松地执行备份和恢复配置操作。
请确保定期备份，并在每次升级前备份配置，这样可以保证数据的安全性。