26.10.22-2 · 10 月 22 日 发布 · 核验于 10 月 26 日
PassWall 下载:最新版官方下载与安装说明
OpenWrt 上老牌的通用代理插件,适合机场提供通用订阅时使用。
PassWall 是什么
OpenWrt 上老牌的通用代理插件,适合机场提供通用订阅时使用。
sing-box 是新一代通用代理内核,协议支持最全,性能好,配置是 JSON 格式;多数机场提供 sing-box 订阅或可以订阅转换。
| 支持平台 | 路由器 |
|---|---|
| 内核 | Xray / sing-box |
| 价格 | 免费开源 |
| 开源协议 | GPL-3.0 |
| 订阅格式 | 通用 |
| 最新版本 | 26.10.22-2(2026 年 10 月 22 日 发布,2026 年 10 月 26 日 核验) |
PassWall 安装步骤
- 路由器:需要刷了 OpenWrt 等系统的路由器,在软件包里安装对应 ipk / apk,或按项目说明脚本安装;装好后在路由器后台导入订阅,全屋设备都能用。
PassWall 下载和安装方式
PassWall 现在由 Openwrt-Passwall 组织维护(仓库 openwrt-passwall),官方给了两种安装途径:
- 添加软件源后安装(推荐)。按 openwrt-passwall-build 仓库的说明,把它提供的软件源加进路由器,再用包管理器安装 luci-app-passwall,依赖会一起装上,以后升级也方便。
- 手动下载预编译包。从官方给出的 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 | 通用 | 想按网站灵活分流到不同节点 |
| OpenClash | Clash | 机场主推 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 装好能用之后,还有几件事要定期做,否则过一段时间会出现节点失效、分流不准:
- 订阅自动更新。在订阅设置里找到自动更新相关选项,设一个每天固定时间更新,机场换节点后路由器能自动跟上。
- 规则列表更新。分流依赖的国内域名、IP 列表也需要更新,在规则相关页面可以手动或定时更新。列表太旧时,新出现的国内网站可能被当成国外流量。
- 插件和核心分开升级。PassWall 插件本身和 Xray、sing-box 等核心是分开的包,升级插件后顺手检查核心版本,新协议节点要较新的核心才能用。
- 升级前备份配置。在 OpenWrt 后台的备份功能里导出一份配置,升级出问题时可以恢复。
本页的选项名称按通用说法描述,不同版本界面略有差异,以插件里实际显示为准。
下载哪个文件
| 设备 | 选择 |
|---|---|
| 路由器(OpenWrt) | 按路由器架构选插件包 |
官方地址:https://github.com/Openwrt-Passwall/openwrt-passwall/releases/latest
装好以后三步用上
- 复制订阅链接:在机场用户中心复制通用格式的订阅地址。
- 导入 PassWall:打开「订阅」或「配置」页,新建一项,粘贴后更新。
- 选节点、开代理:节点旁出现延迟数字就说明导入成功,选一个节点,打开系统代理或连接开关。
PassWall 常见问题排查
| 现象 | 常见原因 | 怎么解决 |
|---|---|---|
| 导入订阅失败 | 链接复制不全、订阅格式不对、机场域名被墙 | 重新复制完整链接;确认是 通用 格式;见订阅更新失败 |
| 节点全部超时 | 订阅过期、流量用完、系统时间不准 | 机场后台看到期和流量;同步系统时间;见节点超时排查 |
| 能连上但打不开网页 | 代理模式不对、DNS 问题 | 切到规则模式,重启客户端;见规则与全局模式 |
| 国内网站变慢 | 用了全局模式 | 改成规则模式,国内直连 |
| 游戏 / 部分 App 不走代理 | 只开了系统代理 | 开启 TUN 模式 |
PassWall 和同类客户端对比
| 客户端 | 平台 | 内核 | 价格 | 订阅 |
|---|---|---|---|---|
| PassWall(本页) | 路由器 | Xray / sing-box | 免费开源 | 通用 |
| OpenClash | 路由器 | mihomo | 免费开源 | Clash |
| PassWall 2 | 路由器 | Xray / sing-box | 免费开源 | 通用 |
| Nikki | 路由器 | mihomo | 免费开源 | Clash |
| ShellCrash | 路由器 · Linux | mihomo / sing-box | 免费开源 | Clash |
PassWall 用哪家机场
PassWall 本身不带节点,需要导入机场订阅。下面是本期编辑综合分前 8 的机场,都提供 通用 或通用订阅;完整推荐见机场推荐,便宜的看便宜机场;还没有机场、想先不花钱试一下,看免费机场推荐(可免费试用或 1 元体验的正规机场)。
| # | 机场 | 线路 | 月付起 | 流量 | 每 GB | AI | 流媒体 | 评分 | 状态 |
|---|---|---|---|---|---|---|---|---|---|
| 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 和流媒体的常见问题都在这里。