使用教程 · PassWall 教程
PassWall 教程 2026:OpenWrt 安装、订阅导入与分流规则设置
机场V 编辑部 · 更新于
PassWall 教程:先说结论
结论:PassWall 是 OpenWrt 上另一款常用的代理插件,界面简洁、按“节点”组织,非常适合使用通用订阅的机场用户。基本流程是:在 OpenWrt 上安装 PassWall 及其依赖(Xray、sing-box 等核心组件按需安装) → 在“节点订阅”中添加机场的通用订阅并手动订阅一次 → 在“基本设置”中选择 TCP 主节点、UDP 节点 → 代理模式选“中国列表以外”或类似的绕过大陆模式 → 勾选主开关并保存应用。之后再按需配置分流、DNS 和访问控制。如果你的机场主推 Clash 订阅、需要复杂策略组,OpenClash 教程会更合适。
一、PassWall 的特点与适用场景
PassWall 的设计思路与 OpenClash 不同。OpenClash 以“配置文件”为中心,直接运行机场给的 Clash 配置;PassWall 则以“节点”为中心,把订阅解析成一个个节点,然后由你在界面上选择用哪个节点、分流怎么走。两者各有所长:
| 对比项 | PassWall | OpenClash |
|---|---|---|
| 订阅格式 | 通用订阅(节点链接列表) | Clash YAML 配置 |
| 核心组件 | Xray、sing-box 等按需选择 | Clash Meta 内核 |
| 分流方式 | 代理模式 + 分流节点(Shunt) | 机场配置中的规则与策略组 |
| 界面 | 简洁、以节点为中心 | 选项多、以配置为中心 |
| 资源占用 | 相对较低 | 中等 |
| 适合人群 | 使用通用订阅、想要简单稳定的用户 | 依赖机场预设分流、喜欢面板操作的用户 |
PassWall 还有一个衍生版本 PassWall 2,界面与功能有所调整,整体思路一致,本 PassWall 教程以通用思路讲解,菜单名称可能与你的版本略有差异。
二、安装前的准备
- 硬件:x86 小主机或性能不错的 ARM 设备,内存与存储越充裕越好,核心组件和规则文件都会占用空间。
- 系统:官方 OpenWrt 或可信的基于官方的固件,确认固件版本和 CPU 架构。
- 网络结构:主路由或旁路由都可以,新手建议旁路由,出问题容易回退。
- 订阅:机场的通用订阅链接。还没有机场的话可以先看机场推荐,软路由场景推荐流量大、不限设备数的套餐,参考不限设备机场。
三、安装 PassWall 与核心组件
PassWall 是开源项目,安装包与依赖通常通过其官方 GitHub 项目或官方提供的软件源发布。只使用官方渠道,不要下载来路不明的“整合包”。
- 登录 OpenWrt 管理界面,在“系统 → 软件包”中更新软件列表。
- 按 PassWall 官方说明添加其软件源,或从官方 Releases 下载与路由器架构、OpenWrt 版本匹配的安装包。
- 安装 PassWall 主程序及其依赖。注意不同 OpenWrt 版本使用的防火墙框架不同,需选择对应依赖。
- 安装核心组件:常用的是 Xray,用于 VMess、VLESS、Trojan 等协议;如果机场使用 Hysteria2、TUIC 等较新协议,还需要安装 sing-box 或对应组件。
- 安装完成后刷新页面,在“服务”菜单中出现 PassWall 即表示成功。
- 进入 PassWall 的“组件更新”或“规则管理”页面,更新 GeoIP、GeoSite 等规则数据。
很多第三方固件已经集成了 PassWall,此时只需检查组件版本是否较新,旧版本核心可能无法识别新协议的节点。
四、添加订阅:PassWall 教程的核心步骤
- 在机场用户中心复制通用订阅链接(有时标注为 V2Ray 订阅或 Base64 订阅)。
- 进入 PassWall,打开“节点订阅”页面。
- 点击添加,填写备注(如机场名称),粘贴订阅地址。
- 可以设置订阅的过滤关键字,例如排除名称中含“到期”“剩余流量”的信息节点。
- 保存后点击“手动订阅”,等待节点导入完成。
- 打开“节点列表”页面,可以看到所有节点,点击 Ping 或 TCPing 测试连通性。
- 开启自动订阅,设定每天更新一次,避免机场换节点后旧节点失效。
如果订阅失败,先确认路由器本身可以访问订阅地址,必要时先手动添加一个可用节点让代理生效,再进行订阅,相关思路见订阅更新失败。
五、基本设置:选节点、选模式、启动
- 进入“基本设置”页面。
- “TCP 节点”选择一个测试正常的节点,这是主力节点。
- “UDP 节点”可以选择“与 TCP 节点相同”,如果节点不支持 UDP 或你不需要 UDP 代理,也可以关闭。
- “TCP 代理模式”选择“中国列表以外”或“绕过中国大陆 IP”,即国内直连、海外走代理。
- “UDP 代理模式”一般同样选择绕过大陆,游戏用户可按需调整。
- DNS 相关设置先保持默认。
- 勾选页面顶部的“主开关”,点击“保存并应用”。
- 状态区域显示 TCP 和 UDP 运行中、连接正常后,在局域网设备上分别测试国内外网站。
代理模式的选择原则与客户端一致:日常绕过大陆,仅在排查时全局代理。原理可参考代理模式详解。
六、分流:让不同服务走不同节点
PassWall 支持一种特殊的“分流”类型节点(Shunt),可以把多个节点组合起来,根据规则把不同服务分配到不同节点。比如 AI 服务走美国节点、流媒体走新加坡节点、其他海外流量走香港节点。
- 在“节点列表”中添加一个新节点,类型选择“分流”。
- 在分流规则列表中,为各类规则(如 AI、流媒体、电报等,具体以版本内置规则为准)分别选择对应节点。
- 为“默认”选择一个节点,用于未匹配规则的海外流量。
- 保存后,回到“基本设置”,把 TCP 节点设为这个分流节点。
- 保存并应用,在设备上分别测试各类服务的出口地区。
如果内置规则不够用,可以在“规则管理”中添加自定义域名规则。选节点时可以参考各地区特点:香港节点机场延迟低,美国节点机场对 AI 服务友好。使用 AI 工具遇到地区限制的情况,可以参考ChatGPT 不支持所在国家。
七、DNS 与访问控制
1. DNS 设置
DNS 是 PassWall 分流正确与否的关键。总体原则是:国内域名用国内 DNS 直连解析,海外域名通过代理用海外 DNS 解析,避免污染和泄漏。PassWall 提供了多种 DNS 分流方式,新手保持默认即可;遇到国内网站解析到海外、海外网站解析错误等问题时,再检查 DNS 分流方式与远程 DNS 设置。同时确保局域网设备没有手动设置其他 DNS,否则可能绕过 PassWall。
2. 访问控制
在“访问控制”页面可以按设备 IP 或 MAC 设置代理策略,例如:NAS、下载机全部直连;孩子的平板只代理特定内容;电视走流媒体节点。新手建议先不做复杂设置,等全局运行稳定后再细化。
3. IPv6
如果宽带启用了 IPv6,而 PassWall 只代理 IPv4,部分流量会通过 IPv6 直连,导致分流失效或地区识别错误。不熟悉 IPv6 配置时,可以先关闭局域网 IPv6 下发。
旁路由部署时的注意事项
如果 PassWall 运行在旁路由上,需要额外完成几步:给旁路由设置与主路由同网段的固定 IP,网关和 DNS 指向主路由;关闭旁路由自身的 DHCP,避免与主路由争抢分配地址;然后要么在主路由的 DHCP 中把下发的网关和 DNS 改成旁路由 IP,要么只在需要代理的设备上手动修改网关和 DNS。新手推荐后者,先拿一台电脑或电视测试,一切正常再考虑全家推广。
旁路由模式下如果出现“能访问海外但国内网站打不开”或“部分设备完全上不了网”,通常与防火墙转发或 IP 动态伪装设置有关,可以在旁路由的防火墙区域设置中检查相关选项。需要注意的是,旁路由一旦关机或重启,以它为网关的设备都会断网,所以重要设备最好保留一个快速切回主路由的方法,例如记住原来的网关地址。
另外,不要在同一台路由器上同时启用 PassWall 和 OpenClash,两者都会接管 DNS 和防火墙规则,同时运行会互相冲突,导致断网或分流异常。若想对比两者,先完全停用其中一个再启用另一个。
八、故障转移与日常维护
PassWall 提供了自动切换(故障转移)功能:在设置中启用后,当主节点连续多次检测失败,会自动切换到备用节点列表中的下一个节点。建议添加两到三个不同地区的备用节点,保证家里网络不会因为单个节点故障而中断。日常维护方面:
- 每天自动更新订阅和规则数据。
- 定期查看运行日志,留意是否有频繁的连接失败。
- 核心组件(Xray、sing-box)定期更新,以支持新协议与修复问题,但更新前最好确认与当前 PassWall 版本兼容。
- 升级固件前备份 PassWall 配置。
九、PassWall 教程常见问题排查
| 现象 | 可能原因 | 解决方法 |
|---|---|---|
| 订阅后没有节点 | 复制了 Clash 订阅、链接错误或路由器无法访问 | 使用通用订阅,检查路由器网络 |
| 部分节点无法使用 | 缺少对应协议的核心组件 | 安装或更新 Xray、sing-box 等组件 |
| 主开关打开后状态不运行 | 依赖缺失或配置冲突 | 查看日志,补齐依赖,确认防火墙框架匹配 |
| 能 Ping 通但打不开网页 | Ping 只测服务器可达性,不代表协议可用 | 换节点,以实际访问结果为准 |
| 国内网站变慢 | 代理模式设成全局或 DNS 走了海外 | 改为绕过大陆,检查 DNS 分流 |
| 某设备不走代理 | 设备自定义 DNS、IPv6 或被访问控制排除 | 检查设备设置和访问控制列表 |
| 游戏或语音不通 | UDP 未代理或节点不支持 UDP | 开启 UDP 代理并选择支持 UDP 的节点 |
节点普遍超时可看节点超时怎么办,国内访问变慢的系统性分析可看国内网站变慢。
十、小结
这篇 PassWall 教程的主线是:官方渠道安装插件与核心组件 → 用通用订阅导入节点 → 基本设置中选 TCP、UDP 节点与绕过大陆模式 → 需要时用分流节点按服务分配出口 → 做好 DNS、IPv6 和故障转移。PassWall 胜在简洁、资源占用低,对使用通用订阅的机场非常友好;如果你依赖机场的 Clash 策略组,OpenClash 会更顺手。软路由让全家共享一份订阅,选机场时要重视流量额度和稳定性,可以参考机场排行榜和高性价比机场。