CFTun-UI

KO | EN

gitlite — search

#react #typescript #golang #android #machine-learning #rust #nodejs #java #windows #cli #pytorch #security #mcp #open-source

(★ 14)

一个专注于 Cloudflare Tunnel 的自托管管理界面，让服务映射、Connector 运行状态与实例配置保持简单、清晰且可控。

CFTun-UI Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# CFTun-UI

> A compact Cloudflare Tunnel console for NAS & homelab. 🚇

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

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

```bash
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
```

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

控制台：<http://127.0.0.1:9911>

### 预览图

![CFTun-UI](https://raw.githubusercontent.com/uxiaohan/CFTun-UI/main/CFTun-UI.webp)

## ⚡ Features

| 能力 | 状态 |
| --- | --- |
| 远程托管 Tunnel | ✅ |
| HTTP / HTTPS 映射 | ✅ |
| 多 Zone 管理 | ✅ |
| DNS CNAME | 自动维护 |
| 远端 Ingress 同步 | ✅ |
| 根域名 / 左侧通配符 | ✅ |
| HTTPS 自签名 Origin | ✅ |
| Connector 启停 / 重启 | ✅ |
| QUIC / HTTP/2 | ✅ |
| IPv4 / IPv6 Edge | ✅ |
| 实时日志 | SSE |
| 本地认证与持久化 | SQLite |

## 🧬 Architecture

```text
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](https://dash.cloudflare.com/profile/api-tokens) 创建自定义 Token：

| 资源 | 权限 | 级别 |
| --- | --- | --- |
| 账户 | Cloudflare Tunnel | 编辑 |
| 账户 | Cloudflare Tunnel | 读取 |
| 区域 | DNS | 编辑 |
| 区域 | DNS | 读取 |
| 区域 | 区域 | 读取 |

## 🐳 Deploy

```bash
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 访问。

数据卷与数据库：

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

容器启动程序会初始化 `/data`，随后在加载服务前降权到 UID/GID `65532:65532`；Bun 和 `cloudflared` 均不会以 root 身份常驻运行。若 bind mount、NFS 或 SMB 不允许容器调整目录所有权，启动会输出明确的 `/data` 不可写错误并退出。

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

## 🧭 Mapping

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

子域名语法：

| 输入 | 结果 |
| --- | --- |
| `nas` | `nas.example.com` |
| `@` | `example.com` |
| `*` | `*.example.com` |
| `*.home` | `*.home.example.com` |

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

## 🛠 Development

无缓存构建：

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

## 📚 Docs

- [`TUN-API.md`](./TUN-API.md) — Cloudflare Tunnel / DNS / API
- [`开发方案.md`](./开发方案.md) — 架构与实现约束

## ☕ 捐赠支持

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

![打赏](https://raw.githubusercontent.com/uxiaohan/CFTun-UI/main/better.png)

> 感谢每一位 Sponsor，你的支持是我持续维护的动力 💪

---

CFTun-UI

CFTun-UI Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

CFTun-UI

CFTun-UI Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README