适用场景
用访问地址打不开、页面报错、客户端一直重连或显示失败。新版、旧版客户端都适用。
前置条件
- 准备好：出问题的隧道名称、访问地址、出问题的时间。
- 如果浏览器显示了网云穿的错误页，记下页面上的错误代码和请求编号，联系客服时要用。
操作步骤
第 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 等响应。
测试失败时检查：服务是否启动；端口是否写对；客户端和服务不在同一台电脑时，内网地址不能填 127.0.0.1；服务器防火墙是否放行了这个端口。
第 4 步：检查域名和访问限制
- 访问地址以控制台“隧道”页显示的为准，不要用节点 IP 代替网站域名。
- 新分配的域名显示“配置中”时，等几分钟再试。
- 自己的域名打不开，按 自定义域名与 HTTPS 检查解析和证书。
- 配置过白名单的，确认你当前网络的公网 IP 在白名单里，见 黑白名单。
成功检查
修好后从外网（手机流量）再访问一次，页面能打开、能登录、能正常操作才算解决。
常见错误
- 只重启客户端或重装：解决不了内网地址填错、套餐到期、域名未生效这些问题，先按第 1 步找原因。
- 在公司 Wi-Fi 下测试外网访问：结果不准，用手机流量测。
- 提交表单、付款时出错就反复点：先到业务系统确认是否已经处理，避免重复提交。
- 把令牌、注册密钥、证书私钥发给别人：联系客服只需提供错误代码、请求编号、时间和截图（遮住令牌）。