PassWall 2 路由器导入订阅教程：要求与上手要点

官方信息核对（2026-10-21）

本表只记录官方 GitHub 仓库首页、Releases 页面和仓库源码中直接看到的信息。

项目	核对结果
官方仓库	https://github.com/Openwrt-Passwall/openwrt-passwall2
官方发布页	https://github.com/Openwrt-Passwall/openwrt-passwall2/releases
最新发布版本	26.10.20-1（标记为 Latest，非预发布）
发布日期	2026-10-20
适用系统	OpenWrt 21.02 及以上，LuCI 17.01 及以上
内存要求	至少 256MB
安装包格式	.ipk（opkg）与 .apk（apk）
许可证	GPL-3.0
是否归档	否
可选内核与组件	Xray、sing-box、Shadowsocks-Rust、ShadowsocksR、HAProxy

官方仓库简介为「A simple powerful OpenWrt LuCI proxy application」，即一个面向 OpenWrt 的 LuCI 代理应用。最新版本的发布说明列出了随附组件的版本，其中包括 xray-core 和 sing-box，但发布说明里没有安装步骤。

PassWall 2 与 PassWall 的关系

很多人第一次看到「PassWall 2」会以为它只是 PassWall 的升级版，装了新的就该卸旧的。实际上两者都放在 Openwrt-Passwall 这个组织下，却是两个独立仓库，各自发布、各自维护，版本号也互不对应。PassWall 2 在界面组织和分流思路上做了重新设计，更强调以「节点」和「分流」为核心来组织配置。

需要提醒的是：两个插件都会接管路由器的防火墙规则和 DNS，同时启用很容易互相冲突。如果你想从一个换到另一个，先停用并卸载旧的，确认网络恢复正常后再安装新的。

先看自己的设备是否达标

PassWall 2 是少数在 README 中写明硬性要求的路由器插件，这对选型很有帮助：

• 固件版本：OpenWrt 21.02 或更高。更老的固件不在支持范围内。
• LuCI 版本：17.01 或更高。
• 内存：至少 256MB。

内存这一条最容易被忽略。代理内核在节点多、连接多的时候内存占用会明显上升，128MB 内存的老路由器即便装得上，也可能在高峰期因内存不足而让进程被系统结束，表现为间歇性断网。存储空间官方没有给出数字，这一项我们写作「未能核实」，安装前请自行确认剩余空间是否充足。

安装前的备份与风险

无论是刷机还是安装插件，都请先做好备份。操作失误可能导致全家断网，刷机失败还可能让设备无法启动。

1. 在 LuCI 中找到系统备份功能，导出配置备份文件并保存到电脑（不同固件与版本名称略有差异）。
2. 记录宽带账号、Wi-Fi 设置等关键信息。
3. 查明本机型的恢复模式进入方法。
4. 准备一条备用网络，比如手机热点。
5. 用网线连接路由器进行操作，避免在 Wi-Fi 下安装依赖时失联。

PassWall 2 安装的通用思路

PassWall 2 的 Releases 页面为每个版本提供了 luci-app-passwall2 主包及其语言包，格式有 .ipk 和 .apk 两种。较新的 OpenWrt 使用 apk 包管理器，较老的使用 opkg，请按固件实际情况选择。

通用顺序是：确认固件版本与架构，更新软件源，按需安装要用到的内核组件，再安装 PassWall 2 主包和中文语言包，最后刷新 LuCI 页面。安装后一般在「服务」菜单下能看到入口，不同固件与版本名称略有差异。

由于发布说明没有提供安装命令，本文也不给出具体参数。官方讨论区里有用户反馈在新版 OpenWrt 上遇到签名校验相关的报错，处理方式请以官方仓库讨论区和维护者说明为准，不要为了图省事关闭系统的签名校验。网上不少教程还停留在 OpenWrt 21.02 或 23.05 时代的软件源写法，照抄前请核对是否仍然适用。下载来源的判断原则可参考 下载安全指南。

PassWall 2 订阅格式与导入

官方 README 写明 PassWall 2 支持通过订阅地址导入节点。我们读了仓库中的订阅脚本，结论如下：

• base64 分享链接列表：订阅内容会先 base64 解码，再按行拆分，每行一个节点链接。手动粘贴导入时则不做解码，直接按行处理。
• Clash 配置：只要内容能被解析为 YAML，就会当作 Clash 配置处理，从节点列表中读取 ss、ssr、vmess、vless、trojan、anytls、snell 等类型的节点。
• SSD 格式：脚本中有专门识别。
• 分享链接支持的类型：ss、ssr、vmess、vless、trojan、hysteria、hysteria2（含 hy2）、tuic、anytls、naive、snell。其他类型会被提示不支持并跳过。
• sing-box 完整配置：脚本中没有看到对 sing-box 完整配置文件的解析，所以不要直接把 sing-box 格式订阅填进来。

也就是说，机场给你的「通用订阅」或「Clash 订阅」一般都能导入节点。但要注意，Clash 订阅里精心编排的规则和代理组不会被 PassWall 2 沿用，分流要在插件内重新设置。Clash 订阅的结构说明见 Clash 订阅指南，订阅链接的安全常识见 订阅链接科普。

导入后节点数比机场后台少，多半是因为部分节点类型不在支持清单里。订阅完全拉取失败时，请按 订阅更新失败 的步骤检查路由器网络、订阅是否过期以及机场是否限制了请求方式。

分流设置建议

PassWall 2 的分流以规则为单位组织，可以为不同规则指定不同节点，比如流媒体走一个节点、其他境外流量走另一个节点、国内流量直连。刚开始建议只设两三条规则，确认稳定后再逐步细化。规则越多，排查越难。分流的基础概念可以看 分流规则指南。

协议选择方面，Hysteria2、TUIC 这类基于 UDP 的协议在某些宽带环境下表现不同，节点不稳定时可以换一种协议试试，各协议的区别见 协议科普。

从 PassWall 或其他插件迁移过来

不少用户是从 PassWall 或 OpenClash 换到 PassWall 2 的。迁移时建议按下面的顺序来，避免两套规则同时生效：

1. 导出旧插件配置。 即使不打算再用，也先留一份，方便回头对照分流规则。
2. 停用并卸载旧插件。 卸载后检查网络是否恢复成「无代理」的正常状态，确认没有残留的防火墙规则或 DNS 设置。
3. 安装 PassWall 2 并导入订阅。 订阅链接可以沿用，PassWall 2 能识别分享链接列表和 Clash 配置中的节点。
4. 重新设置分流。 旧插件里的规则不能直接搬过来，需要在 PassWall 2 的分流页面里重新建立。可以参照之前导出的配置逐条还原。
5. 小范围验证。 先让一台设备走代理，确认国内外网站访问都正常，再推广到全家。

如果你原来用的是 OpenClash，要特别留意：Clash 订阅中的代理组和规则在 PassWall 2 里不会保留，迁移后看到的只有节点列表，这属于正常现象。

节点多的时候怎么管理

机场订阅动辄几十上百个节点，全部导入后管理起来很吃力。可以考虑只保留常用地区的节点，或者在分流规则里只引用少数几个稳定节点。节点越少，切换和排查越快，路由器的内存压力也越小，对接近 256MB 下限的设备尤其有帮助。

关注发布说明里的组件版本

PassWall 2 的发布说明篇幅很短，但会列出随附组件的版本，例如最新版本就写明了所带的 xray-core 和 sing-box 版本。这些信息对排查很有用：如果升级后某类节点突然失效，先对比升级前后的组件版本，看是否跨越了较大的版本变化，再到对应内核的官方说明里查找配置字段是否有调整。养成升级前看一眼发布说明的习惯，可以少走很多弯路。如果当前版本运行稳定、没有新功能需求，也不必每次新版发布都立刻升级，等社区反馈一段时间再动手同样是合理的选择。

PassWall 2 常见故障与回退

• 启用后全家断网：先关闭插件总开关，网络恢复说明是插件配置问题；仍未恢复，用系统备份还原。
• 间歇性断流：先查内存占用，低于官方 256MB 要求的设备尤其常见，再查节点质量，参考 连接断开怎么办。
• 升级后部分节点失效：留意发布说明里的组件版本变化，Xray、sing-box 升级后对某些旧参数可能不再兼容。

小结

PassWall 2 的优点是要求写得清楚、更新积极、订阅解析覆盖分享链接和 Clash 配置两种常见来源；它的门槛在于对固件版本和内存有硬性要求。家里设备多、又希望统一管理时，可以先读 家庭设备使用指南 判断是否真的需要路由器方案，再到 客户端总览 对比其他选择。本页信息核对于 2026 年 10 月 21 日。