适用场景
用访问地址打不开、页面报错、客户端一直重连或显示失败。新版、旧版客户端都适用。
前置条件
- 准备好:出问题的隧道名称、访问地址、出问题的时间。
- 如果浏览器显示了网云穿的错误页,记下页面上的错误代码和请求编号,联系客服时要用。
先做一分钟检查,避免越改越乱
- 记下“什么时候开始坏了”和“最后做过什么修改”,例如换电脑、换令牌、续费、改域名或重启路由器。
- 从控制台重新复制当前访问地址,不用聊天记录里的旧地址。
- 检查付款账号、套餐到期时间、隧道是否已启用;再看运行这条隧道的设备和客户端。
- 用手机流量再试一次,并保存完整报错。只有 TCP 服务时,用对应软件测,不用网页代替。
- 每次只修改一项,测完再继续。暂时不要重装、删隧道、换令牌或换域名,这些操作会引入新的变量。
本篇不会要求你发送账号密码、令牌或证书私钥。遇到怀疑泄露的情况,请走对应凭据更换流程,并重新更新实际使用该凭据的客户端。
先确定是哪一类问题
| 现象 | 从哪里开始 |
|---|---|
| 浏览器显示网云穿错误页 | 第 1 步,对照标题、错误代码和请求编号 |
| 提示找不到服务器、DNS 错误 | 第 4 步,检查访问地址和域名解析 |
| 提示证书错误 | 检查设备时间、域名和证书有效期,不要跳过证书校验 |
| 页面已打开,某个按钮或登录失败 | 对照 发布网站 的业务功能检查 |
| 远程桌面、SSH、数据库连接失败 | 第 2、3 步,再看 TCP 教程 |
| 只有官网登录或付款失败 | 看 登录教程 或 支付教程,不要重装内网客户端 |
操作步骤
第 1 步:看错误页上的提示
网云穿的错误页会写明“访客 → 网云穿节点 → 隧道客户端 → 内网服务”哪一环出了问题。找到页面标题,按下表处理:
| 页面提示(错误代码) | 问题在哪 | 怎么办 |
|---|---|---|
| 隧道客户端未连接(TUNNEL_OFFLINE,503) | 客户端没运行 | 打开内网电脑上的客户端,启动这条隧道 |
| 无法连接内网服务(UPSTREAM_FAILED,502) | 客户端连不上内网服务 | 内网地址/端口填错,或服务没启动。做第 3 步 |
| 内网服务响应超时(UPSTREAM_TIMEOUT,504) | 内网服务太慢或卡住 | 在内网打开服务看是否很慢,检查服务器负载 |
| 隧道连接超时(BRIDGE_TIMEOUT,504) | 客户端所在电脑网络不稳定 | 检查那台电脑的网络,看客户端日志是否在频繁重连 |
| 访问地址不可用(ADDRESS_UNAVAILABLE,404) | 地址输错,或域名/隧道已失效 | 从控制台“隧道”页重新复制访问地址;看套餐是否到期 |
| 该隧道不支持网页访问(TCP_WEB_NOT_ALLOWED,403) | 用浏览器访问了 TCP 隧道 | 网站要用 HTTP/HTTPS 协议,到“配置”里修改协议 |
| 访问域名不匹配(MISDIRECTED_REQUEST,421) | 请求的域名和证书域名不一致 | 直接用控制台给出的完整访问地址,不要经过别的代理改域名 |
| 访问请求格式无效(INVALID_REQUEST,400) | 请求不是标准网页请求 | 用浏览器或正确的软件访问 |
| 服务暂时不可用(SERVICE_UNAVAILABLE,503) | 平台临时问题 | 稍等再试;持续出现把请求编号发给客服 |
如果能确认是业务系统自己返回的 404/500 页面,优先检查业务系统;只看到状态码不足以判断来源,请结合页面标题和对应请求日志确认。
第 2 步:看客户端是否已连接
- Windows 图形客户端:看这条隧道的状态,打开日志查看失败原因。
- 命令行临时运行(run):看终端里有没有“隧道已连接”。
- Docker:执行
sudo docker logs --tail 100 容器名。 - 常驻服务版:执行下面的命令(
123换成list里看到的隧道 ID;Windows 用.\wyc-client.exe,Linux/macOS 前面加sudo):
wyc-client list
wyc-client logs 123 --lines 100
日志里常见的提示:
| 日志提示 | 怎么办 |
|---|---|
| 隧道令牌无效或已更换 | 在控制台“隧道 → 连接凭证”复制最新令牌,重新添加 |
| 隧道已到期 | 续费后重新启动这条隧道 |
| 这条隧道已在另一个连接中运行 | 同一条隧道在别的电脑上开着,先关掉那边 |
| 连接被拒绝 / 连接超时 | 内网服务连不上,做第 3 步 |
| 当前隧道要求的能力与客户端不匹配 | 从 下载页 安装最新版客户端 |
第 3 步:在客户端那台电脑上测试内网服务
一定要在运行客户端的那台电脑上测,地址和端口换成隧道里填的:
- Windows(PowerShell):
Test-NetConnection 192.168.1.20 -Port 8080
成功后会看到 TcpTestSucceeded : True。
- Linux / NAS:
curl -I http://192.168.1.20:8080
成功后会看到 HTTP/1.1 200、302 等响应。curl -I 使用 HEAD 请求,业务不支持时可能返回 405,可改用浏览器验证。
测试失败时检查:服务是否启动;端口是否写对;客户端和服务不在同一台电脑时,内网地址不能填 127.0.0.1;服务器防火墙是否放行了这个端口。
第 4 步:检查域名和访问限制
- 访问地址以控制台“隧道”页显示的为准,不要用节点 IP 代替网站域名。
- 新分配的域名显示“配置中”时,等几分钟再试。
- 自己的域名打不开,按 自定义域名与 HTTPS 检查解析和证书。
- 配置过白名单的,确认你当前网络的公网 IP 在白名单里,见 黑白名单。
旧版 Windows 没有 Test-NetConnection 怎么办
如果提示“无法将 Test-NetConnection 识别为命令”,先确认打开的是 PowerShell。较旧的系统可能没有这个命令,不需要为了测试去关闭安全功能或随意安装来历不明的工具。
- 网站服务:在 运行客户端的电脑 上用浏览器打开隧道填写的内网地址和端口,例如
http://192.168.1.20:8080。 - 远程桌面或 SSH:在该电脑上用相应软件直接连目标内网 IP 和端口。
- 已安装新版服务客户端:按对应系统教程运行
doctor 隧道ID,同时查看隧道日志。
端口测试通过,表示能建立对应连接;业务是否能登录、查询、上传,还要实际操作。ping 通也不能代替端口测试,部分设备不响应 ping 但服务仍可使用。
看懂内网测试的结果
| 结果 | 说明与下一步 |
|---|---|
TcpTestSucceeded : True |
TCP 端口可以连接,继续测试业务和外网 |
TcpTestSucceeded : False |
检查 IP、端口、业务进程、监听地址和防火墙 |
Connection refused |
目标拒绝连接,优先检查服务是否启动、端口是否写错 |
Connection timed out |
目标没有及时回应,检查网络路由、防火墙和设备状态 |
HTTP 200、301、302、401、403 等 |
收到了 HTTP 响应;登录页、权限和跳转分别按业务检查 |
HTTP 405,且测试用的是 curl -I |
有些业务不接受 HEAD 请求,改用浏览器实际打开,不要立即认定服务坏了 |
如果内网也慢,先处理业务服务器;如果内网快、外网慢,记录同一个页面或文件的大小、两边耗时、测试网络和客户端日志,再分析带宽和链路。
可以直接复制给客服的问题描述
下面是填写模板,不是要执行的命令:
故障发生时间(北京时间):
隧道名称或 ID:
使用场景(网页/远程桌面/SSH/其他):
客户端系统、版本、图形版或服务版:
外网访问地址与报错标题:
错误代码、请求编号(没有就写没有):
客户端状态与最近错误(遮住令牌):
在客户端电脑上测试内网服务的结果:
手机流量测试结果:
出问题前做过的改动:
已尝试的检查和结果:
通过 服务支持 发送。保留地址和端口供定位,遮住网页里的个人信息、业务数据、令牌、注册码、二维码和密码。不需要发整个客户端数据目录。
成功检查
修好后从外网(手机流量)再访问一次,页面能打开、能登录、能正常操作才算解决。
常见错误
- 只重启客户端或重装:解决不了内网地址填错、套餐到期、域名未生效这些问题,先按第 1 步找原因。
- 在公司 Wi-Fi 下测试外网访问:结果不准,用手机流量测。
- 提交表单、付款时出错就反复点:先到业务系统确认是否已经处理,避免重复提交。
- 把令牌、注册密钥、证书私钥发给别人:联系客服只需提供错误代码、请求编号、时间和截图(遮住令牌)。