한국어 | Korean

---

한국어

一一 Agent 一的 Cloudflare 터널 워크플로우 기술。本本地 HTTP/HTTPS 公,:式:

-Quick Tunnel:T https://*.trycloudflare.com ,适合 demo、ᴗ堂、客户临时预览。 -Named Tunnel:名,名 app.example.com -> http://localhost:3000,興 webhook、长期预览、团队测试入口。

适

• localhost:3000 人人鶏
• 本本地 API 公司 URL
• 用名
• S GitHub、Slack、Stripe、n8n 웹걸이 李俊億
• 本 本 本 启动 启动 启动 启动 启动 启动 启动 启动 启动 启动 启动 启动 启动 启动 启动 启动 启动 启动 启动 启动 启动 启动 启动 启动 启动 启动 启动 启动 启动 启动 启动 启动 启动 启动 启动 启动 启动 启动 启动 启动 启动 启动 启动 启动 启动 启动 启动

合场景

-台 -、Redis、Docker API

• 大文件下下 -本地//中中中的生产服务

# # 安卓 安

.claude/skills/ /SKILL.md 目目,三 一 一 一 一,T [T4]] + scripts/ + references/ 三部分。

Claude Code 安工(줄,번역)

Claude Code 의 미션은 다음과 같습니다.

코덱 安smith:

和:T cloudflared](安卓方法 [ references/troubleshooting.md])和 Python 3。helper 樹本理 macOS / Linux 上上;Windows 上(T的 [ tasklist/taskkill]), Windows 利用 WSL 上。

빠른 터널 Quick

:

·

:

이름 터널 txt定名名

주요 특징:

• [T11]
• 名古 DNS Cloudflare

:

本地址:서울특별시 중구 남대문로 561

Quick Quick Quick:

脚:

安

터널 会本地服务暴露到公司。前前有公司:

• 토큰, 쿠키, API 키
• 미쉐린 가이드 ·

Cloudflare Tunnel Skill

中文 | English

---

中文

一个给 Agent 使用的 Cloudflare Tunnel workflow skill。它可以把本地 HTTP/HTTPS 服务暴露到公网，支持两种模式：

• Quick Tunnel：临时 https://*.trycloudflare.com 预览链接，适合 demo、课堂、客户临时预览。
• Named Tunnel：固定域名映射，例如 app.example.com -> http://localhost:3000，适合 webhook、长期预览、团队测试入口。

适合场景

• 把 localhost:3000 临时发给别人看
• 给本地 API 创建临时公网 URL
• 用固定域名访问本地开发服务
• 给 GitHub、Slack、Stripe、n8n 等 webhook 配一个公网入口
• 让 Agent 自动检查本地服务、启动 tunnel、验证公网 URL

不适合场景

• 没有认证保护的敏感后台
• 数据库、Redis、Docker API 等裸服务
• 大文件下载站或公开网盘
• 不愿意接受本地电脑断网/睡眠导致服务中断的生产服务

安装

Claude Code 只识别 .claude/skills//SKILL.md 这种目录结构，并且 helper 脚本必须随 skill 一起安装，所以请完整复制 SKILL.md + scripts/ + references/ 三部分。

Claude Code 全局安装（推荐，所有项目可用）：

git clone https://github.com/xiaoyuboi/cloudflare-tunnel-skill /tmp/cloudflare-tunnel-skill
mkdir -p ~/.claude/skills/cloudflare-tunnel
cp /tmp/cloudflare-tunnel-skill/SKILL.md ~/.claude/skills/cloudflare-tunnel/
cp -R /tmp/cloudflare-tunnel-skill/scripts /tmp/cloudflare-tunnel-skill/references ~/.claude/skills/cloudflare-tunnel/
rm -rf /tmp/cloudflare-tunnel-skill

Claude Code 项目级安装（仅当前项目可用）：

git clone https://github.com/xiaoyuboi/cloudflare-tunnel-skill /tmp/cloudflare-tunnel-skill
mkdir -p .claude/skills/cloudflare-tunnel
cp /tmp/cloudflare-tunnel-skill/SKILL.md .claude/skills/cloudflare-tunnel/
cp -R /tmp/cloudflare-tunnel-skill/scripts /tmp/cloudflare-tunnel-skill/references .claude/skills/cloudflare-tunnel/
rm -rf /tmp/cloudflare-tunnel-skill

Codex 安装：

git clone https://github.com/xiaoyuboi/cloudflare-tunnel-skill /tmp/cloudflare-tunnel-skill
mkdir -p ~/.codex/skills/cloudflare-tunnel
cp /tmp/cloudflare-tunnel-skill/SKILL.md ~/.codex/skills/cloudflare-tunnel/
cp -R /tmp/cloudflare-tunnel-skill/scripts /tmp/cloudflare-tunnel-skill/references ~/.codex/skills/cloudflare-tunnel/
rm -rf /tmp/cloudflare-tunnel-skill

系统要求：需要预装 cloudflared（安装方法见 references/troubleshooting.md）和 Python 3。helper 脚本在 macOS / Linux 上经过完整测试；Windows 为尽力支持（进程管理走 tasklist/taskkill），建议 Windows 用户优先使用 WSL 或手动命令。

Quick Tunnel 临时链接

python3 scripts/tunnel_helper.py quick --url http://localhost:3000

查看状态：

python3 scripts/tunnel_helper.py status

停止：

python3 scripts/tunnel_helper.py stop

手动命令：

printf '' > /tmp/cloudflared-empty.yml
cloudflared --config /tmp/cloudflared-empty.yml tunnel --no-autoupdate --protocol http2 --url http://localhost:3000

Named Tunnel 固定域名

前提：

• 已安装 cloudflared
• 有 Cloudflare 账号
• 域名 DNS 已托管到 Cloudflare

基础流程：

cloudflared tunnel login
cloudflared tunnel create my-app
cloudflared tunnel route dns my-app app.example.com
python3 scripts/tunnel_helper.py named-config --name my-app --hostname app.example.com --url http://localhost:3000
cloudflared tunnel --config .cloudflare-tunnel/my-app.yml run my-app

本地测试

端到端 Quick Tunnel 测试：

python3 scripts/test_quick_tunnel.py