关于 hostc-public-preview
这项技能指导使用 `hostc` 命令行,为本地开发服务创建临时公网 URL,并说明预览设置、自托管服务器配置及隧道运行期间的安全注意事项。
主要功能
- 01为本地端口创建公网 URL
- 02配置自托管 hostc 服务
- 03按需保持预览运行
- 04排查端口和协议问题
- 05公开服务的安全指引
适用场景
- 01分享本地应用预览
- 02开发期间接收 Webhook 回调
- 03在移动设备上测试本地应用
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ akazwz/ hostc --skill hostc-public-preview安装后在 Claude Code 中输入/hostc-public-preview确认已加载。
详细介绍
Hostc Public Preview
当用户或任务需要为本地开发服务器提供临时公网 URL 时,使用 hostc。
快速开始
如果本地应用正在 3000 端口运行:
npx hostc@latest 3000
使用输出的公网 URL 进行预览、接收 webhook 回调、在移动设备上测试,或与他人分享本地应用。
自托管服务
如果用户有自己的 hostc 服务:
HOSTC_SERVER_URL=https://hostc.example.com npx hostc@latest 3000
如需持久化配置:
npx hostc@latest config set server-url https://hostc.example.com
npx hostc@latest 3000
Agent 工作流
- 从开发服务器输出中确认或推断本地端口。
- 优先使用
npx hostc@latest <port>,确保 CLI 与当前协议兼容。 - 等待 hostc 输出公网 URL。
- 将公网 URL 提供给用户,并在需要预览期间保持命令运行。
- 如果隧道失败,先检查本地服务器是否可通过指定端口访问。
- 要停止预览,请终止正在运行的 hostc 进程。在交互式终端中通常按 Ctrl+C 即可。如果 Agent 将 hostc 作为后台进程启动,请停止或终止该进程。
安全提示
- 除非用户明确提出要求并了解风险,否则不要暴露敏感的管理面板、数据库控制台、凭据仪表板或内部私有服务。
- 将公网 URL 视为临时地址。不要将其用作永久生产端点。
- 如果 hostc 报告协议不匹配,请让用户运行
npx hostc@latest <port>,或升级已安装的 CLI。 - 如果本地服务不可用,请先修复本地服务器;hostc 无法代理未提供流量的端口。
评论
支持 Markdown