PassWall2 节点不显示怎么办？按订阅、过滤和内核排查

更新于 2026-10-30 · passwall.lol

简答：PassWall2 节点不显示时，先不要重装插件：进入“服务 → PassWall 2 → 节点订阅”，确认保存的是完整订阅 URL，手动更新后查看日志；如果更新成功但仍为空，再依次检查过滤关键词、节点格式、Xray/sing-box 内核和页面刷新。本文适用于已安装 PassWall2 的 OpenWrt 路由器，不覆盖具体订阅服务的有效期、套餐状态或未核实的兼容性。

定义：PassWall2“节点不显示”通常是订阅没有被成功解析、节点被过滤、协议缺少对应内核，或节点已写入但当前界面没有正确刷新。

先判断是哪一种“节点不显示”

PassWall2 的表现不同，处理顺序也不同。官方项目的 LuCI 菜单代码将“基本设置”“节点列表”和“节点订阅”分开，因此不要只盯着首页开关；先进入“服务 → PassWall 2 → 节点订阅”，再到“节点列表”确认结果。不同固件、语言包和版本的菜单名称可能略有差异，以下以当前页面实际显示为准。相关菜单结构可在 PassWall2 官方控制器代码中核对。

建议先截图或备份当前配置。后续每次只改一个项目，并在“保存并应用”后验证，这样更容易知道是哪一步恢复了节点。

最短修复路径：重新保存订阅并手动更新

1. 核对入口。进入“服务 → PassWall 2 → 节点订阅”，确认填写的是完整的订阅 URL，而不是登录页、邀请页、付款页、说明页或单个网页地址。不要在公开日志、截图或问题反馈中直接粘贴包含身份信息的订阅链接。
2. 重新复制并保存。从订阅提供方的用户页面重新复制地址，替换旧地址后点击“保存并应用”。如果页面有“手动更新”“更新订阅”或相近按钮，先执行一次手动更新，不要同时修改 DNS、TUN 或分流规则。
3. 查看节点列表。进入“节点列表”，观察是否出现新的节点名称。如果列表仍为空，回到订阅页记录更新提示的原文，尤其是 404、超时、解析失败、无法识别格式、成功解析 0 个节点等信息。
4. 刷新界面。保存并应用后刷新 LuCI 页面；如果浏览器仍显示旧内容，可以退出后重新登录路由器管理页面。刷新只用于排除界面显示问题，不能替代订阅解析和内核检查。

如果你需要在路由器 SSH 中确认订阅地址是否能访问，可以使用已打码的占位地址进行测试，不要把真实地址写入分享内容：

curl -I -L --max-time 15 "https://订阅域名/已打码路径"

curl -L --max-time 15 "https://订阅域名/已打码路径" | head

-I用于先查看响应头，-L允许跟随重定向，--max-time限制单次请求时间。参数含义可参考 curl 官方手册与 curl 官方教程。这一步只能说明路由器是否拿到响应，不能证明返回内容一定是 PassWall2 可解析的节点订阅。

按返回内容区分：链接能打开，不等于订阅可解析

用浏览器或 SSH 查看订阅返回内容时，重点不是页面是否“能打开”，而是响应内容是否符合当前 PassWall2 解析器支持的形式。可按下面方式判断：

• 返回登录页或 HTML 页面：通常说明复制的是网页地址、登录失效，或请求被重定向到认证页面。重新从订阅页面复制专用订阅地址。
• 返回 404、403、401 或其他错误：先记录状态码，再核对地址是否完整、订阅是否需要登录、路由器时间是否明显错误，以及路由器是否能解析订阅域名。
• 返回空内容：可能是服务端没有返回订阅数据，也可能是请求被中间设备截断。此时不要把空内容直接粘贴到配置中，应先向订阅提供方核实。
• 返回 Base64、Clash YAML 或其他配置文本：能否解析取决于当前 PassWall2 版本、订阅转换方式和节点协议。不要仅凭文件扩展名或浏览器显示内容判断一定兼容。
• 返回内容有节点，但列表仍为空：优先检查过滤模式、协议解析和日志，而不是继续重复更新。

PassWall2 官方配置页面提供了“过滤关键词模式”，包括关闭、丢弃列表、保留列表以及组合模式；对应字段包括 filter_keyword_mode、filter_discard_list 和 filter_keep_list，可在 官方节点订阅配置代码中核对。

节点被过滤：检查丢弃列表和保留列表

如果订阅更新提示成功，但节点数量少于预期，先把过滤条件临时收窄，而不是立即重装。进入“节点订阅”对应的全局设置或具体订阅项，检查“过滤关键词模式”：

1. 先将过滤关键词模式临时设为“关闭”，或者使用当前页面显示的等价选项。
2. 清空测试用的“丢弃列表”和“保留列表”关键词，点击“保存并应用”。
3. 重新执行一次订阅更新，再进入“节点列表”观察数量。
4. 如果节点重新出现，再逐个恢复关键词，找出导致隐藏的词。

常见误判是把节点名称中的地区、日期、流量提示、群组名称或线路标签当成普通文字。只要关键词命中，节点就可能被排除；组合模式下还要注意“保留列表”和“丢弃列表”的优先关系，具体以当前版本页面说明和实际结果为准。确认问题后，建议使用更精确的关键词，并保留一份修改前的配置。

如果关闭过滤后仍然是零节点，问题更可能位于订阅返回格式、协议支持或解析日志，而不是名称筛选。

检查协议与 Xray、sing-box 内核

节点显示和节点可用是两个阶段。订阅可能已经返回内容，但其中的节点协议或字段无法被当前解析器识别，结果可能表现为跳过节点、解析数量为零，或者节点出现后启动失败。官方仓库的发行页会列出特定版本随包提供的组件和版本，例如 Xray、sing-box 等；当前安装版本应以你的固件和 PassWall2 页面为准，可在 PassWall2 官方发行页核对。

1. 进入 PassWall2 的“组件管理”“基本设置”或当前版本对应的内核设置页面，确认 Xray 或 sing-box 是否已安装并能显示版本。
2. 根据节点协议选择对应核心；如果页面提供“节点类型”“核心”或相近字段，按当前页面可选项设置，不要照抄其他版本截图中的字段。
3. 保存并应用后重新更新订阅，再查看“节点列表”和日志。
4. 如果只缺少某一类节点，尝试用一个已知格式的单节点链接做对照。单节点能导入而整份订阅为空，通常应继续查订阅格式或批量解析；单节点也不能导入，则优先查核心、字段和插件版本。

不要因为安装了一个核心，就推断它能解析所有协议。PassWall2 的支持范围会随版本、组件和节点格式变化；无法从当前页面或官方说明确认的协议，应标记为“未核实”，不要继续改动全局配置。

查看日志：用错误关键词决定下一步

在 PassWall2 页面打开日志或通过 SSH 查看 OpenWrt 系统日志，重点记录更新动作前后的几行，而不是只看最后一行。OpenWrt 官方文档说明，logread可读取系统日志，并可用筛选参数定位包含特定文本的记录，见 OpenWrt 官方日志说明。

SSH 中可先执行：

logread -e passwall

logread -e subscribe

logread -f

• 出现 timeout、resolve、could not resolve：先检查路由器 DNS、订阅域名解析和基础网络，不要先改节点分流。
• 出现 401、403、404：核对订阅地址、登录状态、路径和服务端返回，不要把错误页当成节点数据。
• 出现 parse、unsupported、skip 或解析数量为 0：检查订阅格式、协议类型、PassWall2 版本和对应核心。
• 出现 filter、discard、keep：回到过滤关键词模式，暂时关闭丢弃和保留规则进行对照。
• 出现 core not found、binary missing 或启动失败：检查 Xray/sing-box 文件是否存在、权限是否正常，以及固件架构是否匹配。

日志中可能包含完整订阅地址、节点地址、用户名或令牌。分享日志前必须打码；如果无法确认哪些字段敏感，宁可只提供错误关键词、时间点和软件版本。

更新后节点仍不见：保存、引用和回滚

订阅更新可能会新增、删除或重建节点。官方项目的公开问题记录中，曾出现订阅刷新后原先保存的节点引用失效、全局选择回到无代理模式的案例；这属于项目问题记录中的特定现象，不代表每次更新都会发生，可在 PassWall2 官方问题记录中核对。

1. 更新前记录当前正在使用的节点名称和所属订阅。
2. 更新后进入“节点列表”，重新选择实际存在的节点。
3. 回到“基本设置”，确认全局节点或默认节点不是空值。
4. 点击“保存并应用”，再观察服务状态和日志。
5. 如果更新后节点数量突然变为零，先停用自动更新或恢复备份，再单独测试订阅地址，不要同时重置 DNS、分流和 TUN。

如果列表中有节点但服务仍无法启动，说明问题已经从“节点不显示”进入“节点运行失败”阶段，应转到日志、内核和端口排查，而不是继续修改订阅过滤。

一张可照做的排查清单

• 第一步：确认系统是 OpenWrt，确认 PassWall2 已安装并能打开节点订阅页面。
• 第二步：重新复制完整订阅 URL，保存并应用。
• 第三步：手动更新，记录提示原文和节点数量。
• 第四步：暂时关闭过滤关键词模式，清空丢弃列表和保留列表。
• 第五步：用浏览器或 curl查看状态码、重定向和返回内容类型。
• 第六步：检查 Xray/sing-box 内核是否安装、版本是否能在当前页面识别。
• 第七步：查看 PassWall2 日志和 logread，按 timeout、401、404、parse、unsupported、filter、core not found 分流。
• 第八步：更新后重新选择节点，保存并应用；必要时恢复更新前备份。

完成以上步骤仍为空时，最有价值的反馈信息是：OpenWrt 版本、PassWall2 版本、订阅更新提示原文、返回状态码、解析节点数量、使用的核心类型，以及已打码的相关日志。不要公开完整订阅链接。

常见问题

PassWall2 订阅更新成功，为什么节点列表还是空的？

先进入节点订阅设置，暂时关闭过滤关键词模式并清空丢弃列表、保留列表，然后重新更新。若仍为空，再检查返回内容是否为 HTML、错误页或无法识别的格式，并查看 PassWall2 日志中的解析数量和协议错误。

PassWall2 节点不显示，是不是订阅一定失效了？

不一定。订阅失效只是可能原因之一，也可能是复制了登录页或邀请链接、路由器无法访问订阅域名、节点被过滤、当前版本无法解析该格式，或对应 Xray/sing-box 内核缺失。应先看 HTTP 状态、返回内容和日志。

关闭过滤关键词后仍然没有节点怎么办？

用已打码的订阅地址检查 HTTP 响应和返回内容，再确认 PassWall2 版本、节点协议与内核是否匹配。可以尝试导入一个单节点链接做对照：单节点也失败时查核心和字段，单节点成功而整份订阅失败时查批量订阅格式或解析兼容性。

更新订阅后原来选中的节点消失，如何恢复？

进入节点列表重新选择当前仍存在的节点，回到基本设置确认全局节点或默认节点不是空值，然后保存并应用。如果节点整体被更新删除或数量变为零，应先恢复备份、暂停自动更新，再单独验证订阅地址。

可以把完整订阅链接或日志发到网上求助吗？

不建议。订阅 URL 可能包含身份令牌，日志也可能暴露节点地址、用户名或认证信息。求助时只保留软件版本、错误关键词、HTTP 状态码和已打码的日志片段。

相关阅读

• 继续排查 PassWall2 连接失败
• 查看 PassWall2 的 OpenWrt 安装与订阅导入
• 检查 PassWall sing-box 设置与核心启动
• 学习 PassWall2 路由日志怎么看

参考资料

1. PassWall2 官方控制器代码：节点列表与节点订阅菜单
2. PassWall2 官方节点订阅配置代码：过滤模式与关键词字段
3. PassWall2 官方发行页：版本与组件信息
4. PassWall2 官方问题记录：订阅更新后的节点引用问题
5. curl 官方手册：请求、重定向与超时参数（curl.se）
6. curl 官方教程：查看响应头与文档信息（curl.se）
7. OpenWrt 官方文档：使用 logread 查看日志（openwrt.org）