跳到主要内容

访问不了怎么办:按错误页一步步排查

外网打不开、客户端连不上时,先看错误页上的提示,再按对应的一行处理,不用反复重装。

适用场景

用访问地址打不开、页面报错、客户端一直重连或显示失败。新版、旧版客户端都适用。

前置条件

  • 准备好:出问题的隧道名称、访问地址、出问题的时间。
  • 如果浏览器显示了网云穿的错误页,记下页面上的错误代码和请求编号,联系客服时要用。

先做一分钟检查,避免越改越乱

  1. 记下“什么时候开始坏了”和“最后做过什么修改”,例如换电脑、换令牌、续费、改域名或重启路由器。
  2. 从控制台重新复制当前访问地址,不用聊天记录里的旧地址。
  3. 检查付款账号、套餐到期时间、隧道是否已启用;再看运行这条隧道的设备和客户端。
  4. 用手机流量再试一次,并保存完整报错。只有 TCP 服务时,用对应软件测,不用网页代替。
  5. 每次只修改一项,测完再继续。暂时不要重装、删隧道、换令牌或换域名,这些操作会引入新的变量。

本篇不会要求你发送账号密码、令牌或证书私钥。遇到怀疑泄露的情况,请走对应凭据更换流程,并重新更新实际使用该凭据的客户端。

先确定是哪一类问题

现象 从哪里开始
浏览器显示网云穿错误页 第 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 下测试外网访问:结果不准,用手机流量测。
  • 提交表单、付款时出错就反复点:先到业务系统确认是否已经处理,避免重复提交。
  • 把令牌、注册密钥、证书私钥发给别人:联系客服只需提供错误代码、请求编号、时间和截图(遮住令牌)。

相关教程

日志、升级与卸载 · 设备管理 · 协议怎么选 · 自定义域名 · 黑白名单