Cloudflare Tunnel 管理技能（统一版）

目标：把“临时暴露 + 管理面板 + 端口管理”统一到一个命令入口，避免端口混乱。

✅ 推荐入口（统一 Bun CLI）

bun ~/.pi/agent/skills/cf-tunnel/scripts/cf.ts

命令总览

启动临时暴露（等同 share start）

bun ~/.pi/agent/skills/cf-tunnel/scripts/cf.ts start --dir ./demos/html

暴露已有端口

bun ~/.pi/agent/skills/cf-tunnel/scripts/cf.ts start --port 8766

暴露单文件

bun ~/.pi/agent/skills/cf-tunnel/scripts/cf.ts start --file ./demos/html/index.html --route /index.html

启动/停止/查看面板

bun ~/.pi/agent/skills/cf-tunnel/scripts/cf.ts panel start --port 8788 --host 127.0.0.1 bun ~/.pi/agent/skills/cf-tunnel/scripts/cf.ts panel status bun ~/.pi/agent/skills/cf-tunnel/scripts/cf.ts panel stop

综合状态（share + panel）

bun ~/.pi/agent/skills/cf-tunnel/scripts/cf.ts status

停止（默认全停）

bun ~/.pi/agent/skills/cf-tunnel/scripts/cf.ts stop

只停 share

bun ~/.pi/agent/skills/cf-tunnel/scripts/cf.ts stop --share

只停 panel

bun ~/.pi/agent/skills/cf-tunnel/scripts/cf.ts stop --panel

功能特性

• 统一入口：cf.ts 同时管理 share / panel

• 端口自动避让：面板端口占用时自动切换到下一个可用端口

• 会话清晰：固定 tmux session 名

• cf-share-web

• cf-share-tunnel

• cf-share-panel

• 状态聚合：一个命令看完整状态（本地服务 / tunnel / panel / 公网 URL）

• 向后兼容：share.ts 、panel.ts 仍可直接使用

底层命令（兼容保留）

share 底层

bun ~/.pi/agent/skills/cf-tunnel/scripts/share.ts start --dir ./demos/html bun ~/.pi/agent/skills/cf-tunnel/scripts/share.ts status bun ~/.pi/agent/skills/cf-tunnel/scripts/share.ts stop

panel 底层

bun ~/.pi/agent/skills/cf-tunnel/scripts/panel.ts --port 8788 --host 127.0.0.1

建议优先使用 cf.ts ，底层命令主要用于调试。

API 与面板

启动面板后默认地址：

• http://127.0.0.1:8788 （若占用会自动避让）

API：

• GET /api/status 当前状态

• POST /api/start 启动（body 支持 port/dir/file/route ）

• POST /api/stop 停止

• GET /api/logs 日志 tail

• GET /api/history 历史记录

• POST /api/history/clear 清空历史

依赖

Cloudflared（如未安装）

wget -q https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64.deb sudo dpkg -i cloudflared-linux-amd64.deb

本地静态服务优先级：python3 > bunx > npx （无可用工具时直接失败）

故障排查

• cf.ts status 先看三类会话是否在线

• 如果 tunnel 无 URL：检查 ~/.cf-tunnel/share-tunnel.log

• 如果 panel 打不开：cf.ts panel status 看实际端口（可能已自动避让）

• 彻底重置：cf.ts stop --all 后重新 start