Passwall 安装与设置：OpenWrt 代理插件入门
梯子岛编辑部 · 更新于 Passwall 是 OpenWrt 上的 LuCI 代理插件，按节点类型调用 Xray 或 sing-box 等组件。安装前要确认固件与架构，并按官方 README 处理依赖库；订阅靠分享链接解析导入。装完请分层验证，并留好备份与回退办法。
PassWall26.10.4-1
- 类型
- 按节点类型选择 Xray 或 sing-box 等 系路由器插件
- 内核
- 按节点类型选择 Xray 或 sing-box 等
- 支持系统
- 路由器
- 最新版本发布于
- 2026-10-04（核验时已发布 4 天）
- 版本核验时间
- 2026-10-09 09:07 UTC（来源：GitHub 官方接口）
- 官方地址
- github.com/Openwrt-Passwall/openwrt-passwall/releases
很多人搜“Passwall 安装”，想要的是一条命令。但在 OpenWrt 上，真正容易出问题的是命令之前：固件对不对、依赖库来源对不对、装完怎么验证。这篇按顺序把这些讲清楚，再说订阅和节点怎么放。它只写客户端侧，不涉及服务端，客户端定位见 Passwall 档案。
先搞清它是什么，再决定要不要装
Passwall 是 OpenWrt 上的 LuCI 插件，在网页管理界面里配置节点和分流。它自己不是代理内核，而是按所选节点类型去调用 Xray、sing-box 等组件。所以装它，其实是在装一整套：插件本体、内核组件、以及一些支撑库。
这也解释了为什么它的依赖问题比较多。内核组件的细节可以读 Xray-core 是什么 和 sing-box 是什么。和另一款常见路由器插件的差异，见 OpenClash 与 Passwall 对比。整个路由器方案的取舍，则看 路由器翻墙怎么做。
开始之前，核对这五件事
| 核对项 | 为什么 | 做法 |
|---|---|---|
| 固件是否为 OpenWrt 系 | 它依赖 OpenWrt 的包管理与 LuCI | 登录管理页看固件信息，固件分类见 路由器固件导航 |
| 设备架构 | 安装包按架构区分 | 在系统信息里查，不要靠猜 |
| 剩余存储与内存 | 内核组件占空间 | 空间不足时不要硬装 |
| 配置备份 | 出错要能回退 | 使用系统自带的备份功能 |
| 能否访问软件源 | 依赖要联网下载 | 先确认路由器自身联网正常 |
设备是否被 OpenWrt 支持，可以到 OpenWrt 官网 的设备资料里确认。不确定就不要动手，刷机和改固件都有不可逆的风险。
Passwall 安装的核心：依赖库仓库要按官方说明处理
README 的编译说明里有一条很关键：要先移除固件软件源里自带的旧核心库，再加入官方的依赖库仓库。原因是固件自带的核心库版本往往落后，与插件不匹配，混用会出现各种奇怪的报错。
通用流程是：
- 打开官方仓库首页，找到安装说明那一节，完整读一遍。
- 按说明在软件源配置里调整，移除旧的核心库来源，再加入新的依赖库仓库，写法照抄说明，不要改。
- 刷新软件包列表，确认能看到核心组件。
- 再安装插件本体和需要的语言包。
下载入口只认官方，统一汇总在 下载导航 与 GitHub 项目导航。网上流传的“一键整合包”无法核对内容，不要使用，识别方法见 破解版梯子软件能用吗。
关于仓库路径：我们查到的和没查到的
这里有一件需要诚实交代的事。早期常见的仓库路径，现在已经打不开了；官方组织下有同名仓库，README 的安装说明与旧仓库一致，只是换了路径。这有可能是迁移，但 README 没有明说，所以“迁移关系”写作资料待核实。
对你的实际影响是：
- 以组织下现有仓库为准，别再看旧路径的任何文章里的链接；
- 看到教程里的旧地址，要先核对再用；
- 对插件的第二代，同组织下另有仓库，名字带有数字 2，两者关系见各自首页。
passwall设置：节点怎么放进去
插件装好后，进入它的管理页，节点有两种放法：
手动添加节点：在节点列表里新增，选择节点类型，再填入地址、端口、认证信息和传输参数。类型会决定调用哪个核心，也决定哪些字段可填。这里参数很多，建议从服务方给出的节点信息逐项抄，不要凭记忆填。
订阅导入：在订阅设置里新增订阅地址，手动更新一次。订阅脚本能解析分享链接，覆盖的类型包括 ss、ssr、vmess、vless、trojan、hysteria、hysteria2、tuic、anytls 等。注意几点：
- ShadowsocksR 需要另外安装对应的组件才能使用；
- TUIC 只在 sing-box 核心带有相应编译选项时才提供，所以是部分支持；
- 对 Clash 格式订阅的支持范围，资料待核实，如果订阅是 Clash 配置，先用本地工具转换为分享链接更稳妥。
链接格式可以先读 节点链接怎么读，转换放在 节点转换工具 里本地进行。订阅是凭证，泄露处理见 订阅链接泄露了怎么办。
必须知道的一条变更：自签证书节点
官方 README 的公告写明：自 2026 年 6 月 1 日起，Xray 核心弃用了跳过证书校验的写法，使用自签证书的节点必须带证书指纹相关参数，否则连不上。解决思路只有两个：向服务方索取该参数，或者改用 sing-box 核心。如果你的节点突然全部连不上，而昨天还好好的，先检查这一项，再看 节点超时怎么办。
装完之后怎么验证
- 服务状态：总开关打开后，状态页显示运行，日志无持续报错。
- 出口检查：用路由器下的设备打开 IP 与 DNS 检测导航 里的工具，确认出口。
- 分流检查：挑一个应该直连、一个应该代理的网站各访问一次。
- DNS 检查：按 DNS 泄露怎么解决 排查。
透明代理方式我们只确认到资料里的 REDIRECT 与 TPROXY，是否有 TUN 方式，资料待核实，所以不要照搬桌面客户端的 TUN 模式 经验。
Passwall 安装的回退方案：先想好再动手
- 第一层：插件总开关关闭，网络应回到原样；
- 第二层：用事先备份还原配置；
- 第三层：路由器恢复模式回到干净固件。
接下来看什么
- 想比较方案，读 OpenClash 与 Passwall 对比；
- 想换另一个插件，读 OpenClash 安装与订阅配置；
- 订阅或节点异常，读 梯子连不上怎么办。
这篇没有覆盖的
- 官方 README 没有完整的功能手册，协议支持部分来自节点编辑页源码，细节随版本变化，请以你安装的版本为准。
- 原仓库路径现在已无法打开，与现路径之间的迁移关系 README 没有明说，本文只写“资料待核实”。
- 不涉及固件刷写与服务端搭建，只讲插件侧的安装与客户端设置。
- 没有任何型号路由器上的性能结论，也不比较与其他插件的速度。
本文引用的官方来源
- PassWall（github.com）
- PassWall 官方下载入口（github.com）
- PassWall 2（github.com）
- OpenWrt 文档（openwrt.org）
以上链接均为官方页面，梯子岛在 2026-10-09 核对过；个别网站会拦截自动化访问，用浏览器直接打开即可。平台规则可能随时调整，以官方页面当前内容为准。
Passwall 安装常见问题
Passwall 和 Passwall2 是同一个东西吗？
它们是同一系列下的两个项目，名字相近但并非一回事。两者的分工和差异请以各自仓库的说明为准，本文只覆盖第一个。选哪个之前，建议分别打开仓库首页读一遍简介，再看你的固件上哪个更容易装好。
导入订阅后只有部分节点出现，是怎么回事？
订阅脚本能解析的是分享链接，支持的类型包括 ss、ssr、vmess、vless、trojan、hysteria、hysteria2、tuic、anytls 等。不在其中的类型会被跳过，所选核心不支持的协议也可能不显示。先确认订阅里节点的协议类型。
使用自签证书的节点为什么突然连不上了？
官方 README 的公告提到，自 2026 年 6 月起 Xray 核心弃用了跳过证书校验的写法，使用自签证书的节点需要带上证书指纹相关参数，否则无法连接。可以向服务方索取参数，或改用 sing-box 核心。具体以公告为准。
它支持 TUN 模式吗？
资料里只见到 REDIRECT 与 TPROXY 方式的透明代理说明，没有看到 TUN 的说明，所以这一项写资料待核实。需要 TUN 的话，请先对照你所用版本的界面和官方说明，不要凭经验推断。
装完之后家里全断网了怎么办？
先在插件里关闭总开关，再检查 DNS 与防火墙相关设置有没有被改动。仍未恢复就用安装前的备份还原，必要时用路由器的恢复模式回到干净状态，所以安装前备份是必须做的一步。
接着读
- 客户端 · Passwall 与 Passwall2 是什么？OpenWrt 代理插件的区别
- 对比 · OpenClash 与 Passwall 对比：路由器代理插件怎么选
- 平台 · 路由器翻墙怎么做？固件、插件与家庭网络的取舍
- 教程 · OpenClash 安装与订阅配置：路由器翻墙入门
- 客户端 · Xray-core 是什么？Xray 内核与 V2Ray 的关系
- 客户端 · sing-box 是什么？内核、官方客户端与各平台入口