PassWall 与 PassWall2 安装教程：官方地址已迁移，ipk 与 apk 怎么选
拾沙 · 首发于 · 更新于
30 秒结论：PassWall 和 PassWall2 是 OpenWrt 路由器上常用的 LuCI 代理插件，可以让家里所有设备都走代理。需要特别注意，官方仓库已经迁移到 GitHub 的 Openwrt-Passwall 组织下，很多老教程里的旧地址已经失效。本站核实时，PassWall 最新版是 2026-10-16 发布的 26.10.16-2，PassWall2 最新版是 2026-10-02 发布的 26.10.1-2。OpenWrt 25.12 及以后的版本装 apk 包，更早的版本装 ipk 包；中文界面需要另装 zh-cn 语言包。
| 软件 | PassWall / PassWall2 |
|---|---|
| 平台 | OpenWrt 路由器 |
| 内核 | Xray、sing-box 等 |
| 最新版本 | PassWall 26.10.16-2 / PassWall2 26.10.1-2（发布于 ） |
| 状态 | 维护中 |
| 价格 | 免费 |
| 开源协议 | GPL-3.0 |
| 官方地址 | github.com/Openwrt-Passwall |
| 官方下载 | github.com/Openwrt-Passwall/openwrt-passwall/releases |
版本与地址本站核实于 ，只列官方渠道，请勿从搜索结果里的同名站下载。
PassWall 是 OpenWrt 路由器上历史很长的代理插件，后来又推出了 PassWall2。它们能让连接路由器的所有设备走代理，电视、游戏机都不用单独装软件。最近一个容易让人踩坑的变化是：官方仓库搬家了。按照老教程去找下载地址，很可能会发现页面已经不存在。这篇教程给出新的官方地址，并讲清楚安装和使用的要点。
官方地址已经迁移
PassWall 和 PassWall2 的官方仓库，现在位于 GitHub 的 Openwrt-Passwall 组织下，分别是 openwrt-passwall 和 openwrt-passwall2 两个仓库（地址见上方软件信息卡和文末参考资料）。很多老教程里写的旧仓库地址，本站核实时已经无法访问。
迁移之后，网上也出现了不少打着「PassWall 官网」「PassWall 下载站」旗号的网站，提供的安装包来源不明。路由器上的插件会处理全家的流量，一定只从官方 GitHub 仓库下载。
PassWall 还是 PassWall2
两者由同一个组织维护，是两个独立的软件包，分别发布、分别安装。PassWall2 是后来推出的版本，界面和分流设置的组织方式与 PassWall 不同。
怎么选？新装的话任选其一即可：看到的教程是哪个版本的，就装哪个，照着操作最省事。唯一要注意的是不要两个同时安装和启用，它们会争抢同样的网络设置。
本站核实时的最新版本：PassWall 是 2026-10-16 发布的 26.10.16-2，PassWall2 是 2026-10-02 发布的 26.10.1-2。
安装包怎么选
按 OpenWrt 版本选格式
PassWall 的发布页按 OpenWrt 版本给出了不同的安装包：
22.03 及更早：ipk 格式。
23.05 到 24.10：ipk 格式。
25.12 及以后：apk 格式。
PassWall2 的说明同理：使用 opkg 包管理器的系统装 ipk，使用 apk 包管理器的系统装 apk。不确定的话，在路由器命令行里分别输入 opkg 和 apk，看哪个命令存在。
别忘了语言包
主程序默认是英文界面。想要中文界面，还要下载文件名带 luci-i18n 和 zh-cn 的语言包，格式和主程序保持一致。
安装步骤
以 PassWall2 官方说明为例：
opkg 系统（ipk）：把下载好的 ipk 上传到路由器，先执行 opkg update 更新软件源，再用 opkg install 安装主程序和语言包。
apk 系统（apk）：把 apk 包上传到路由器，用 apk add --allow-untrusted 加上文件名进行安装。
也可以在 LuCI 网页后台的「系统 → 软件包」页面上传安装，但缺依赖时容易失败，命令行更可靠。
缺少依赖怎么办
PassWall 需要 Xray、sing-box 等内核和若干组件。PassWall2 的说明提到，如果安装时因为缺少 xray-core 等依赖而失败，需要把 PassWall 的软件源添加到 /etc/opkg/customfeeds.conf。另外，PassWall2 的发布页提供了按路由器架构打包好的依赖压缩包（文件名形如 packages_ipk_aarch64_generic.zip），选对自己路由器的架构，下载后手动安装即可。
第一次使用：导入订阅
- 安装完成后刷新 LuCI 后台，在「服务」菜单里找到 PassWall 或 PassWall2。
- 进入节点订阅页面，添加订阅：备注随意填写，把机场的订阅链接粘贴进去，保存后执行订阅更新。PassWall 系列使用的是通用订阅，复制机场提供的 v2ray 通用订阅链接即可。
- 订阅成功后，节点列表里会出现机场的节点。
- 回到基本设置，打开主开关，选择要使用的节点，保存并应用。
启动后，连接路由器的设备就会按规则分流：国内网站直连，境外网站走代理。
备份与更新
PassWall 的设置保存在路由器的配置文件里。更新插件前，建议先在 LuCI 的「系统 → 备份/升级」里生成一份完整备份，万一新版本有问题可以恢复。更新时下载同一种格式的新版安装包覆盖安装，语言包也要一起更新。
常见问题排查
装好后菜单里看不到插件：刷新页面或重新登录 LuCI；仍然没有，检查安装时是否报错，多半是依赖没装全。
订阅更新失败：确认订阅链接完整；路由器本身能否访问订阅地址也很关键，订阅地址被拦截时，可以先手动添加一个能用的节点，再更新订阅。
某类节点无法使用：确认对应的内核已经安装，例如 Hysteria2 等协议需要支持它的内核。
国内网站变慢：检查 DNS 设置和分流模式，确保国内域名用国内 DNS 解析、国内网站走直连。
下载与使用时的安全提醒
只从 Openwrt-Passwall 组织的官方仓库下载，不要使用来源不明的整合固件或修改版插件。订阅链接相当于账号凭证，不要发到公开场合；怀疑泄露时，到机场后台重置订阅地址。
和其他方案怎么选
同样在 OpenWrt 上，OpenClash 使用 mihomo 内核和 Clash 订阅，适合习惯 Clash 规则的人。只在自己的电脑或手机上用的话，直接装 v2rayN 或 sing-box 官方客户端 更简单。
常见问题
PassWall 和 PassWall2 有什么区别？
两者由同一个 GitHub 组织维护，都是 OpenWrt 上的代理插件，是两个独立的软件包，分别发布、分别安装。PassWall2 是后来推出的版本，界面和分流设置的组织方式与 PassWall 不同。新装可以任选其一，不要两个同时安装和启用。
老教程里的下载地址打不开了怎么办？
官方仓库已经迁移到 GitHub 的 Openwrt-Passwall 组织下。老教程里的旧仓库地址已经失效，请改用本文给出的新地址下载。
应该下载 ipk 还是 apk？
看 OpenWrt 的版本和包管理器。PassWall 的发布页按版本区分：22.03 及更早、23.05 到 24.10 用 ipk 包；25.12 及以后用 apk 包。PassWall2 的说明同样是 opkg 系统装 ipk、apk 系统装 apk。
安装后界面是英文怎么办？
中文界面需要另外安装语言包，也就是文件名带 luci-i18n 和 zh-cn 的那个包，和主程序装同一种格式。
安装提示缺少 xray-core 等依赖怎么办？
PassWall2 的说明提到，缺少 xray-core 等依赖时，需要把 PassWall 的软件源添加到 /etc/opkg/customfeeds.conf。PassWall2 的发布页也提供按路由器架构打包好的依赖压缩包，可以下载后手动安装。
参考资料
本文的结论以下列官方文档、规范或资料为准：