hczjl/lucky repository overview

⁠Lucky(大吉)

官方网址：https://lucky666.cn⁠

GitHub地址: https://github.com/gdy666/lucky⁠

• 目前已经实现的功能有
  • 1.替代socat,主要用于公网IPv6 tcp/udp转 内网ipv4
    • 支持界面化(web后台)管理转发规则,单条转发规则支持设置多个转发端口,一键开关指定转发规则
    • 单条规则支持黑白名单安全模式切换,白名单模式可以让没有安全验证的内网服务端口稍微安全一丢丢暴露到公网
    • Web后台支持查看最新100条日志
    • 另有精简版不带后台,支持命令行快捷设置转发规则,有利于空间有限的嵌入式设备运行.(不再提供编译版本,如有需求可以自己编译)
  • 2.动态域名服务
    • 参考和部分代码来自 https://github.com/jeessy2/ddns-go⁠
    • 在ddns-go的基础上主要改进/增加的功能有
      • 1.同时支持接入多个不同的DNS服务商
      • 2.支持http/https/socks5代理设置
      • 3.自定义(Callback)和Webhook支持自定义headers
      • 4.支持BasicAuth
      • 5.DDNS任务列表即可了解全部信息(包含错误信息),无需单独查看日志.
      • 6.调用DNS服务商接口更新域名信息前可以先通过DNS解析域名比较IP,减少对服务商接口调用.
      • 其它细节功能自己慢慢发现...
      • 没有文档,后台各处的提示信息已经足够多.
      • 支持的DNS服务商和DDNS-GO一样,有Alidns(阿里云),百度云,Cloudflare,Dnspod(腾讯云),华为云.自定义(Callback)内置有每步,No-IP,Dynv6,Dynu模版,一键填充,仅需修改相应用户密码或者token即可快速接入.
  • 3.Web服务
    • 特点
      • 设置简单
      • 支持HttpBasic认证
      • 支持IP黑白名单
      • 支持UserAgent黑白名单
      • 日志记录最近访问情况
      • 一键开关子规则
      • 前端域名与后端地址 支持一对一,一对多(均衡负载),多对多(下一级反向代理)
      • 支持307重定向和跳转
  • 4.网络唤醒
    • 特点
      • 支持远程控制唤醒和关机操作
        • 远程唤醒需要 待唤醒端所在局域网内有开启中继唤醒指令的lucky唤醒客户端
        • 远程关机需要 待关机端运行有luck唤醒客户端
      • 支持接入第三方物联网平台(点灯科技 巴法云),可通过各大平台的语音助手控制设备唤醒和关机.
        • 点灯科技支持 小爱同学 小度 天猫精灵
        • 巴法云支持小爱同学 小度 天猫精灵 google语音 AmazonAlexa
      • 具备但一般用不上的功能:支持一个设备设置多组网卡mac和多个广播地址,实现批量控制设备.
  • 5.STUN IPv4内网穿透
    • 特点
      • 无需额外服务器,将局域网服务端口暴露于IPv4公网(端口随机)
      • 适合于国内运营商级NAT1宽带网络.
  • 6.计划任务
    • 特点
      • 不依赖linux系统的cron，
      • 操作简易，可视化编辑。
  • 7.自动申请/续签ACME证书
    • 特点
      • 自动续签
      • 支持Cloudflare 腾讯云 阿里云 三个域名商

⁠Docker中使用

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

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

  Copy

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

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

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

  Copy

⁠使用注意与常见问题

• 不同于防火墙端口转发规则,不要设置没有用上的端口,会增加内存的使用.

• 如果需要使用白名单模式,请根据自身需求打开外网访问后台管理页面开关.

• 转发规则启用异常,端口转发没有生效时请登录后台查看日志.