机场博客JICHANGBOKE.ORG

PassWall2 安装与使用教程(OpenWrt 路由器)

维护中多内核开源免费GPL-3.0

PassWall2 是 OpenWrt 路由器上的代理插件,开源免费,节点走 Xray 或 sing-box 内核,能导入订阅,也能按设备设规则。想让全家设备一起走代理的人可以装,2026 年 9 月仍在频繁发版。

作者 塔台君更新 最新版本 26.9.16-1,核对于

官方下载

官方下载走 GitHub,国内网络经常打不开。手上没有能用的代理,可以先买一份 星岛梦-六年老牌专线,也可以试试下面的加速下载。

路由器 加速下载26.9.16-1,10 个文件

文件清单取自官方发布页,版本 26.9.16-1,发布于 2026 年 9 月 16 日。加速线路是第三方公益镜像,转发的是官方发布页上的同一份文件,镜像随时可能失效。下载后请到官方发布页核对文件大小,有校验值的核对 SHA256。不知道选哪个文件,看下面对应系统的教程第一步。

许可证
GPL-3.0

「最新官方版本下载」只通向官方发布页或官方商店,请在发布页选择与你系统对应的文件,有校验值的核对 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 --versionapk --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 --versionapk --version,确认包管理器类型
  • 想要中文界面,准备好一并安装中文语言包
  1. 从官方渠道下载并安装

    到 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 是两个不同插件。

  2. 进入服务里的 PassWall 2

    在 LuCI 左侧点服务,会看到 PassWall 和 PassWall 2 两个入口,点第二个。顶部是连接检测卡片。Core 运行中,百度、谷歌、GitHub 连接分别显示延迟,下面主开关和节点用来选当前走哪个节点,类型显示的是 Xray

    PassWall 2 主设置页,顶部四张连接状态卡片,下方是主开关和节点选择
  3. 在便捷导入区复制订阅

    登录机场用户中心,找到便捷导入区块,按客户端类型分了好几个按钮。PassWall2 走的是节点订阅,不是 Clash 配置,认准复制 V2Ray 订阅链接这一个,别跟 CFW / ClashX 订阅那个搞混。

    机场用户中心的便捷导入区块,复制 V2Ray 订阅链接按钮在其中一排
  4. 也可以用一键订阅菜单

    有些机场的用户中心没有便捷导入区,只有一键订阅这一个入口。点开会弹出菜单,第一项复制订阅地址给的是通用订阅链接,PassWall2 一样认,粘贴进订阅地址框就行。

    机场用户中心的一键订阅下拉菜单,复制订阅地址一项被红框标出
  5. 点节点订阅再点添加

    回到 PassWall2 页面,点顶部标签栏的节点订阅。这一页能设置多条订阅共用的过滤规则,丢弃列表里默认把带过期时间、剩余流量字样的节点排除掉。往下滑到订阅列表,点添加,开始填一条新订阅。

    PassWall2 节点订阅页,节点订阅标签和左下角添加按钮被红框标出
  6. 填订阅信息并保存应用

    订阅备注(机场)填一个方便识别的名字。订阅网址粘贴刚才复制的链接,允许不安全连接默认勾选就行。下面几个节点使用类型留着使用全局配置,想让订阅自动更新,勾开启自动更新订阅并选好频率,填完点保存并应用。

    新增订阅表单,订阅备注和订阅网址输入框及保存并应用按钮被红框标出
  7. 在节点列表里选节点

    点顶部标签栏的节点列表,保存的订阅会展开成一长串节点,备注、Ping、TCPing 几列显示延迟。最前面几行其实是机场用来显示剩余天数和套餐到期时间的提示条目,连不上很正常。往下翻到写着地名的那些才是能选的节点,点这一行的使用按钮就切过去。

    PassWall2 节点列表,多个香港节点及延迟数值,其中一个节点的使用按钮被红框标出
  8. 开启路由器本机代理

    回到基本设置页,节点选成刚才选中的那个。Core 状态显示运行中,说明服务已经起来了。路由器本机代理这个开关按界面提示,勾选后路由器自己发出的请求会走代理,局域网设备怎么走代理由访问控制标签页里的规则单独控制。

    PassWall2 基本设置页,Core 运行状态和节点选择框被红框标出

路由器 上常见的问题

装上以后代理不生效,也不报错

先去 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。