# PassWall2 安装与使用教程（OpenWrt 路由器）

规范地址 https://jichangboke.org/clients/passwall2/
发布 2026-09-18，更新 2026-09-18
作者 塔台君，机场博客

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

## 官方来源与下载

- 维护状态 维护中
- 内核 多内核
- 源码 开源
- 价格 免费
- 最新版本 26.9.16-1，核对于 2026-09-18
- 许可证 GPL-3.0
- 官方仓库 https://github.com/Openwrt-Passwall/openwrt-passwall2
- 路由器 官方下载页 https://github.com/Openwrt-Passwall/openwrt-passwall2/releases

PassWall2 是一个 LuCI 插件。装进 OpenWrt 以后，它出现在路由器后台的服务菜单里，代理协议由它调用的内核来跑，README 列出的可选内核有 Xray、[sing-box](/glossary/#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](/clients/openclash/) 更对路。不想装 LuCI 插件、只有 SSH 的设备可以看 [ShellCrash](/clients/shellcrash/)，其余选择在[路由器客户端对比](/clients/router/)里。

## 适合

- 想让家里所有设备都走路由器代理的 OpenWrt 用户
- 机场节点是 VLESS、VMess、Trojan、Hysteria2 这类 V2Ray 系协议的人
- 需要按设备分别设置代理规则的人

## 要注意

- README 要求路由器内存至少 256MB，小内存的老路由器跑不动
- 安装前先用 `opkg --version` 或 `apk --version` 确认固件用哪种包管理器，ipk 和 apk 不能混装
- 用 apk 手动安装要加 `--allow-untrusted`，README 自己标注了这会跳过签名校验
- 老教程里的 xiaorouji 仓库地址已经失效，要到 Openwrt-Passwall 组织的仓库下载

## PassWall2 路由器使用教程

PassWall2 同样装在 OpenWrt 路由器的 LuCI 后台，但菜单结构和 OpenClash 完全不同，节点订阅、节点列表、基本设置分成好几个标签页。装插件、导入机场的节点订阅、选节点、开启本机代理，一共四步，装之前要先确认包管理器是 opkg 还是 apk，要不要装中文语言包。截图里的固件是 OpenWrt 23.05，插件版本读不出来。

开始前准备

- 路由器已刷好 OpenWrt 固件，系统版本不低于 21.02，内存至少 256MB
- 机场提供节点订阅链接，格式是 V2Ray 或通用节点订阅，没选好机场可以先看[机场榜单](/jichang-tuijian/)
- SSH 连上路由器，执行一次 `opkg --version` 或 `apk --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](/glossary/#xray)。

### 第 3 步 在便捷导入区复制订阅

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

### 第 4 步 也可以用一键订阅菜单

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

### 第 5 步 点节点订阅再点添加

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

### 第 6 步 填订阅信息并保存应用

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

### 第 7 步 在节点列表里选节点

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

### 第 8 步 开启路由器本机代理

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

### 路由器 上常见的问题

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

先去 SSH 里执行 `logread | grep passwall2` 看有没有报错。或者在插件的其他设置里打开调试日志，再看 /tmp/log/passwall2.log 的内容，常见原因是选的内核对应的依赖没装全，比如选了 Xray 节点但 xray-core 没装上。

**装的时候提示缺少依赖，或者装完用不了**

多半是 ipk 和 apk 混装了，或者对应的内核软件包没有一起装。先确认固件是 opkg 还是 apk 管理，两种不能混用。缺 xray-core、[sing-box](/glossary/#sing-box) 这类内核包时，要按 README 的说明把 PassWall 的软件源加进去再重新安装。

**订阅导入进来了，但节点列表里 Ping 和 TCPing 一直测不出数据**

先点这个节点后面的测试链接单独测一次。如果所有节点都测不出来，通常是节点使用类型选错了内核，回节点订阅页把 VMess、VLESS 这些协议对应的使用类型改成节点真实支持的那个。

**装完中文语言包，界面还是英文**

装完语言包要在 LuCI 顶部的系统里找语言设置，把界面语言切成中文，装包本身不会自动切换，刷新一次页面，PassWall 2 的菜单和页面文字才会跟着变。

## 常见问题

### 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 的软件源加进去再装。
