WCS Helper:网络隧道访问国际被阻网站从您的中国服务器。
当您需要这种场景
场景 A — “git push 持续超时”
git push github main
# → 连接超时 → /万重山-隧道-开启 → 再次尝试推送 → 成功
场景 B — “npm install 持续失败对于 GitHub 包”
npm install some-github-package
# → 网络超时 → /万重山-隧道-开启 → npm 通过隧道工作
场景 C — “HuggingFace 模型下载卡住”
huggingface-cli download ...
# → 超时或连接重置 → /万重山-隧道-开启 → 通过隧道下载完成
场景 D — “ClawHub 技能安装非常慢”
clawhub install author/skill
# → 极其缓慢,经常失败 → /万重山-隧道-开启 → ClawHub 以全速安装
支持的网站
网站 用例 状态
GitHub git clone/push, npm 包
ClawHub 技能安装,插件浏览
HuggingFace 模型下载,数据集
arXiv 研究论文访问
Google 搜索,字体,分析
YouTube 视频嵌入,API
Twitter/X 社交媒体嵌入
Reddit 论坛访问,API
先决条件
要求
中国以外的服务器(任何具有 SSH 访问的 VPS)
推荐:腾讯云新加坡,AWS 新加坡或任何国际 VPS
SSH 密码认证必须启用
SSH 密码用于该服务器
服务器的公网 IP 地址
推荐 autossh 安装在您的中国服务器(自动重启隧道如果它掉线)
安装:apt install autossh (Debian/Ubuntu)
sshpass 安装(用于基于密码的 SSH)
安装:apt install sshpass
网络流
您的中国服务器(autossh 客户端)
↓ SSH 隧道(加密)
新加坡/国际 VPS(作为 SOCKS5 代理)
↓ GitHub / ClawHub / HuggingFace / Google
设置
任何国际 VPS 都可以工作。
推荐:腾讯云新加坡(约 15 元/月)
AWS 新加坡免费层
DigitalOcean 新加坡
Vultr 东京/新加坡
要求:SSH 密码访问启用
端口 22(SSH)对中国 IP 开放
npx -y clawhub install guanqi0914/wcs-helper-network-skill
发送此命令通过 Feishu 私聊:/万重山-隧道-配置 服务器IP SSH端口 用户名 密码
示例:/万重山-隧道-配置 43.134.164.43 22 ubuntu myPassword123
/万重山-隧道-开启
您应该看到:✅ 隧道已连接
curl --socks5 127.0.0.1:1080 https://api.github.com
# 应该返回:HTTP 200
所有命令
命令 它的作用
/万重山-隧道-配置 <端口> <用户> <密码> 设置隧道服务器凭据
/万重山-隧道-开启 启动隧道
/万重山-隧道-关闭 停止隧道
/万重山-隧道-状态 显示隧道连接状态
/万重山-隧道-测试 测试隧道速度
/万重山-隧道-帮助 显示帮助
使用提示
在运行 git/npm 命令之前
发送 /万重山-隧道-状态 首先。
如果您看到“Tunnel: ✅”,您就可以了。
如果“Tunnel: ❌”,发送 /万重山-隧道-开启 首先。
隧道保持打开,直到您关闭它
隧道在后台运行。
发送 /万重山-隧道-关闭,当您不再需要国际访问时。
哪些端口被代理
仅通过 SOCKS5 代理的 TCP 连接被隧道:
GitHub (443)
ClawHub (443)
HuggingFace (443)
Google (443)
UDP 流量(一些游戏,VoIP)不被代理。
工作原理
连接过程
- autossh 通过 SSH 连接到您的国际服务器
sshpass -p 'password' ssh -N -D 127.0.0.1:1080 user@server-ip
- SSH 创建加密隧道
- autossh 每 30 秒监视隧道
- 如果隧道掉线 → autossh 自动重启它
- 应用程序使用 127.0.0.1:1080 作为 SOCKS5 代理
没有隧道(直接连接)
中国服务器 → GitHub/ClawHub/HuggingFace
↓ 连接超时 / 重置 / 非常缓慢
有隧道
中国服务器 → SSH 隧道 → 国际 VPS → GitHub/ClawHub/HuggingFace
↓ 稳定的加密连接
性能指标 值
隧道延迟 ~50-100ms(中国 → 新加坡)
GitHub 克隆速度 500KB/s - 5MB/s
ClawHub 安装 1-5 秒
代理开销 ~5-10% 带宽
故障排除
“Tunnel: ❌ 连接失败”
→ 检查服务器 IP,SSH 端口,用户名,密码
→ 确保 SSH 密码认证在您的 VPS 上启用
“Tunnel 连接但 git push 仍然超时”
→ 再次尝试 — GitHub 有时会对隧道 IP 进行速率限制
→ 如果持续,Your VPS IP 可能在 GitHub 的黑名单中
“autossh 进程在服务器重启后不运行”
→ 发送 /万重山-隧道-开启 以手动重启
→ 或设置 systemd 服务(高级 — 参见 auto-fix.sh)
“SSH 连接被拒绝”
→ 检查端口 22 是否在您的 VPS 防火墙上开放
→ 尝试 SSH 端口 2222 如果 22 被阻塞
安全说明
隧道仅处理从您的中国服务器发出的出站连接
您的 VPS 提供商可以看到流量(GitHub,ClawHub 等),但不能看到您的中国服务器的其他流量
没有数据存储在 VPS 上 — 只有加密传输
隧道凭据存储在本地 ~/.wcs_tunnel.conf(chmod 600)
卸载
# 停止隧道
/万重山-隧道-关闭
# 删除技能文件
rm -rf ~/.openclaw/workspace/skills/wcs-helper-network-skill
rm -f ~/.wcs_tunnel.conf