SuperAPI AI 工具集

cf-tunnel

部署与运维

查看项目

更新于 10-16 08:36

技能介绍

用途:把临时暴露、管理面板和端口管理统一到一个命令入口,避免端口混乱,基于 Cloudflare Tunnel 实现。

主要能力:统一入口 cf.ts 同时管理 share 与 panel;面板端口被占用时自动切换到下一个可用端口;使用固定 tmux 会话名 cf-share-web、cf-share-tunnel、cf-share-panel;status 命令聚合本地服务、tunnel、panel 与公网 URL 的状态;share.ts、panel.ts 向后兼容仍可直接使用。

使用方式:推荐运行 bun ~/.pi/agent/skills/cf-tunnel/scripts/cf.ts。启动临时暴露可用 start --dir ./demos/html 或 start --port 8766;暴露单文件用 start --file ./demos/html/index.html --route /index.html。面板操作为 panel start --port 8788 --host 127.0.0.1、panel status、panel stop。综合状态用 status;停止用 stop,可用 --share 或 --panel 只停其一。底层命令 share.ts、panel.ts 建议仅用于调试。面板默认地址 http://127.0.0.1:8788(占用则自动避让),提供 /api/status、/api/start、/api/stop、/api/logs、/api/history、/api/history/clear 等接口。

依赖与限制:需安装 cloudflared,资料给出 deb 安装命令 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 status 看实际端口,彻底重置用 stop --all 后重新 start。