gdy666 /lucky

软硬路由公网神器,ipv6/ipv4 端口转发,反向代理,DDNS,WOL,ipv4 stun内网穿透,cron,acme,rclone,ftp,webdav,filebrowser

★ 8,318⑂ 746👁 33⑃ 6● 0▤ 48
GoCreated 2022-07-14
+0
Daily
+0
Weekly
+83
Monthly
8,318
stars
746
forks
33
watchers
6
prs
0
issues
48
releases

README

Lucky (Wanji)

中文 | English

Lucky is a networking tool for personal and home networks. Its web-based management interface helps you manage dynamic DNS, access to local services, certificates, file services, and device automation.

Originally created to forward traffic from public IPv6 to private IPv4 devices on a router, Lucky can also run on NAS devices, servers, and other platforms. It brings common networking tasks together in one interface.

Documentation · Installation and upgrades · Build comparison · Downloads · Important usage notes

 Source availability: The source published in this repository only covers versions through 1.4.10. There are currently no plans to open-source subsequent versions. Current software releases differ from the historical source in this repository and should not be described as open source.

 What Lucky can do

| Use case | Features |
| --- | --- |
| Domains and service access | Dynamic DNS (DDNS), web reverse proxying, redirects, static websites, TCP/UDP port forwarding, and SSL/TLS certificate issuance and renewal. |
| NAT traversal | STUN, Cloudflared, and FRP functionality. Network requirements and server configuration depend on the chosen solution. |
| Files and storage | Storage management and services including WebDAV, Samba, FTP, FileBrowser, DLNA, and Rclone. |
| Devices and automation | Wake-on-LAN, scheduled tasks, Docker management, a web terminal, and the light panel available through Web Services. |
| Security and authentication | IP filtering, security groups, Coraza WAF, third-party authentication, and Passkey management. |
| Administration | A web management interface, centralized logs, and configuration backup and restore. |

Availability depends on the build, platform, and runtime environment. Some features may not yet be available or may require additional configuration. See the build comparison and module documentation before choosing a build.

 Installation

- Linux, Windows, macOS, and routers: Choose the appropriate official installation method and release package for your device.
- OpenWrt: See the OpenWrt installation instructions and luci-app-lucky.
- NAS and servers: Check your device's app store for Lucky, or use Docker. Packages and update schedules may vary by platform.
- Docker: Select the appropriate image and networking mode; see the official Docker installation instructions.

 Docker example

This example uses the Wanji Docker v3 Beta image from the official documentation with Linux host networking. The v3 tag follows Beta updates, so features and configuration may change. Choose a version appropriate for your environment and back up your configuration first.

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


Replace /root/luckyconf with a configuration directory on the host. The mount preserves configuration when the container is removed or recreated. Back up before upgrading an older container, and no

Snapshot: 2026-11-04T14:00:00Z · Data license Apache-2.0 · JSON