26.10.22-2 · 10 月 22 日 发布 · 核验于 10 月 26 日

PassWall 下载:最新版官方下载与安装说明

OpenWrt 上老牌的通用代理插件,适合机场提供通用订阅时使用。

26.10.22-2最新版本
内核
Xray / sing-box
价格
免费开源
开源协议
GPL-3.0
订阅格式
通用
GitHub Releases 官方下载 ↗

PassWall 是什么

OpenWrt 上老牌的通用代理插件,适合机场提供通用订阅时使用。

sing-box 是新一代通用代理内核,协议支持最全,性能好,配置是 JSON 格式;多数机场提供 sing-box 订阅或可以订阅转换。

支持平台路由器
内核Xray / sing-box
价格免费开源
开源协议GPL-3.0
订阅格式通用
最新版本26.10.22-2(2026 年 10 月 22 日 发布,2026 年 10 月 26 日 核验)

PassWall 安装步骤

PassWall 下载和安装方式

PassWall 现在由 Openwrt-Passwall 组织维护(仓库 openwrt-passwall),官方给了两种安装途径:

  1. 添加软件源后安装(推荐)。按 openwrt-passwall-build 仓库的说明,把它提供的软件源加进路由器,再用包管理器安装 luci-app-passwall,依赖会一起装上,以后升级也方便。
  2. 手动下载预编译包。从官方给出的 SourceForge 页面按路由器架构下载,上传到路由器后安装。ipk 包用 opkg install,apk 包用 apk add。

选包格式前先看 OpenWrt 版本:较早的版本用 opkg 和 ipk,新版本改用 apk。新版本手动安装时可能遇到签名不受信任的报错,加跳过校验的参数可以装上,但这等于不验证安装包来源,只对从官方渠道下载的包这样做。

PassWall 需要 dnsmasq-full 替换系统自带的 dnsmasq,第三方教程里换装 dnsmasq 这一步最容易出错导致断网,操作前确认能通过网线进入路由器后台。

不确定路由器 CPU 架构时,在 OpenWrt 后台的系统概况里能看到架构名称,下载预编译包时对照选择;架构选错的包装不上或运行报错。

PassWall 的特点

PassWall 是 OpenWrt 上历史很久的代理插件,底层调用 Xray、sing-box 等内核,主要读取通用订阅(vmess://、vless://、trojan:// 等链接),机场只给通用订阅时比 Clash 系插件更直接。它的界面按「节点列表、订阅、规则、访问控制」组织:

  • 可以分别给 TCP 和 UDP 指定节点;
  • 访问控制里能按设备决定是否走代理;
  • 规则里可以设置国内直连、按域名走特定节点;
  • 支持故障自动切换节点。

机场订阅里常混有「剩余流量」「到期时间」之类的提示节点,PassWall 的订阅设置里可以按关键字过滤节点,把这些无法连接的条目剔除,节点列表会清爽很多。

PassWall、PassWall 2、OpenClash 怎么选

插件订阅适合
PassWall通用习惯老界面、教程资料多
PassWall 2通用想按网站灵活分流到不同节点
OpenClashClash机场主推 Clash 订阅、想用机场写好的规则

路由器的准备工作(固件、性能、进入后台)和 OpenClash 相同,见 OpenClash 教程前半部分。

PassWall 的安装包文件怎么挑

手动安装 PassWall 时,同一个版本会有好几个文件,按下面的思路挑:

  • 主程序和语言包分开。luci-app-passwall 是插件本体,luci-i18n-passwall-zh-cn 是简体中文语言包,不装语言包界面就是英文。
  • 按 OpenWrt 版本选。部分发布会按 OpenWrt / LuCI 的版本分开打包,文件名前面标着适用的版本,选和路由器固件一致的那一份。
  • 插件本体不分架构,依赖分。文件名里的 all 表示插件本身通用;Xray、sing-box 等核心依赖要按路由器的软件包架构下载,在路由器上执行 opkg print-architecture 可以查到,例如 aarch64_cortex-a53、x86_64。
  • ipk 还是 apk。旧版 OpenWrt 用 ipk 和 opkg,新版用 apk,两种格式不要混装。

网上有不少「OpenWrt 软件包中心」之类的第三方站点重新打包分发 PassWall,文件名改过、版本对不上时很难排查。下载认准 Openwrt-Passwall 组织的仓库和官方给出的 SourceForge 页面。

PassWall 装好后常见问题对照

PassWall 的问题大多出在订阅、DNS 和端口三处。遇到异常先对照下表定位,不要一上来就重装插件:

现象常见原因处理办法
软件包里搜不到 passwall官方软件源没加,或加的源和固件版本不匹配按 openwrt-passwall-build 的说明重新添加软件源,更新列表后再搜
主开关打开后状态一直显示未运行没选主节点、核心依赖缺失,或端口被占用先确认已选节点;查看插件日志里的报错,缺 Xray / sing-box 就补装
订阅导入后节点比电脑上少订阅里有 PassWall 不支持的协议,或被关键字过滤掉了检查订阅设置里的过滤关键字;确认机场给的是通用订阅
开了之后国内网站反而变慢DNS 分流没生效,国内域名也走了远程解析检查 DNS 相关设置里国内、国外解析是否分开;更新中国域名和 IP 列表
节点测试全部失败路由器时间不准、订阅过期,或节点协议参数不全同步路由器时间;回机场后台看到期和流量;见节点超时排查
和 OpenClash 同时装后都不正常两个插件抢 DNS 和防火墙规则只保留一个启用,另一个关掉主开关或卸载

手动添加单个节点时,最容易漏的是传输方式、TLS 和 SNI 这类字段,漏填后节点能保存但连不上。机场提供订阅时尽量用订阅导入,比手填省事也少出错。

PassWall 日常维护:订阅、规则和插件更新

PassWall 装好能用之后,还有几件事要定期做,否则过一段时间会出现节点失效、分流不准:

  1. 订阅自动更新。在订阅设置里找到自动更新相关选项,设一个每天固定时间更新,机场换节点后路由器能自动跟上。
  2. 规则列表更新。分流依赖的国内域名、IP 列表也需要更新,在规则相关页面可以手动或定时更新。列表太旧时,新出现的国内网站可能被当成国外流量。
  3. 插件和核心分开升级。PassWall 插件本身和 Xray、sing-box 等核心是分开的包,升级插件后顺手检查核心版本,新协议节点要较新的核心才能用。
  4. 升级前备份配置。在 OpenWrt 后台的备份功能里导出一份配置,升级出问题时可以恢复。

本页的选项名称按通用说法描述,不同版本界面略有差异,以插件里实际显示为准。

下载哪个文件

设备选择
路由器(OpenWrt)按路由器架构选插件包

官方地址:https://github.com/Openwrt-Passwall/openwrt-passwall/releases/latest

装好以后三步用上

  1. 复制订阅链接:在机场用户中心复制通用格式的订阅地址。
  2. 导入 PassWall:打开「订阅」或「配置」页,新建一项,粘贴后更新。
  3. 选节点、开代理:节点旁出现延迟数字就说明导入成功,选一个节点,打开系统代理或连接开关。

导入失败看订阅更新失败,节点全红看节点超时排查。

PassWall 常见问题排查

现象常见原因怎么解决
导入订阅失败链接复制不全、订阅格式不对、机场域名被墙重新复制完整链接;确认是 通用 格式;见订阅更新失败
节点全部超时订阅过期、流量用完、系统时间不准机场后台看到期和流量;同步系统时间;见节点超时排查
能连上但打不开网页代理模式不对、DNS 问题切到规则模式,重启客户端;见规则与全局模式
国内网站变慢用了全局模式改成规则模式,国内直连
游戏 / 部分 App 不走代理只开了系统代理开启 TUN 模式

PassWall 和同类客户端对比

客户端平台内核价格订阅
PassWall(本页)路由器Xray / sing-box免费开源通用
OpenClash路由器mihomo免费开源Clash
PassWall 2路由器Xray / sing-box免费开源通用
Nikki路由器mihomo免费开源Clash
ShellCrash路由器 · Linuxmihomo / sing-box免费开源Clash

PassWall 用哪家机场

PassWall 本身不带节点,需要导入机场订阅。下面是本期编辑综合分前 8 的机场,都提供 通用 或通用订阅;完整推荐见机场推荐,便宜的看便宜机场;还没有机场、想先不花钱试一下,看免费机场推荐(可免费试用或 1 元体验的正规机场)。

#机场线路月付起流量每 GBAI流媒体评分状态
1 WgetCloud IEPL / IPLC 专线 + BGP 中转 ¥79 按套餐,入门档约 100GB 级 — ✓✓ 9.5 推荐
2 飞鸟云 内网专线 IPLC ¥25 150GB / 月 ¥0.17 ✓✓ 9.3 推荐
3 TAG IEPL 专线 ¥114 500GB / 月 ¥0.23 ✓✓ 9.3 推荐
4 泡芙云 全专线 IPLC / IEPL ¥18 120GB / 月 ¥0.15 ✓✓ 9.2 推荐
5 二猫云主推 三网优化 IEPL + 中转混合 ¥20 60GB – 130GB / 月 ¥0.15 ✓✓ 9.2 推荐
6 灵云 IEPL 纯专线 ¥22 120GB / 月 ¥0.18 ✓✓ 9.2 推荐
7 天机阁 内网专线 + 专职技术运维 ¥26 160GB / 月 ¥0.16 ✓✓ 9.2 推荐
8 闪电猫 企业级 IPLC 专线 ¥30 200GB / 月 ¥0.15 ✓✓ 9.2 推荐

点表头可排序。价格、流量和每 GB 按官网核对于 2026 年 10 月 24 日;AI / 流媒体为官网标注(✓ 标注支持,△ 部分或需自测,✗ 未标注)。

常见问题

PassWall 收费吗?

免费开源。从官方 GitHub 下载即可,不需要付费。

PassWall 自带节点吗?

不带。PassWall 只是连接工具,需要导入机场的通用订阅才能使用,挑机场看机场推荐。

PassWall 最新版本是多少?

截至 2026 年 10 月 26 日,最新版本是 26.10.22-2,发布于 2026 年 10 月 22 日。

PassWall 怎么导入机场订阅?

在机场后台复制通用订阅链接,打开 PassWall 的订阅 / 配置页新建一项,粘贴链接后更新,出现节点列表就成功了。

PassWall 连不上怎么办?

先更新订阅、换节点、检查系统时间;再确认机场订阅没过期、流量没用完。详见节点超时排查。

PassWall 安全吗?

开源客户端代码公开,只要从官方渠道下载就是安全的。风险主要来自来路不明的修改版,以及把订阅链接泄露给别人,见订阅安全。

PassWall 和 OpenClash 哪个好?

PassWall:Xray / sing-box 内核,免费开源;OpenClash:mihomo 内核,免费开源。两者都能导入机场订阅,看你习惯哪个界面,对比表见本页「同类客户端对比」。

从哪里下载 PassWall 最安全?

只从 GitHub Releases 官方页面下载。网盘、群文件里的「汉化版」「破解版」可能被植入恶意代码。

更多问题见机场问答库:选机场、客户端、连不上、ChatGPT 和流媒体的常见问题都在这里。

同类客户端

OpenClashv0.48.002

mihomo · 免费开源

PassWall 226.10.20-1

Xray / sing-box · 免费开源

NikkiOpenWrt-nikkiv1.26.2

mihomo · 免费开源

mihomo / sing-box · 免费开源

← 返回梯子下载(全部 29 个客户端)