官方下载
官方下载走 GitHub,国内网络经常打不开。手上没有能用的代理,可以先买一份 星岛梦-六年老牌专线,也可以试试下面的加速下载。
路由器 加速下载26.9.16-1,10 个文件
- luci-app-passwall2-26.9.16-r1.apk336 KB线路一线路二
- luci-app-passwall2_26.9.16-r1_all.ipk335 KB线路一线路二
- luci-i18n-passwall2-fa-26.9.16.apk22 KB线路一线路二
- luci-i18n-passwall2-fa_26.9.16_all.ipk23 KB线路一线路二
- luci-i18n-passwall2-ru-26.9.16.apk23 KB线路一线路二
- luci-i18n-passwall2-ru_26.9.16_all.ipk24 KB线路一线路二
- luci-i18n-passwall2-zh-cn-26.9.16.apk20 KB线路一线路二
- luci-i18n-passwall2-zh-cn_26.9.16_all.ipk20 KB线路一线路二
- luci-i18n-passwall2-zh-tw-26.9.16.apk20 KB线路一线路二
- luci-i18n-passwall2-zh-tw_26.9.16_all.ipk20 KB线路一线路二
文件清单取自官方发布页,版本 26.9.16-1,发布于 2026 年 9 月 16 日。加速线路是第三方公益镜像,转发的是官方发布页上的同一份文件,镜像随时可能失效。下载后请到官方发布页核对文件大小,有校验值的核对 SHA256。不知道选哪个文件,看下面对应系统的教程第一步。
「最新官方版本下载」只通向官方发布页或官方商店,请在发布页选择与你系统对应的文件,有校验值的核对 SHA256。本站不托管任何安装包。
PassWall2 是一个 LuCI 插件。装进 OpenWrt 以后,它出现在路由器后台的服务菜单里,代理协议由它调用的内核来跑,README 列出的可选内核有 Xray、sing-box、Shadowsocks-Rust、ShadowsocksR,另有 HAProxy 做负载均衡。功能上能导入订阅、测延迟、做故障切换,还可以按设备分别设置走不走代理。
仓库搬过家
老教程里常见的地址 xiaorouji/openwrt-passwall2,本站 2026 年 9 月 18 日访问已经是 404。现在的仓库在 Openwrt-Passwall 组织下面。同一个组织里还有另一个仓库 openwrt-passwall,两个分开维护,名字只差一个数字,下载时别拿错。许可证 GPL-3.0。
它更新很勤。核对当天最新版是 9 月 16 日的 26.9.16-1,三天前刚发过 26.9.12-2,版本号就是发布日期。发布页同时提供 ipk 和 apk 两种包,对应 OpenWrt 新旧两套包管理器,中文界面要另装 luci-i18n-passwall2-zh-cn 语言包。README 写明的要求是 OpenWrt 21.02 以上,内存至少 256MB。
机场给的是 Clash 订阅的话,路由器上用 OpenClash 更对路。不想装 LuCI 插件、只有 SSH 的设备可以看 ShellCrash,其余选择在路由器客户端对比里。
适合
- 想让家里所有设备都走路由器代理的 OpenWrt 用户
- 机场节点是 VLESS、VMess、Trojan、Hysteria2 这类 V2Ray 系协议的人
- 需要按设备分别设置代理规则的人
要注意
- README 要求路由器内存至少 256MB,小内存的老路由器跑不动
- 安装前先用
opkg --version或apk --version确认固件用哪种包管理器,ipk 和 apk 不能混装 - 用 apk 手动安装要加
--allow-untrusted,README 自己标注了这会跳过签名校验 - 老教程里的 xiaorouji 仓库地址已经失效,要到 Openwrt-Passwall 组织的仓库下载
PassWall2 路由器使用教程
截图版本 OpenWrt 23.05
PassWall2 同样装在 OpenWrt 路由器的 LuCI 后台,但菜单结构和 OpenClash 完全不同,节点订阅、节点列表、基本设置分成好几个标签页。装插件、导入机场的节点订阅、选节点、开启本机代理,一共四步,装之前要先确认包管理器是 opkg 还是 apk,要不要装中文语言包。截图里的固件是 OpenWrt 23.05,插件版本读不出来。
开始前准备
- 路由器已刷好 OpenWrt 固件,系统版本不低于 21.02,内存至少 256MB
- 机场提供节点订阅链接,格式是 V2Ray 或通用节点订阅,没选好机场可以先看机场榜单
- SSH 连上路由器,执行一次
opkg --version或apk --version,确认包管理器类型 - 想要中文界面,准备好一并安装中文语言包
从官方渠道下载并安装
到 PassWall2 的 GitHub 仓库 Releases 页下载安装包。SSH 执行
opkg --version有输出选 ipk,执行apk --version有输出选 apk,主程序包名是luci-app-passwall2开头、all结尾的那个。想要中文界面,再下一个luci-i18n-passwall2-zh-cn语言包。用 apk 手动装要加--allow-untrusted参数跳过签名校验。装完在 LuCI 左侧服务菜单里能看到 PassWall 2,和不带数字的 PassWall 是两个不同插件。进入服务里的 PassWall 2
在 LuCI 左侧点服务,会看到 PassWall 和 PassWall 2 两个入口,点第二个。顶部是连接检测卡片。Core 运行中,百度、谷歌、GitHub 连接分别显示延迟,下面主开关和节点用来选当前走哪个节点,类型显示的是 Xray。

路由器 上常见的问题
装上以后代理不生效,也不报错
先去 SSH 里执行 logread | grep passwall2 看有没有报错。或者在插件的其他设置里打开调试日志,再看 /tmp/log/passwall2.log 的内容,常见原因是选的内核对应的依赖没装全,比如选了 Xray 节点但 xray-core 没装上。
装的时候提示缺少依赖,或者装完用不了
多半是 ipk 和 apk 混装了,或者对应的内核软件包没有一起装。先确认固件是 opkg 还是 apk 管理,两种不能混用。缺 xray-core、sing-box 这类内核包时,要按 README 的说明把 PassWall 的软件源加进去再重新安装。
订阅导入进来了,但节点列表里 Ping 和 TCPing 一直测不出数据
先点这个节点后面的测试链接单独测一次。如果所有节点都测不出来,通常是节点使用类型选错了内核,回节点订阅页把 VMess、VLESS 这些协议对应的使用类型改成节点真实支持的那个。
装完中文语言包,界面还是英文
装完语言包要在 LuCI 顶部的系统里找语言设置,把界面语言切成中文,装包本身不会自动切换,刷新一次页面,PassWall 2 的菜单和页面文字才会跟着变。
PassWall2 常见问题
PassWall2 的仓库地址变了吗
地址变了。老教程里的 xiaorouji/openwrt-passwall2 在本站 2026 年 9 月 18 日访问时已经是 404,现在的仓库在 Openwrt-Passwall 组织下面,名字仍叫 openwrt-passwall2。下载安装包和查更新日志都到新仓库的发布页。
PassWall2 该下载 ipk 还是 apk
看固件用哪种包管理器。在路由器的 SSH 里执行 opkg --version,有输出就下 ipk,执行 apk --version 有输出就下 apk。主程序的文件名是 luci-app-passwall2 开头、all 结尾的那个,想要中文界面再下一个 zh-cn 语言包。
PassWall2 和 OpenClash 怎么选
先看机场给什么订阅。OpenClash 用 mihomo 内核,读的是 Clash 订阅,分流规则通常直接用订阅里自带的。PassWall2 调用 Xray 或 sing-box,导入的是节点订阅,分流规则在插件里自己设。两个都开源免费,也都在持续更新。
PassWall2 装不上或者启动不了怎么办
先查日志。README 给的办法是在 SSH 里执行 logread | grep passwall2,或者在其他设置里打开调试日志后查看 /tmp/log/passwall2.log。安装时报缺少依赖,比如找不到 xray-core,需要按 README 的说明把 PassWall 的软件源加进去再装。
PassWall2 的订阅要填几条
一条机场订阅通常就够,节点订阅页支持同时保存多条,互不影响。想同时开着两家机场对比线路,都加进去也可以,用的时候在节点列表里切换哪一条的哪个节点。
节点订阅要多久更新一次
在添加订阅那页勾开启自动更新订阅,选好星期几和几点,插件会定时重新拉取。不想等的话回节点订阅页,点那条订阅后面的手动订阅按钮,立刻拉取一次最新节点。
PassWall2 和 PassWall 是一个东西吗
不是,LuCI 服务菜单里 PassWall 和 PassWall 2 是两个分开的入口。装了其中一个不会影响另一个,配置也不互通,这份教程只讲 PassWall 2。






