PassWall2和PassWall区别：ipk下载安装与设置教程

30 秒结论：PassWall 是 OpenWrt 路由器上的翻墙插件，免费开源，有 PassWall（1 代） 和 PassWall2 两个版本，都在 GitHub 的 Openwrt-Passwall 组织下发布，原来的 xiaorouji 地址已经打不开。四件事先说清：新手装 PassWall2，界面简单；OpenWrt 24.10 及以前和 iStoreOS 装 ipk，25.12 起装 apk（是路由器包，不是安卓 App）；插件本体不分 CPU，依赖包要按路由器架构装；iStoreOS 商店里没有，要手动装。GitHub 打不开的话，下面镜像了两个版本的全部 42 个文件。

PassWall 是什么

PassWall 是一个 LuCI 插件：装好后出现在路由器网页后台的「服务」菜单里。它调用 Xray、sing-box 等内核，把局域网所有设备的流量按规则分流——国内网站直连，国外网站走机场节点。家里的电视、游戏机、手机都不用单独装客户端。

适合：x86 软路由、R2S/R4S 这类 ARM 盒子、刷了 OpenWrt / ImmortalWrt / iStoreOS 的路由器。

装不了：运营商光猫、没刷机的小米/华为/TP-Link 原厂路由器。这些直接在手机电脑上装客户端更省事。

PassWall2 和 PassWall 区别

两个都还在更新，不是新版取代旧版的关系。PassWall2 是 2022 年另开的仓库，思路是「能交给内核的都交给内核」。

怎么选：

• 新手、只想导订阅能用：装 PassWall2。设置项少，依赖包 Release 里直接给好
• 要用 Hysteria2 原版核心、NaiveProxy，或者想精细调 DNS：装 PassWall
• 两个可以同时装，但建议只开一个，两套都会改防火墙和 DNS，同时开容易互相干扰

PassWall2 里没有单独的 Hysteria2 节点类型，不代表不能用 Hysteria2：Xray 和 Sing-Box 节点都支持这个协议。只有 AnyTLS 要注意——PassWall2 里只有 Sing-Box 节点类型支持它，导入后发现连不上，把节点类型改成 Sing-Box。

PassWall 官网和 GitHub 是哪个？

PassWall 没有独立官网，官方就是 GitHub 上的 Openwrt-Passwall 组织，三个仓库：

• 原作者 xiaorouji 的旧地址已经失效：github.com/xiaorouji/openwrt-passwall 现在返回 404，网上 2024 年以前的教程大多还写着这个地址，照着复制会下载失败
• openwrt-passwall-build（作者 moetayuko）：PassWall 1 代 Release 页里官方指向的二进制分发仓库，用 OpenWrt 官方 SDK 编译，提供 opkg/apk 软件源和 SourceForge 下载，想用软件源一键安装、自动更新的看它

PassWall 下载（ipk / apk）

先确认固件用 ipk 还是 apk

SSH 登录路由器，输入 opkg --version，能出版本号就是 ipk；输入 apk --version 能出版本号就是 apk。

这里的 apk 是 OpenWrt 新的路由器安装包格式，和安卓手机的 apk 同名但不是一回事，手机装不了。PassWall 没有安卓版。

PassWall2 安装包（推荐）

最新 26.10.1-2（2026-10-02）。插件本体是 all 架构，所有 CPU 通用。要中文界面，插件和简体中文包都要装。

Release 里还有繁体中文（zh-tw）、俄语、波斯语语言包，本站也镜像了，见文末校验表。

PassWall2 依赖包（按 CPU 架构选）

PassWall2 的 Release 里按 13 种 CPU 架构打包了依赖（chinadns-ng、geoview、shadowsocks-rust、v2ray-plugin、GeoIP/GeoSite 数据等），每个约 24MB。只下和你路由器对应的那一个：

不知道架构：SSH 里输入 cat /etc/openwrt_release，看 DISTRIB_ARCH 那一行。

⚠️ xray-core 和 sing-box 不在 zip 里（本站 2026-10-15 解开 x86_64 包核对过，里面 12 个文件没有这两个），要另装，见下面安装教程。

PassWall 1 代安装包

最新 26.10.4-1（2026-10-04）。1 代 按固件版本分了三套，文件名开头就是适用版本，下错了装不上：

1 代的 Release 不附依赖包，官方说明让去 openwrt-passwall-build 添加软件源，或从它的 SourceForge 手动下载。两者的依赖包来自同一个 openwrt-passwall-packages 仓库，上面 PassWall2 的依赖 zip 1 代也能用；1 代默认还会用到 haproxy、ipt2socks 等，缺什么从固件软件源装。

PassWall2 安装教程

方法一：网页上传（适合新手）

1. 在上面的表里下载三样东西：插件 luci-app-passwall2、简体中文包 luci-i18n-passwall2-zh-cn、你架构的依赖包 zip
2. 在电脑上把 zip 解压，得到十几个 ipk（或 apk）
3. 登录路由器后台，进 「系统」→「软件包」，先点 「更新列表」
4. 用 「上传软件包」 先装依赖包，再装插件和中文包
5. 在「软件包」里搜索并安装 xray-core 和 sing-box（至少装一个）
6. 刷新页面，「服务」 菜单里出现 PassWall 2 就是装好了

方法二：命令行（README 原版）

把文件传到路由器 /tmp 后执行。opkg 固件：

opkg update
opkg install /tmp/*.ipk
opkg install xray-core sing-box
/etc/init.d/rpcd restart

apk 固件（OpenWrt 25.12 起）：

apk update
apk add --allow-untrusted /tmp/*.apk
apk add xray-core sing-box
/etc/init.d/rpcd restart

--allow-untrusted 会跳过签名校验，README 里专门提醒过。只装你从 GitHub 或本站镜像下载、对过 SHA256 的包。

固件软件源里的 xray-core 太旧怎么办

OpenWrt 官方软件源的版本更新慢：2026-10-15 查询时，OpenWrt 24.10 源里的 xray-core 是 25.1.30、sing-box 是 1.12.22，而 PassWall2 当前版本配套的是 xray-core 26.9.30、sing-box 1.14.2。内核太旧会出现新协议节点连不上。两个办法：

• 装好 PassWall2 后进 「组件更新」，在线把 Xray、sing-box 升到最新
• 按 openwrt-passwall-build 的说明添加它的软件源，opkg install xray-core sing-box 会装到新版本

PassWall iStoreOS 怎么装

iStoreOS 官方 iStore 商店里没有 PassWall（本站 2026-10-15 查了 iStore 软件源的 140 个应用，没有 PassWall，也没有 OpenClash），要手动装：

1. iStoreOS 现在维护的分支是 24.10，用 opkg，下载 ipk
2. PassWall 1 代选文件名开头是 23.05-24.10_ 的那套
3. 按设备选依赖包架构：x86 软路由选 x86_64，R2S、R4S、R5S 这类 ARM 盒子选 aarch64_generic
4. 进 「系统」→「软件包」 上传安装，步骤和上面的方法一一样

网上有不少「iStoreOS 一键安装 PassWall」的 run 脚本，来源五花八门，有的会顺带装别的东西。能用官方 ipk 就别用来路不明的脚本。

PassWall 订阅导入教程

下面以 PassWall2 为例，1 代菜单名基本一样。

1. 进 「服务」→「PassWall 2」→「节点订阅」
2. 点 「添加」，「订阅备注（机场）」 填机场名，「订阅网址」 粘贴机场的订阅链接，保存
3. 点 「手动订阅」，等它拉下节点
4. 到 「节点列表」 确认节点已经拉下来
5. 回 「基本设置」，打开 「主开关」，「节点」 选一个节点，点 「保存并应用」

复制哪种订阅链接

• V2Ray 通用订阅（Base64）：一直都支持，最稳
• Clash 订阅：2026 年 5 月起 PassWall 和 PassWall2 都能直接解析，旧版本不认，导入没节点就先升级插件或换通用订阅

订阅里没有节点 / 部分节点没了

• AnyTLS 节点：PassWall2 里要用 Sing-Box 节点类型才能跑，Xray 不支持
• 自签证书的节点：PassWall 官方公告说，2026 年 6 月 1 日起 Xray 不再支持跳过证书验证，机场用自签证书又没给 pcs 参数的节点会连不上。办法是找机场要 pinnedPeerCertSha256，或者换 sing-box 内核
• 订阅更新失败：先关掉主开关再更新，有的机场订阅地址在代理里会被拦

PassWall 设置（新手要动的几项）

装好导完订阅，大部分选项保持默认就能用。值得看一眼的：

让某台设备不走代理（访问控制）

想让电视、NAS 或者某台电脑直连不翻墙：

1. 进 「访问控制」，添加一条规则，「备注」 随便写
2. 「源」 里填那台设备的 IP、MAC 或 IP 段
3. 「节点」 选 「不代理」，保存并应用

这里也能反过来用：给少数几台设备单独建规则、指定和全局不同的节点。

让某个网站或 IP 直连

进 「规则管理」，把域名或 IP 加进 「直连列表」，保存应用。公司内网、银行网站、游戏服务器常用。

PassWall 支持哪些协议

订阅解析代码里认的链接有：SS、SSR、VMess、VLESS、Trojan、Hysteria、Hysteria2、TUIC、AnyTLS、NaiveProxy、Snell，外加 Clash 订阅和 SSD。实际能不能连，要看节点类型背后的内核：

• Xray：VMess、VLESS（含 Reality、XHTTP）、Trojan、SS、Hysteria2
• Sing-Box：上面这些加 TUIC、AnyTLS
• NaiveProxy、Hysteria2 原版核心：只有 PassWall 1 代有独立节点类型

PassWall 免费节点：没有

PassWall 只是工具，不带任何节点。网上的「PassWall 免费节点」多是公开节点或者机场引流，速度慢、几小时就失效，节点主人还能看到经过的流量。全屋设备都走它，更不该用来路不明的节点。

能用 PassWall 的机场

下面两家本站写过，官方客户端清单里都写了 Passwall：

• E-IX：2025 年开站，官方标称 IEPL 专线，月付 45 元 256G 起。它的 OpenWrt 推荐清单是自研客户端、OpenClash、Passwall 三个，官方公告明确说 V2RayN 和 Clash for Windows 原版不兼容，用 PassWall 前先在「组件更新」里把内核升到新版
• 云兔VPN：2023 年起运营，月付 16.8 元 100G 起。节点用 AnyTLS 协议，官方公告写明 PassWall 要把 Xray 更新到新版或改用 sing-box——对应到 PassWall2，就是把节点类型改成 Sing-Box。支付宝和微信付款加收 8% 手续费

两家买之前都先看完本站评测里写的入口和条款。

安装包校验（SHA256）

本站镜像文件从 GitHub Release 原样下载、未做修改，同步于 2026-10-15，SHA256 与 GitHub 页面给出的一致。

繁体中文、俄语、波斯语语言包的镜像地址：把上面 PassWall2 中文包链接里的 zh-cn 换成 zh-tw、ru、fa。

常见问题（FAQ）

区别与下载

PassWall2 和 PassWall 有什么区别？

PassWall2 是 2022 年另开的新版，界面更精简，节点类型只留 Xray、Sing-Box、SS-Rust、SSR 四种，分流规则和 DNS 都交给 Xray 或 sing-box 内核处理。PassWall（1 代）一直在更新，节点类型多 Hysteria2、NaiveProxy、Socks 三种，DNS 分流靠 ChinaDNS-NG 或 SmartDNS，可调的选项更多。两者订阅格式一样，新手用 PassWall2 更简单。

PassWall 的 GitHub 地址是哪个？

PassWall 在 github.com/Openwrt-Passwall/openwrt-passwall，PassWall2 在 github.com/Openwrt-Passwall/openwrt-passwall2，依赖包源码在 openwrt-passwall-packages。原来的 xiaorouji/openwrt-passwall 地址已经打不开，网上旧教程里的链接要换成新组织名。它没有独立官网。

PassWall 下载 ipk 还是 apk？

看固件用哪种包管理器。OpenWrt 24.10 及更早、ImmortalWrt 24.10、iStoreOS 用 opkg，装 ipk；OpenWrt 25.12 起换成了 apk，装 apk。PassWall 1 代的 ipk 还分 22.03 及以前、23.05 到 24.10 两套，文件名开头写着。这里的 apk 是路由器安装包，不是安卓 App。

iStoreOS 能装 PassWall 吗？

能装，但 iStoreOS 官方商店里没有 PassWall，要手动装。iStoreOS 现在维护的版本基于 OpenWrt 24.10，用 opkg，下载 ipk 包，在「系统」→「软件包」上传，或 SSH 里用 opkg install 安装。依赖包按设备 CPU 架构选，常见的 x86 软路由选 x86_64，R2S、R4S 这类 ARM 盒子选 aarch64。

安装与使用

PassWall2 怎么安装？

先在 Release 页下载插件 luci-app-passwall2 和中文包 luci-i18n-passwall2-zh-cn，再按路由器 CPU 架构下载依赖包合集 zip，解压后连同插件一起在「系统」→「软件包」上传安装，或用 opkg install 命令装。xray-core 和 sing-box 不在 zip 里，要从固件软件源（opkg install xray-core sing-box）或 openwrt-passwall-build 软件源装。装完重启 rpcd 或刷新页面，「服务」里就有 PassWall 2。

PassWall 怎么导入订阅？

进「服务」→「PassWall 2」→「节点订阅」，点「添加」，备注填机场名，订阅网址粘贴订阅链接，保存后点「手动订阅」。节点出现在「节点列表」后，回「基本设置」打开主开关、选一个节点，点「保存并应用」。V2Ray 通用订阅和 Clash 订阅都能导，2026 年 5 月以前的旧版本只认通用订阅。

PassWall 连不上节点怎么办？

先看节点协议：AnyTLS 节点只有 sing-box 内核能跑，PassWall2 的 Xray 节点类型不支持 AnyTLS，要把节点类型改成 Sing-Box。再看证书：官方公告说 2026 年 6 月 1 日起 Xray 不再支持跳过证书验证，机场用自签证书又没给 pcs 参数的节点会连不上，换 sing-box 内核即可。最后在「组件更新」里把 Xray、sing-box 更新到最新版。

本文的版本号、下载地址、依赖与菜单名称核实于 2026-10-15（安装方法来自 Openwrt-Passwall 各仓库的 README 与 Release 说明，两个版本的区别对照了各自的 Makefile 依赖与节点类型源码，菜单名来自插件简体中文语言包 passwall.po、passwall2.po，订阅支持的格式来自 subscribe.lua 源码与提交记录，iStore 商店的收录情况来自 iStore 软件源索引，OpenWrt 软件源里的内核版本来自 downloads.openwrt.org）。本站镜像文件从 GitHub Release 原样下载、未做修改。文中机场推荐可能含推广链接，通过链接购买不会增加你的费用，本站可能获得佣金，这不影响内容客观性。代理工具的使用请遵守所在地法律法规。