# gdy666/lucky

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

Repository: https://github.com/gdy666/lucky
Canonical: https://ross.abutalabs.com/products/lucky
Language: Go
License: MIT
License Family: permissive
Topics: ddns, ipv6, socat, stun, wol, cron, acme, aliyunpan, filebrowser, ftp, webdav, volcengine, dynadot, vercel
Last push: 2026-02-15T09:13:32+00:00

## Health v2 (maintenance only)
Score: 75/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 67, release rhythm 71, longevity 100
- inputs: {"age_days": 1512, "days_push": 199, "days_rel": 199, "gap_med": 25, "n_releases_24m": 16}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 8084, forks 730 (observed 2026-08-28T04:10:12.587663+00:00)

## What it is
Lucky (万吉) is a Go-based all-in-one networking utility for software/hardware routers and embedded Linux devices, bundling IPv6/IPv4 TCP/UDP port forwarding, reverse proxy, DDNS, STUN-based NAT traversal, Wake-on-LAN, scheduled tasks, ACME certificate automation, and network storage (WebDAV/FTP/FileBrowser) behind a single web admin UI. It was originally built to replace socat on routers and ships as a single lightweight binary with a Vue 3 backend plus an OpenToken API for third-party integrations.

## Use cases
- forward a public IPv6 port to an internal IPv4 service on my router
- run a DDNS client that supports Cloudflare, Aliyun, Tencent, and other DNS providers
- expose home services without a public IPv4 using STUN hole punching on NAT1 broadband
- wake or shut down my PC remotely over the network
- put a reverse proxy with basic auth and IP allowlist in front of self-hosted apps
- automatically obtain and renew SSL certificates via ACME
- serve my NAS files over WebDAV, FTP, and a web file browser
- run scheduled tasks on Windows or OpenWrt without relying on system cron

## When to choose
- you run a home router, NAS, or embedded Linux device (especially with Chinese ISPs, CGNAT, or IPv6) and want one small binary covering port forwarding, DDNS, and STUN traversal
- you want a single web UI to replace a pile of separate router utilities like socat, ddns-go, and cron scripts
- you need low-resource, cross-platform deployment including OpenWrt IPK packages and Docker

## When to avoid
- you require fully open-source software going forward - source is only published through v1.4.10 and later releases are closed-source binaries
- you need enterprise-grade L7 proxying, routing, or middleware extensibility comparable to Traefik, Caddy, or Nginx
- your network is not reachable via STUN traversal (STUN only works on suitable NAT types such as full-cone NAT1), or you need robust tunneling for arbitrary NATs
- you need auditable source for a security-sensitive internet-exposed component

## Facets
- artifact type: application
- maturity: active
- function: networking, proxy, http-server, scheduling, security, file-system, self-hosted
- domain: networking, self-hosted
- platform: windows, embedded, cross-platform, self-hosted
- tags: ddns, port-forwarding, reverse-proxy, wake-on-lan, stun, nat-traversal, acme, ipv6, openwrt, webdav, ftp-server, filebrowser, cron, socat-replacement, home-network, automation, linux, docker

## Member repositories
- gdy666/lucky (main) score 75

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:12.587663+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:31:19.591255+00:00, confidence not recorded.
  - readme: https://github.com/gdy666/lucky (fetched 2026-08-28T04:10:12.587663+00:00, sha cedb29512127)
- Data as of 2026-08-30T08:39:29.467469+00:00.