用途:把本机 localhost、127.0.0.1 或 ::1 上的 HTTP(S) 服务临时暴露为随机 https://*.trycloudflare.com 公网地址,用于短时联调。
主要能力:提供 start、status、verify、stop 四个动作;start 启动或复用 Cloudflare Quick Tunnel 并验证公网根路径,status 查询同一端口 tunnel 状态,verify 可校验指定路径及响应正文标记,stop 停止本技能创建且身份匹配的进程组,重复执行安全幂等。stdout 输出一行 JSON 信封 {ok, data, error, meta},状态值含 started、running、verified、stopped、already_stopped;诊断信息写入 stderr。
使用方式:需先安装系统依赖 cloudflared(macOS 用 brew install cloudflared,Linux 参考 Cloudflare 官方源),pip 依赖为 esflow。示例: python3 "$SKILL_ROOT/scripts/run.py" start --port 11434 --confirm-public --ttl 1800 python3 "$SKILL_ROOT/scripts/run.py" status --port 11434 python3 "$SKILL_ROOT/scripts/run.py" verify --port 11434 --path /api/tags --expect models python3 "$SKILL_ROOT/scripts/run.py" stop --port 11434 也可用 --url 指定 loopback URL(与 --port 互斥),自签名 HTTPS 可加 --no-tls-verify。start 必须带 --confirm-public;--ttl 默认 43200 秒,范围 1–86400,超出报错退出 1。
适用场景:需要让外网临时访问本机服务进行联调、验证回调或演示时使用。
限制:公网 URL 无认证,拿到 URL 即可访问,禁止暴露管理面板、数据库控制台、密钥服务或无认证写接口;不支持 TCP、固定域名、认证、长期运行或高可用;trycloudflare 域名可被枚举,URL 不可视为机密,stop 后 URL 立即失效但 CDN 缓存可能残留。仅支持 macOS / Linux,stop 依赖 ps -o lstart= 做进程身份校验,Windows 不可用。状态存于 ~/.cache/port-to-public/<session_hash>/,stop 后保留 cloudflared.log 供排查。