PassWall 教程：OpenWrt 插件与节点订阅

PassWall 是 OpenWrt 上的 LuCI 代理管理插件。它负责组织节点、规则与相关核心组件，不能脱离固件和依赖单独理解。当前上游为 Openwrt-Passwall/openwrt-passwall，本地旧素材里的部分仓库地址与安装方式已经过时。

先分清 PassWall 和 PassWall2

两者是不同项目，安装包、依赖和配置不要混用。先确定自己要维护哪一个，再按对应官方仓库处理。遇到历史教程中的旧分支或固定下载链接，先回到当前上游核对，不要因包名相似直接覆盖安装。

如果固件已经集成插件，应先了解固件维护者提供的升级路径。跨来源强行替换，可能出现依赖、内核或防火墙配置不兼容。

安装前的检查清单

1. 确认路由器架构、固件版本、包管理方式与可用空间。
2. 备份现有网络和插件配置，保留能够直接访问管理页的方式。
3. 阅读上游当前依赖说明，区分 LuCI 界面包与实际执行连接的核心组件。
4. 使用与该固件匹配的软件源或发行包，不把旧 .run、ipk 或固定依赖列表当作所有设备通用的安装方案。

这张图只帮助识别历史软件包页面。图中的文件名与校验值不是当前应下载的清单，更不能证明你的固件接受相同软件包。

节点订阅与首次验证

从服务商取得明确支持该插件及所用核心的订阅，在订阅管理中添加并更新。列表有节点之后，还要确认选中的节点、使用的核心和路由规则相互匹配。

先在可控范围内验证，不急于让全家所有设备依赖新配置。路由器本机能连接后，还应测试局域网设备是否经过预期网关、解析器与出站；这两种测试不能互相替代。

DNS 与多个插件的冲突

透明代理会影响网络路径。若另一插件同时接管 DNS、修改防火墙或占用相同端口，异常可能表现为所有网站超时，也可能只影响部分设备。开始前记录原有设置，排查时一次只启用一种方案。

恢复正常网络优先于继续堆叠规则。先停用发生问题的接管功能，确认原始网络可用，再查插件日志和依赖状态。不要在没有恢复路径时批量执行陌生脚本。

常见问题

界面安装成功，为什么没有可用节点？ 界面、核心、订阅与套餐状态是不同层面。依次确认订阅更新结果、核心是否正常、协议是否支持及节点是否有效。

订阅可在手机用，路由器就一定能用吗？ 不一定。手机客户端的导入方式和插件所需格式可能不同，需要服务商确认。

能直接用旧教程一键安装吗？ 先核对固件、架构、脚本来源与当前上游说明。不要用安装命令代替兼容性判断。

比较配置管理方式可继续看 OpenClash；了解系统和插件的区别见 iStoreOS，Linux 进阶方案见 dae。