Agent Skills
返回列表
本地服务公网隧道

本地服务公网隧道

IT 运维与安全 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_f1b049da/tnqd2026065 到本 AI 助手。

技能介绍

要解决什么

日常开发里很多服务只在本机跑着:刚搭好的 CRM Demo 想给手机或外网同事看看效果,本地 Webhook 接收器需要临时接收第三方平台的回调,或者想和 listhen 之类的本地服务联用做外网预览。这些问题的共同点是:服务在 localhost 上,但观察者不在。把代码推到远端重新部署当然可行,但对临时验证来说代价太高。

这个技能的目标很专注:不做正式部署的前提下,把本机已监听的 HTTP 端口变成一条临时公网隧道,拿到 URL 就能分享。思路来自轻量库 untun(Tunnel local HTTP via Cloudflare Quick Tunnels),核心链路是 本地端口 → startTunnel → 公网 URL。

核心能力与工作步骤

核心能力有三点:

  • 把任意本机 HTTP 端口暴露成临时公网地址,同事直接打开就能看到页面
  • 适配 Webhook 联调:第三方回调可以临时打到你的本机
  • 可与 listhen 等本地服务组合,做外网预览

推荐实现分两步:

  1. 先确认本机 HTTP 服务已正常监听某个端口,再启动隧道——顺序不能反
  2. 安装 untun(npm i untun),对该端口调用 startTunnel;也可以用 CLI 快速验证:npx untun@latest tunnel http://localhost:3000

收尾动作是自测闭环:

拿到公网 URL 后自己先打开一遍,确认能加载本地页面;退出时记得关闭隧道。

适用边界与注意点

这个技能明确不做三件事:

  • 不把临时隧道当生产入口长期暴露——Demo 和联调结束后必须关闭
  • 不在本地服务没启动时假装开隧道成功——硬约束要求先确认监听,再开隧道
  • 不提供 Cloudflare 账号级 Named Tunnel 或自定义域名的完整配置教程——那是生产场景,需要独立的正式方案

定位一句话:它是本地到公网的临时快车道,不是生产环境的正门。

使用场景

  • 临时演示:希望把本机跑着的 CRM Demo 发给手机/外网同事,对方直接打开公网 URL 就能预览页面。
  • Webhook 联调:第三方平台需要回调本机,用隧道把本地接收器临时暴露出去验证回调链路。
  • 与 listhen 组合:本机端口已有服务时需要外网视角预览,借助隧道拿到公网地址再和 listhen 联用。
  • 快速验证:已在本机监听 HTTP 端口,不想重新部署代码,直接用隧道和公网 URL 完成功能自查。

适合人员

  • 独立开发者:需要把本机跑着的 demo 临时发给别人预览,却又不想为此单独部署。
  • 前端工程师:用本机服务对接第三方平台 webhook,必须先打通临时回调地址这个环节。
  • 联调测试工程师:验证客户端与后端在局域网/公网链路下能否正常通信的连接问题。
  • 后端工程师:对外展示原型或新功能时,需要一个临时公网 URL 把内网服务转出来。