cf-tunnel

name	cf-tunnel
description	Cloudflare Tunnel 一键管理工具，支持统一 Bun CLI（share + panel 合并）、端口自动避让、状态检查与自解释文档

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 仍可直接使用

---