lucky

Lucky(万吉)

本项目 CDN 加速及安全防护由 Tencent EdgeOne 赞助 亚洲最佳CDN、边缘和安全解决方案 - Tencent EdgeOne

注意：源码公布到1.4.10版本，后续暂无继续开源计划。

麻烦各位大佬发表lucky相关教程的时候不要加上“开源”神器，开源二字我不配，lucky后续也没开源打算。

    1.开源并不等于安全，闭源并不等于不安全。闭源软件开发也会受到安全人员的审查。无论是开源还是闭源软件，都有可能会受到各种安全人员的审查和研究。安全人员可以使用各种技术手段来检测软件的安全性和漏洞。
    2. 个人观点lucky这种应用类软件更多只是体力活，毫无技术含量，开源的优势在于透明度和社区参与，更多劳动力参与，但也可能导致功能过多、复杂度增加的问题。闭源软件的优势在于我想怎么写就怎么写,即使还未能从lucky中获利，lucky对我也有更深的特殊含义。
    3. 我对lucky的规划还有一大部分未实现，不想被人当免费劳动力使唤，不解释太多，就这样。

如果您是第一次使用Lucky，请务必先访问 https://lucky666.cn ，并仔细阅读相关的文档，以获得必要的信息和答案。在这些文档中，您可以了解到Lucky的基本功能和特性，掌握Lucky的使用方法，以及解决常见的问题和疑惑。

• Lucky(万吉)

  • 特性

  • 一键安装

  • OpenwrtIPK包安装

  • 使用

  • Docker中使用

  • 后台界面

  • 开发编译

  • 更新日志

  • 使用注意与常见问题

特性

Lucky最初是作为一个小工具，由开发者为自己的个人使用而开发，用于替代socat，在小米路由AX6000官方系统上实现公网IPv6转内网IPv4的功能。Lucky的设计始终致力于让更多的Linux嵌入式设备运行，以实现或集成个人用户常用功能，降低用户的硬件和软件操作学习成本，同时引导使用者注意网络安全。随着版本更新和网友反馈，Lucky不断迭代改进，拥有更多功能和更好的性能，成为用户值得信赖的工具。

Lucky 的核心程序完全采用 Golang 实现，具有高效、稳定、跨平台等优点。其后台前端则采用 Vue3.2 技术进行开发，具有良好的用户体验和响应速度。此外，Lucky 的管理后台采用前后端分离的架构，第三方开发者也可以自由使用OpenToken轻松调用Lucky的各种功能接口。

功能模块

目前已经实现/集成的主要功能模块有

• 端口转发
• 动态域名(DDNS)
• Web服务
• Stun内网穿透
• 网络唤醒
• 计划任务
• ACME自动证书
• 网络存储

端口转发

1. 主要用于实现公网 IPv6 转内网 IPv4 的 TCP/UDP 端口转发。
2. 支持界面化的管理转发规则，用户可以通过 web 后台轻松地进行规则的添加、删除、修改等操作。
3. 单条转发规则支持设置多个转发端口，这样可以实现多个内网服务端口的转发。
4. 提供了一键开关和定时开关功能，用户可以根据自己的需求设置转发规则的开启和关闭时间，还可以使用计划任务模块进行定时开关。
5. 单条规则支持黑白名单安全模式切换，用户可以根据需要选择使用白名单模式或黑名单模式。
6. 白名单模式可以让没有安全验证的内网服务端口稍微安全一点暴露到公网，提高服务可用性。
7. 实时记录最新的访问日志，方便用户了解转发情况。
8. 规则列表日志一目了然，用户可以方便地追踪转发异常，及时进行排查和处理。

动态域名(DDNS)

1. 支持接入多个不同的 DNS 服务商。
2. 支持全功能自定义回调（Callback），包括设置 BasicAuth，方便接入任意 DNS 服务商。
3. Webhook 支持自定义 headers。
4. 内置常用免费 DNS 服务商设置模板（每步、No-IP、Dynv6、Dynu），通过自定义回调进行快速接入，仅需修改相应用户密码或 token 即可一键填充。
5. 支持 阿里云，百度云，华为云，京东云，腾讯云，火山引擎，帝恩爱斯-DNS.LA,Cloudflare，deSEC,DNSPod.CN，DNSPod.COM，Dynadot，Dynv6，Freemyip ,GoDaddy，Name.com，NameSilo,Porkbun，Vercel等服务商。

Web服务

1. 支持反向代理、重定向和 URL 跳转。
2. 支持 HTTP 基本认证。
3. 支持 IP 黑白名单模式。
4. 支持 UserAgent 黑白名单。
5. 规则日志清晰易懂，便于追踪异常。
6. 支持一键开关规则和定时开关规则。

Stun内网穿透

1. 实现内网穿透，无需公网IPv4地址。
2. 适合于国内运营商级NAT1宽带网络.

网络唤醒

1. 支持远程控制唤醒和关机操作
2. 支持接入第三方物联网平台(点灯科技 巴法云),可通过各大平台的语音助手控制设备唤醒和关机.

计划任务

1. 不依赖 Linux 系统的 Cron，支持 Windows 系统。
2. 操作简便，可视化编辑。
3. 可操作控制 Lucky 框架内的其他模块开关。

ACME自动证书

1. 支持 ACME 自动证书的申请和续签。
2. 支持 阿里云，百度云，华为云，京东云，腾讯云，火山引擎，帝恩爱斯-DNS.LA,Cloudflare，deSEC,DNSPod.CN，DNSPod.COM，Dynadot，Dynv6，Freemyip ,GoDaddy，Name.com，NameSilo,Porkbun，Vercel等服务商.

网络存储

1. 网络存储模块是一个应用范围广泛的模块，它提供了将本地存储、WebDAV和阿里云盘挂载到Lucky内部的各个文件类服务功能。
2. 通过网络存储模块，你可以将添加的存储挂载到Web服务的文件服务、WebDAV、FTP和FileBrowser模块，实现更加便捷的文件管理和访问。

一键安装

• 一键安装详看这里

OpenwrtIPK包安装

• Openwrt IPK包

使用

• 默认后台管理地址 http://<运行设备IP>:16601 默认登录账号: 666 默认登录密码: 666

• 常规使用请用 -cd <配置文件夹路径> 指定配置文件夹的方式运行

  #仅指定配置文件夹路径(如果配置文件夹不存在会自动创建),建议使用绝对路径
  lucky -cd luckyconf
  

Docker中使用

• 不挂载主机目录, 删除容器同时会删除配置

  # host模式, 同时支持IPv4/IPv6, Liunx系统推荐
  docker run -d --name lucky --restart=always --net=host gdy666/lucky
  # 桥接模式, 只支持IPv4, Mac/Windows推荐,windows 不推荐使用docker版本
  docker run -d --name lucky --restart=always -p 16601:16601 gdy666/lucky
  

• 在浏览器中打开http://主机IP:16601，修改你的配置，成功

• [可选] 挂载主机目录, 删除容器后配置不会丢失。可替换 /root/luckyconf 为主机目录, 配置文件夹为lucky

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

宝塔Docker安装

1. 安装宝塔面板 (9.2.0版本及以上)，前往 宝塔面板 官网，选择正式版的脚本下载安装
2. 安装后登录宝塔面板，在菜单栏中点击 Docker ，首次进入会提示安装 Docker 服务，点击立即安装，按提示完成安装
3. 安装完成后在应用商店中找到 lucky ，点击安装，配置基本选项 即可完成安装

#开发编译

```bash
go build -v -tags "adminweb nomsgpack" -ldflags="-s -w"
```

更新日志

2026-02-01 v2.27.2
  1. 重构并优化文件服务/WebDav 前端显示。
  2. CorazaWAF：
    内置规则集更新至 v4.22.0。
    新增每条规则的功能提示。
    新增出入站阈值自定义功能。
    注：WAF 建议按需开启，请勿全选规则，避免误判正常访问。

    如何验证 WAF 是否生效？
    在已开启防护的域名后面加上测试后缀，例如：
    https://你的域名.com/?test=../../../
    生效表现：页面被拦截（显示 403 Forbidden ，Lucky/WAF）。
    未生效表现：页面能正常打开或显示 404。

  2026-01-31 Lucky v2.27.1
    1. 修复已知Bug。
    2. 网页认证页面重构优化

  2026-01-30 Lucky v2.27.1 beta1 
      1. IP 地址库：更新 ip2region 解析引擎
      2. Cloudflared：同步官方最新源码
      3. Rclone 同步官方最新源码
      4. 轻面板
      内置面板源：
      现已提供 4 种主题风格切换
      站点页面新增“搜索引擎”显示设置，支持快捷搜索
      新增前端静态源自定义默认参数功能。支持预设背景、主题及默认标签页等默认参数。
      5.修复了已知的部分 Bug。

  2026-01-28 Lucky v2.27.0 Beta1 | 轻导航体验版，全版本支持。
      本次更新带来了全新的 “轻导航” 功能，旨在通过极简的配置实现高效的面板管理。
      提供美观、响应式的站点导航内外网识别、多链接支持，Docker 容器监控、Lucky 服务状态展示等功能。

      快速上手：进入 Web服务 -> 子规则 -> 选择“轻面板”服务类型 ，填写前端域名编辑轻面板设置即可。
      配置建议：
      初次体验：无需修改“前端静态源”、“全局设置”及“图标源”，维持默认配置即可秒速开通。
      深度定制：支持自行部署前端源码，打造个性化导航界面。
       相关资源
      内置面板前端源码：https://github.com/gdy666/LuckyLightPanel
      内置图标库：icons.666666.host
      进阶技巧：非前端开发者如需深度定制，推荐结合 qoder IDE 使用 AI 辅助修改。
      Qoder注册下载地址：https://qoder.com/referral?referral_code=uaJw7kR25Ed4hiHfjRroImw6eoVfmXqj
      ⚠️ 注意事项
      Alpha 阶段：当前为体验版本，正式版发布时可能存在配置兼容性调整。
      持续关注：建议密切关注群公告，以便及时获取配置迁移或更新通知。

更多日志请查看

。