PassWall2 订阅转换怎么用?从格式判断到节点导入
简答:先直接导入原始订阅,能正常出现节点就不要转换;只有出现格式解析错误、节点为空或服务商明确要求转换时,才处理订阅转换。转换时不要把 PassWall2、Xray、sing-box 当成同一类“目标客户端”:PassWall2 是 OpenWrt 插件,Xray 和 sing-box 是可供节点使用的核心。最快流程是:备份原始链接→确认返回内容→按转换工具实际字段选择输出格式→把生成的订阅 URL 填入“节点订阅”→保存并应用→手动更新并验证节点。
定义:PassWall2 订阅转换,是把原始订阅内容或链接转换为当前 PassWall2 安装环境能够获取、解析并交给相应核心使用的节点订阅格式。
先看结论:直接导入优先,格式报错再转换
PassWall2 的订阅流程重点是保存订阅 URL、手动更新、过滤节点,并根据已安装核心处理不同协议。当前公开源码显示,LuCI 菜单中有独立的“Node Subscribe”页面;在该页面源码中可见“Subscribe URL”和“Manual subscription”等字段,但这只能证明该页面负责订阅管理,不能据此断言所有版本和界面都不存在其他转换入口。查看 PassWall2 菜单路由源码,查看节点订阅页面源码。
| 你手里的内容 | 第一步 | 是否先转换 |
|---|---|---|
| 服务商提供的通用订阅 URL,更新后已有节点 | 直接填入“订阅网址”并手动更新 | 不需要 |
| Clash 或 Mihomo 配置,返回 YAML/JSON 内容 | 先确认当前版本和核心是否能处理该内容 | 解析失败时再转换 |
| VMess、VLESS、Trojan、Shadowsocks 等节点链接 | 确认链接没有被截断,再按服务商说明导入 | 通常不必转换 |
| 更新成功但节点数量为 0 | 检查返回内容、过滤规则和订阅有效性 | 不要立即转换 |
| 转换后仍为空或日志报格式错误 | 回到源订阅和输出格式重新核对 | 先停止反复转换 |
关键判断:“更新成功”只代表请求或流程没有立即失败,不等于已经生成可用节点;“节点数量大于 0”也不等于核心已经启动或设备已经能够访问目标网络。
四步速查:从原始订阅到 PassWall2 节点
- 备份原始订阅:把服务商后台复制的原始 URL 单独保存,不要用转换后的 URL 覆盖。订阅地址可能包含账号令牌,不要贴到公开聊天、截图或不明网站。
- 先直接导入:进入 OpenWrt LuCI,通常可从“服务”或“Services”下的 PassWall 2 进入“节点订阅”或“Node Subscribe”。如果找不到,先确认 PassWall2 已安装、LuCI 服务已重载,并检查菜单是否被隐藏。源码中的控制器路由将该页面注册为
node_subscribe,但翻译名称会随版本变化。查看页面路由。 - 保存后手动更新:新增订阅时填写备注和订阅网址,先点击“保存并应用”,再点击“手动订阅”或相近名称的更新按钮。节点订阅源码明确包含新增订阅需要先保存再手动订阅的提示。查看订阅字段和手动更新按钮。
- 分层验证:先看订阅记录是否保存,再看对应分组的节点数量,再看节点能否启动,最后测试实际设备访问。任何一层失败,都先记录现象,不要同时修改 DNS、分流和 MTU。
成功判据:订阅记录存在、更新动作有结果、对应分组出现节点、所选节点能够被相应核心启动。若只完成前两项,不应写成“已经连接成功”。
字段速查卡:源订阅、目标格式、后端和生成链接怎么填
不同转换工具的字段名并不统一,下面的内容是仅示意的填写样式,其中域名、令牌和输出地址都不是可用入口,必须替换为你自己的真实值。不要把示例地址直接粘贴到路由器。
| 字段 | 示意填写 | 填写原则 | 在 PassWall2 中对应位置 |
|---|---|---|---|
| 源订阅 URL | https://provider.example/sub?token=YOUR_TOKEN | 使用服务商原始地址,检查协议、路径和令牌是否完整 | “节点订阅”中的“订阅网址” |
| 源内容类型 | Clash/Mihomo YAML 或“通用节点订阅” | 按实际返回内容判断,不要只按 URL 后缀判断 | 不是 PassWall2 的固定字段 |
| 目标输出格式 | 工具实际提供的 URI/JSON/YAML 输出 | 选择转换工具明确支持、且当前核心能够处理的格式 | 仍填写转换后生成的 URL |
| 后端或节点使用核心 | Auto、xray 或 sing-box | 按节点协议和设备已安装的核心选择,不要把核心名称当成订阅格式 | 订阅配置或节点类型对应的核心选项 |
| 生成后的订阅 URL | https://converter.example/result?token=NEW_TOKEN | 确认这是可重复请求的订阅地址,而不是一次性预览页面 | “订阅网址”字段 |
PassWall2 的订阅配置源码显示,Shadowsocks、Trojan、VMess、VLESS 和 Hysteria2 等节点可按已发现的 sing-box、xray 或其他核心设置使用;因此“目标客户端”并不是最准确的填写概念,实际应区分输出格式与节点使用核心。查看订阅配置中的核心和 User-Agent 选项。
一个可照做但不含真实账号的流程是:源订阅选择“服务商原始 URL”→源类型按实际返回值选择 Clash/Mihomo 或通用节点→目标输出选择转换工具明确列出的格式→后端先保持 Auto,只有日志或节点协议要求时再指定 xray 或 sing-box→复制生成后的可更新 URL→粘贴到 PassWall2 的“订阅网址”→保存并应用→手动订阅。
怎么确认转换结果真的可用
- 先检查响应性质:在路由器或电脑上请求生成后的 URL,确认不是登录页、验证码页、HTML 错误页或空响应。不要把完整令牌复制到日志或文章中。可只查看状态和响应头:
curl -I --max-time 15 '替换为你的订阅地址'。这只能说明地址有响应,不能证明 PassWall2 一定能解析。 - 再看订阅记录:PassWall2 页面中应能看到你填写的备注、订阅地址和更新按钮。若新增记录消失,先回到保存步骤,不要继续改转换格式。
- 再看节点数量:在对应订阅分组中确认节点数量是否大于 0。源码中的订阅页面会按分组统计节点数量,过滤模式也会影响最终列表。查看节点数量和过滤字段。
- 最后看核心和链路:选择节点后,分别检查核心进程、路由器自身访问、终端设备访问和 DNS 解析。节点出现但核心不启动,优先检查核心安装和协议匹配;核心启动但网页打不开,再进入 DNS、分流或 MTU 排查。
PassWall2 项目说明列出了 Xray、Sing-Box 等可选协议包,但实际可用性仍取决于固件架构、安装包、订阅协议和当前配置,不能把项目支持列表直接理解为你的设备已经安装了对应核心。查看项目说明中的依赖和可选协议包。
找不到按钮、节点为空或更新失败:按现象分流
| 现象 | 先检查 | 成功判据 | 回滚方式 |
|---|---|---|---|
| 找不到“节点订阅” | 确认进入的是 PassWall 2 菜单,而不是其他插件;检查 LuCI 菜单语言和隐藏设置 | 能打开订阅列表页面 | 重载 LuCI 或恢复菜单显示设置 |
| 保存后没有订阅记录 | 备注、URL 是否为空;是否真的点击保存并应用 | 刷新页面后记录仍存在 | 重新添加原始订阅,不覆盖旧记录 |
| 更新成功但节点为 0 | URL 是否过期;返回是否为 HTML;过滤模式是否为保留列表 | 临时关闭过滤后能看到节点 | 恢复原始 URL,保留转换前配置 |
| 日志提示解析错误 | 源类型和目标输出是否选错;返回内容是否被截断 | 日志不再出现格式错误且节点出现 | 删除转换 URL,直接测试源订阅 |
| 节点存在但核心不启动 | 协议、核心、固件架构和依赖是否匹配 | 核心进程保持运行 | 改回 Auto 或选择已安装核心 |
| 核心运行但网页打不开 | DNS、分流、网关、MTU 和终端代理路径 | 路由器和终端分层测试均有记录 | 先关闭新增分流或 DNS 修改 |
如果转换服务曾接触过包含令牌的订阅地址,只有在令牌可能暴露、被公开提交或出现异常访问时,才需要考虑在服务商后台重新生成令牌;这不是每次转换后都必须执行的步骤。更稳妥的顺序是优先使用服务商提供的目标格式,或使用本地、可审计的转换方式。本文不提供未经核验的转换站入口,也不把任何第三方工具视为官方工具。
版本差异、适用范围与回滚清单
本文按截至 2026-11-08 可查看到的 PassWall2 公开项目源码和发布页整理。项目发布页显示,版本同时存在 IPK、APK 等不同包格式,因此菜单、字段翻译、依赖和核心选项可能随 OpenWrt 构建、设备架构及 PassWall2 版本变化。查看 PassWall2 发布页。
本文适用于已经安装 PassWall2、能够进入 OpenWrt LuCI、拥有订阅 URL,并希望判断是否需要转换的用户。操作前建议记录 OpenWrt 版本、PassWall2 版本、设备架构、原始订阅 URL 是否可访问、订阅更新前后的节点数量、当前核心和日志摘要。
- 不要删除唯一的原始订阅记录,先新增一条转换后的订阅。
- 不要同时修改订阅、DNS、分流和 MTU,否则无法判断是哪一步造成变化。
- 转换失败时,恢复原始订阅 URL;节点出现但核心失败时,恢复核心为 Auto 或之前可用的核心。
- 如果自动更新后当前节点失效,重新检查全局节点选择。公开 issue 记录过订阅更新后节点引用失效的案例,但这不是所有版本都会出现的结论,应以本机日志和配置为准。查看相关 issue。
推荐阅读与内部链接
如果你还没有完成基础导入,先看PassWall 订阅怎么导入 OpenWrt;如果已经导入但节点为空,可继续看PassWall2 订阅格式不支持怎么办和PassWall2 节点不显示怎么办。若节点已经出现但无法联网,再进入PassWall2 连接失败排查,不要继续反复更换转换格式。
本站是第三方使用指南站,不是 PassWall2 或任何订阅服务的官网;具体版本、菜单和服务商格式应以对应项目或服务提供方的实际资料为准。
常见问题
PassWall2 订阅转换是不是插件里的固定功能?
PassWall2 当前公开源码能确认的是“节点订阅”管理、订阅 URL、手动更新、过滤和核心配置。本文引用的页面源码中未见独立的转换字段,但这不等于所有版本或第三方界面都不存在其他入口。实际使用时,优先以当前界面和项目版本为准。
Clash 或 Mihomo 订阅能直接导入 PassWall2 吗?
不能一概而论。要看实际返回内容、PassWall2 版本、过滤设置和已安装核心。先直接导入并查看节点数量;只有出现解析错误或节点为空时,才考虑转换。
转换工具里的目标客户端应该选 PassWall2、Xray 还是 sing-box?
不要把三者当作同一类选项。PassWall2 是 OpenWrt 插件,Xray 和 sing-box 更接近节点使用核心。转换时先选择工具实际提供并且能输出有效内容的格式,再在 PassWall2 的订阅配置中按协议和已安装情况选择核心;如果没有明确对应项,先保持 Auto 并用日志验证。
为什么订阅更新成功,但节点数量是 0?
先检查返回内容是否为 HTML、登录页、验证码或错误信息,再检查订阅是否过期、过滤模式是否过严,以及路由器是否能够访问订阅地址。关闭过滤只能作为临时定位手段,确认节点出现后应恢复必要的过滤规则。
生成后的订阅 URL 可以直接公开吗?
不建议。订阅 URL 可能包含账号令牌,转换服务、日志、截图和公开聊天都可能造成暴露。优先使用服务商提供的目标格式或本地可审计方式;只有在令牌确实可能泄露或被公开提交时,才考虑重新生成令牌。
节点导入后仍然不能联网,是否说明转换失败?
不一定。订阅转换主要解决配置获取和解析;节点存在但核心未运行、DNS 异常、分流错误、MTU 不合适或终端没有经过路由器,都可能导致无法联网。应按节点存在、核心运行、路由器访问、DNS 和终端访问分层检查。