KNOWLEDGE BASE // TROUBLESHOOTING DIRECTORY
一云梯连接排查与网络问题指南目录
收录一云梯官方针对不同故障域的深度技术排查手册。每一篇均包含分支判断树、客观对照表与清晰的解决路径。
凭据与链路
GUIDE #01
客户端无法拉取节点配置：从HTTP状态码到本地网络栈的排查
【解决的核心问题】
解决客户端提示订阅拉取失败、HTTP 401/403 鉴权异常、SSL 证书握手超时及节点列表为空的问题。
针对节点配置拉取失败现象，依据 HTTP 状态码、TLS 握手校验、本地回环代理死锁及 DNS 污染进行层级排查，提供明确的操作步骤与判定依据。
典型症状：点击“更新订阅”无反应或弹出报错红字
阅读完整排障手册 →
节点与路由
GUIDE #02
单一节点超时与整组线路瘫痪：如何用控制变量法锁定故障边界
【解决的核心问题】
解决单节点维护与全节点断网的混淆误判，避免因个别机房常规割接而盲目修改全局配置或重装系统。
系统对比单节点边缘维护与全节点超时断网的本质区别。通过控制变量法分步验证物理网络、内核监听、本地端口与安全软件，杜绝误判与无效重装。
典型症状：列表内特定线路超时，或全列表全部变红
阅读完整排障手册 →
应用与协议
GUIDE #03
网页浏览正常而独立软件断网：系统代理与TUN虚拟网卡的作用域解析
【解决的核心问题】
解决仅 Chrome/Edge 浏览器能打开网页，而桌面应用（Telegram/Discord/Steam）与终端命令断网的协议作用域问题。
深入剖析浏览器能访问而独立软件断连的底层机制。详解操作系统代理层级、应用层自主配置、TUN 虚拟网卡驱动及终端命令行的作用域差异与解决方案。
典型症状：网页能看但桌面聊天软件、游戏或命令行报错
阅读完整排障手册 →
局域网与网络
GUIDE #04
受限Wi-Fi网络下的接入屏障：端口白名单、DNS污染与热点对照验证
【解决的核心问题】
解决同一设备在家庭宽带正常，但切换到公司局域网、校园网或酒店 Wi-Fi 时立即失联的局域网端口限制与 DNS 劫持问题。
针对公司、酒店及校园网等特定 Wi-Fi 下出现断连的现象，提供严谨的跨网络控制变量验证方案。剖析局域网端口白名单过滤、内网 DNS 劫持与 DoH 加密应对策略。
典型症状：手机热点完全正常，但特定 Wi-Fi 无法连通
阅读完整排障手册 →
客户端与版本
GUIDE #05
客户端版本迭代后的配置崩溃：破坏性变更核对与无损回滚流程
【解决的核心问题】
解决客户端软件升级后配置语法不兼容、虚拟网卡驱动冲突或程序闪退问题，指导安全留存关键证据与安全回滚。
软件升级后出现配置解析失败、程序闪退或网络断连？指导用户严守三项破坏性红线，完整收集关键报错日志，比对发布说明中的破坏性变更并实现无损安全回滚。
典型症状：点击升级新版软件后原本正常的连接突然崩溃
阅读完整排障手册 →
工单与诊断
GUIDE #06
网络故障日志的结构化整理：脱敏规范与高效技术工单撰写
【解决的核心问题】
解决用户向一云梯官方客服反馈时描述模糊、来回反复沟通耗时的问题，提供开箱即用的标准化脱敏工单模板。
解决用户向技术支持反馈时描述模糊、沟通低效的痛点。提供标准化故障工单五大要素架构、隐私凭据脱敏规范及开箱即用的 Markdown 报告模板。
典型症状：排查未果准备联系客服，但不知如何整理日志
阅读完整排障手册 →