uxiaohan/cftun-ui repository overview

⁠CFTun-UI

GitHub仓库： CFTun-UI⁠

基于 Bun + Vue 3 的 Cloudflare Tunnel 管理面板：同步远端 Ingress、维护 DNS，并独立控制 cloudflared 生命周期。

Bun · Vue 3 · TypeScript · SQLite · Distroless · AMD64 / ARM64

docker run -d \
  --name cftun-ui \
  --network host \
  --restart always \
  --stop-timeout 20 \
  -v cftun-data:/data \
  --log-opt max-size=7m \
  uxiaohan/cftun-ui:latest

docker pull uxiaohan/cftun-ui:latest
docker compose up -d

控制台：http://127.0.0.1:9911⁠

⁠预览图

⁠⚡ Features

⁠🧬 Architecture

Docker Host Network
└── cloudflare/cloudflared:2026.7.3 (Distroless)
    └── Bun (PID 1)
        ├── Vue SPA
        ├── Cloudflare API
        ├── SQLite
        └── cloudflared subprocess
            ├── 127.0.0.1:PORT
            └── LAN_IP:PORT

⁠🔑 API Token

在 Cloudflare API Tokens⁠ 创建自定义 Token：

⁠🐳 Deploy

docker compose up -d --build
docker compose logs -f cftun-ui

项目固定使用 network_mode: host，不映射端口：

• Linux：原生支持。
• macOS / Windows：Docker Desktop 4.34+，启用 Resources → Network → Host networking。
• WSL2 Debian 内运行 Docker Engine：服务监听 0.0.0.0:9911，Windows 侧通常可直接访问 127.0.0.1:9911；若 localhost 转发关闭，可使用启动日志中的 WSL IP 访问。

数据卷与数据库：

cftun-data
└── /data/cftun-ui.sqlite

日志预算：Docker 磁盘日志最多 7 MiB；Connector 页面内存日志最多 1 MiB / 500 行；SQLite 操作记录最多约 512 KiB / 500 条，WAL 自动检查点为 64 页且限制为 512 KiB。已为元数据开销预留空间，总预算控制在 10 MiB 内。

⁠🧭 Mapping

nas.example.com  →  https://192.168.1.20:5001
app.example.com  →  http://127.0.0.1:3000

子域名语法：

选择已有 Tunnel 后，CFTun-UI 会同步全部可管理的 HTTP/HTTPS 规则并关联对应 Zone 的 DNS。

⁠🛠 Development

无缓存构建：

docker buildx build --no-cache --pull --load -t cftun-ui:latest .

⁠📚 Docs

• TUN-API.md⁠ — Cloudflare Tunnel / DNS / API
• 开发方案.md⁠ — 架构与实现约束

⁠☕ 捐赠支持

如果这个项目对你有帮助，欢迎请我喝杯咖啡～