词元广场TOKPUB.COM - 欢迎您，支持一个 Key 调用近 600+ 海内外模型，限时特价模型低至 1 折，欢迎上岸！
"Pinggy Tunnel — 通过 Pinggy 实现零安装 SSH localhost 隧道"
Pinggy Tunnel
Skill 元数据
| 来源 | 可选 — 使用 hermes skills install official/devops/pinggy-tunnel 安装 |
| 路径 | optional-skills/devops/pinggy-tunnel |
| 版本 | 0.1.0 |
| 作者 | Teknium (teknium1), Hermes Agent |
| 许可证 | MIT |
| 平台 | linux, macos, windows |
| 标签 | Pinggy, Tunnel, Networking, SSH, Webhook, Localhost |
| 相关 skill | cloudflared-quick-tunnel, webhook-subscriptions |
参考：完整 SKILL.md
信息
Pinggy Tunnel Skill
a.pinggy.io:443，Pinggy 返回一个公共 HTTP/HTTPS URL。使用时机
cloudflared / ngrok 二进制文件，安装一个又显得多余cloudflared，优先使用 cloudflared-quick-tunnel skill——Cloudflare 快速隧道不会在 60 分钟后过期。前提条件
ssh（ssh -V）。Linux、macOS 和 Windows 10+ 默认自带。无需其他安装。127.0.0.1:<port> 上监听。Pinggy 会返回 URL，但在本地源服务启动之前访问会返回 502。PINGGY_TOKEN 环境变量，用于付费 Pro 功能（持久子域名、自定义域名、多隧道、无 60 分钟限制）。免费套餐无需凭据。快速参考
操作流程——启动隧道并获取 URL
terminal 工具。隧道在共享期间必须保持存活，因此以后台进程方式运行，并从 stdout 解析公共 URL。1. 确认本地源服务已启动
python3 -m http.server 8000 --bind 127.0.0.1）。Pinggy 会正常返回 URL，但在本地源服务启动之前用户会看到 502。2. 以后台进程方式启动隧道
terminal(background=True) 并将输出捕获到日志文件（Pinggy 在 stdout 打印 URL 后保持连接）：StrictHostKeyChecking=no + UserKnownHostsFile=/dev/null 跳过首次运行的主机密钥确认提示。ServerAliveInterval=30 防止 SSH 会话因空闲 NAT 而被断开。3. 从日志中解析 URL
You are not authenticated.
Your tunnel will expire in 60 minutes.
http://yqycl-98-162-69-48.a.free.pinggy.link
https://yqycl-98-162-69-48.a.free.pinggy.linkhttps://...pinggy.link URL 提供给用户。4. 验证
502 Bad Gateway，说明 SSH 会话已建立但本地源服务未在监听——先修复步骤 1。5. 关闭隧道
terminal(background=True) 的 session_id，优先使用 process(action='kill', session_id=...)。通过用户名关键字进行访问控制
+ 分隔堆叠到 SSH 用户名中。当 user@host 参数包含 + 时，始终用引号括起整个参数：| 关键字 | 效果 |
|---|---|
b:user:pass | HTTP Basic auth 认证门控 |
k:token | Bearer token 请求头门控（Authorization: Bearer <token>） |
w:CIDR | IP 白名单（单个 IP 或 CIDR，可重复使用） |
co | 添加 Access-Control-Allow-Origin: *（CORS） |
x:https | 强制 HTTPS——自动将 HTTP 重定向到 HTTPS |
a:Name:Value | 添加请求头 |
u:Name:Value | 更新请求头 |
r:Name | 删除请求头 |
qr | 将 URL 的二维码打印到 stdout（便于移动端分享） |
"b:admin:secret+co+x:https+free@a.pinggy.io"。Web 调试器（可选）
localhost:4300 以供检查。在 SSH 命令中添加本地转发：http://localhost:4300，查看实时请求/响应对。注意事项
PINGGY_TOKEN（Pro）或用 shell 循环自动重启（注意免费套餐每次重启 URL 都会变化）。+ 必须加引号。 裸命令 ssh ... b:admin:secret+free@a.pinggy.io 在 bash 中可以工作，但在将 + 视为特殊字符的 shell 中或以编程方式组装时会出错。始终用双引号括起。b:、k: 或 w:。process(action='log') 可能会遗漏 SSH banner 输出。 Pinggy 打印 URL 后 SSH 会话进入交互模式。始终重定向到日志文件并直接 grep 文件——与 cloudflared-quick-tunnel 相同的模式。-o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null。<subdomain>.a.pinggy.online:<port> 对，而非 https URL。 使用不同的正则表达式解析（tcp:// 加端口）。不要假设每个 Pinggy 隧道都是 HTTP。"$PINGGY_TOKEN+a.pinggy.io"（无 free@）。使用 token 还可以添加 :persistent 获得稳定子域名——参见 pinggy.io/docs/。示例配方
配方 1——接收 webhook 回调
$URL 提供给需要调用你的服务。关闭：kill $(cat /tmp/webhook-server.pid) $(cat /tmp/webhook-pinggy.pid)。配方 2——通过 HTTP/SSE 暴露 MCP 服务器
Authorization: Bearer $TOKEN 连接到 $URL。Hermes 原生 MCP 客户端配置：{"transport": "http", "url": "<URL>", "headers": {"Authorization": "Bearer <TOKEN>"}}。配方 3——暴露本地 LLM 端点（Ollama / vLLM / llama.cpp）
:11434，vLLM 和 llama.cpp 通常监听 :8000。co 启用 CORS，使浏览器调用方可以访问端点。纯后端调用方可去掉 co。对于兼容 OpenAI 的 vLLM/llama.cpp 端点，调用方使用基础 URL $URL/v1 加 Authorization: Bearer $TOKEN——但请注意 Pinggy 不会修改请求体中的任何内容，因此本地服务器实际上会看到 Pinggy 的 token；本地服务器应配置为忽略认证（它已在 127.0.0.1 上），让 Pinggy 负责门控。配方 4——用一次性密码共享开发服务器
b:dev:$PASS 使用 HTTP Basic auth 对 URL 进行门控。x:https 强制 TLS。co 为 SPA 前端添加 CORS。验证
pinggy.link URL 以及 curl 返回的 HTTP/2 200。