cfui:基于 go 的 cloudflared web UI

cfui 是一个用于管理 Cloudflare Tunnel （ cloudflared ）的 Web 控制台。它可以运行本地隧道进程，也可以通过 Cloudflare API 管理远程 Tunnel ingress 规则，支持 DDNS 、S3 兼容存储的 WebDAV 挂载，以及供 AI 客户端使用的 MCP 端点。

Web UI 已内置在二进制文件中。配置保存在数据目录下的本地 SQLite 数据库里。

功能

• 
  

  本地 Cloudflare Tunnel 运行管理

  
  
  
  
  • 在浏览器里粘贴 Cloudflare Tunnel token ，启动或停止本地隧道。
  
  
  • 支持自动启动、异常自动重启、协议、区域、重试次数、优雅关闭时间、metrics 、后量子模式、边缘 IP 版本、边缘绑定地址、TLS 校验和额外 cloudflared 参数。
  
  
  • 显示隧道状态、当前协议、最近错误和版本构建信息。
  
  
  
  


• 
  

  远程 Tunnel 管理

  
  
  
  
  • 可选功能，用于管理 Cloudflare 上托管的 Tunnel ingress 配置。
  
  
  • 通过 Account ID 和 Tunnel ID 加载已有 Tunnel 。
  
  
  • 添加、编辑和删除 public hostname 规则，支持 hostname 、path 、服务类型、服务地址、Host Header 、Origin Server Name 和 TLS 校验选项。
  
  
  • 能在可解析时从本地 Tunnel token 自动带出 Account ID 和 Tunnel ID 。
  
  
  • 在执行 Cloudflare 管理操作前，可以校验 API 权限。
  
  
  
  


• 
  

  DDNS

  
  
  
  
  • 可选功能，复用远程 Tunnel 管理里的 Cloudflare API 凭据。
  
  
  • 从可配置的 IP source URL 检测公网 IPv4 和 IPv6 。
  
  
  • 创建和更新 Cloudflare A / AAAA 记录。
  
  
  • 支持 Cloudflare 代理状态、TTL 、DNS comment 、重试设置、手动同步和最近同步记录。
  
  
  
  


• 
  

  S3 WebDAV

  
  
  
  
  • 把一个或多个 S3 兼容 bucket 路径挂载成 WebDAV 端点。
  
  
  • 支持通用 S3 兼容服务和 Cloudflare R2 预设。
  
  
  • 每个挂载可以单独设置 endpoint 、region 、bucket 、root prefix 、mount path 、Access Key ID 、Secret Access Key 、WebDAV 账号密码和认证开关。
  
  
  • 支持 S3 连接测试和 WebDAV 连接测试。
  
  
  • 内置文件面板，可以列表、上传、下载、删除、重命名和创建目录。
  
  
  • WebDAV 可以走主 HTTP 服务，也可以走独立 HTTP 端口；两种模式互斥。
  
  
  • 独立 WebDAV 模式支持手动启动/停止、可选自动启动、直连端口、自定义公开 URL ，以及跳转到 Cloudflare Tunnel 规则创建。
  
  
  • 浏览器对 WebDAV 路径发起 GET 时，会显示只读文件列表或下载文件；PROPFIND、PUT、DELETE、MKCOL、MOVE、COPY、LOCK、UNLOCK 等方法保持 WebDAV 行为。
  
  
  
  


• 
  

  MCP 访问

  
  
  
  
  • 可选的 Model Context Protocol 端点，路径为 /mcp。
  
  
  • 使用 UI 中生成的 Bearer Token 认证。
  
  
  • 提供隧道状态/配置、隧道启动/停止、最近日志、远程 Tunnel 管理操作，以及启用 DDNS 后的 DDNS 操作工具。
  
  
  
  


• 
  

  日志和运维

  
  
  
  
  • 提供最近日志 API 和可选实时日志流。
  
  
  • 支持在浏览器里过滤、复制、下载和清空日志。
  
  
  • HTTP 服务包含 panic recovery 和请求日志中间件。
  
  
  
  


• 
  

  功能开关

  
  
  
  
  • 远程 Tunnel 管理、DDNS 、MCP 、S3 WebDAV 都是可选功能。
  
  
  • 未启用的功能不会显示对应 Tab 。
  
  
  • DDNS 依赖远程 Tunnel 管理，因为它复用同一套 Cloudflare API 凭据。
  
  
  
  


• 
  

  多语言 UI

  
  
  
  
  • 内置英文、中文、日文界面翻译。
  
  
  
  

快速开始

Docker

docker run -d \

  --name cfui \

  -p 14333:14333 \

  -v cfui-data:/app/data \

  -v cfui-logs:/app/logs \

  --restart unless-stopped \

  ghcr.io/dockers-x/cfui:latest

打开：

http://localhost:14333

Docker Hub 镜像：

docker run -d \

  --name cfui \

  -p 14333:14333 \

  -v cfui-data:/app/data \

  -v cfui-logs:/app/logs \

  --restart unless-stopped \

  czyt/cfui:latest

Docker Compose

services:

  cfui:

    image: ghcr.io/dockers-x/cfui:latest

    container_name: cfui

    restart: unless-stopped

    ports:

      - "14333:14333"

      # 如果使用独立 S3 WebDAV 端口，可以额外暴露：

      # - "14334:14334"

    volumes:

      - cfui-data:/app/data

      - cfui-logs:/app/logs

    environment:

      BIND_HOST: 0.0.0.0

      PORT: 14333

      TZ: UTC

      # 可选：通过环境变量注入 Cloudflare API 凭据，避免保存在 UI 中。

      # CFUI_TUNNEL_MGMT_ENABLED: "true"

      # CLOUDFLARE_ACCOUNT_ID: your-account-id

      # CLOUDFLARE_TUNNEL_ID: your-tunnel-id

      # CLOUDFLARE_API_TOKEN: your-api-token

    healthcheck:

      test: ["CMD", "sh", "-c", "wget --no-verbose --tries=1 --spider http://localhost:$$PORT/ || exit 1"]

      interval: 30s

      timeout: 3s

      start_period: 5s

      retries: 3



volumes:

  cfui-data:

  cfui-logs:

软件仓库
https://github.com/dockers-x/cfui