DIAGNOSTIC FIELD NOTES
PassWall连接失败、节点测速与服务启动异常故障排查指南
先找到最早失败的一层，再改动对应设置。记录发生时间、受影响设备和可复现请求，避免多个变量同时变化。
根据最早的异常选择入口
- 更新前就无法获取内容先看订阅获取与认证，比较路由器自身的网络与系统时间。
- 域名结果与预期不一致从DNS入口与上游检查，区分客户端与路由器。
- 本机可用，LAN不按预期转发从设备范围与透明代理链路检查，再看核心监听与路由。
测速与服务状态如何记录
PassWall节点测速应注明目标、协议与时间。TCP建连、HTTP访问和实际应用吞吐并非相同指标，不提供未经测量的实时成绩。遇到服务启动异常，核对插件版本、所用核心、系统日志、DNS进程和防火墙状态，记录最早出现的错误。
让每次排查都能复现。 保存原配置；选定一个设备和一个目标；每次只改一项；应用后新建连接验证；分享日志前移除订阅URL、令牌及账号信息。
SIX DIAGNOSTIC GUIDES
按问题选择你的指南。
全部教程正文与阅读链接均为独立静态页面。
01 / 项目边界技术手册
PassWall与PassWall2：相似名称背后的配置边界
先确认项目和版本，再核对配置来源、DNS及服务接管范围。
阅读完整指南
02 / 订阅更新技术手册
订阅更新失败：沿获取、解析与应用逐层检查
更新提示成功之后，继续检查远程内容、解析结果与当前使用节点。
阅读完整指南
03 / DNS解析技术手册
dnsmasq与Fake-IP：看清设备的真实解析路径
从设备到上游逐段核对，不把域名解析成功等同于代理连接成功。
阅读完整指南
04 / 透明代理技术手册
TPROXY与REDIRECT：透明代理的两条处理路径
规则存在只是起点，还需要核对监听、路由与实际请求命中情况。
阅读完整指南
05 / 访问控制技术手册
同一网络不同表现：LAN访问控制与规则顺序
地址、设备范围和默认策略，都会影响一条请求最终走向哪里。
阅读完整指南
06 / 服务状态技术手册
节点已切换，线路没变化？检查服务与新连接
界面选中、进程运行与新连接生效，是需要分别验证的三件事。
阅读完整指南