| name | cf-tunnel |
| description | Cloudflare Tunnel 一键管理工具,支持统一 Bun CLI(share + panel 合并)、端口自动避让、状态检查与自解释文档 |
Cloudflare Tunnel 管理技能(统一版)
目标:把“临时暴露 + 管理面板 + 端口管理”统一到一个命令入口,避免端口混乱。
✅ 推荐入口(统一 Bun CLI)
bun ~/.pi/agent/skills/cf-tunnel/scripts/cf.ts
命令总览
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
bun ~/.pi/agent/skills/cf-tunnel/scripts/cf.ts status
bun ~/.pi/agent/skills/cf-tunnel/scripts/cf.ts stop
bun ~/.pi/agent/skills/cf-tunnel/scripts/cf.ts stop --share
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 仍可直接使用
底层命令(兼容保留)
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
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 清空历史
依赖
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