PassWall2透明代理怎么设置：OpenWrt完整配置与排错

更新于 2026-11-08 · passwall.lol

简答：PassWall2透明代理的核心顺序是：先确认OpenWrt与软件包环境，再导入订阅或添加节点，选择主节点并开启透明代理，最后用路由器本机和局域网设备分别验证。不要一开始同时启用多个代理插件，也不要在未确认IPv6接管方式前直接放开双栈流量。本文是第三方使用指南，不是任何软件项目的官方页面；当前界面字段可能因OpenWrt、防火墙后端和PassWall2构建版本不同而变化。

定义：PassWall2透明代理是由OpenWrt路由器接管经过局域网的网络流量，再按节点、域名、IP或设备规则决定直连或转发的配置方式。

先看四步速查：从安装状态到局域网验证

如果你只想先跑通基础配置，按下面顺序操作。每一步完成后再继续，出现异常时更容易回退。

步骤	要做什么	判断依据
1. 确认环境	确认路由器能进入LuCI，并查看使用的是`opkg`还是`apk`。	能执行`opkg --version`或`apk --version`其中之一。
2. 准备节点	在PassWall2的节点列表中导入订阅或手动添加节点。	节点列表出现可选择的节点，且节点测试不立即报配置错误。
3. 开启接管	选择主节点，设置分流方式，开启透明代理并保存应用。	PassWall2服务运行，日志没有持续出现启动失败或规则加载失败。
4. 分层验证	先测路由器，再测一台局域网设备，最后分别检查直连、代理和DNS行为。	不同测试结果与预期规则一致，而不是只看某一个网站能否打开。

PassWall2项目说明其LuCI入口、节点列表、基础设置和“Save & Apply”流程，但具体字段会随构建版本、核心和防火墙环境变化，建议以当前界面为准。可参考PassWall2项目仓库。

配置前检查：先确认软件包、防火墙和回滚条件

适用范围：OpenWrt路由器、已能登录LuCI、准备使用PassWall2进行局域网流量接管。本文不提供未经核实的固定版本号、安装包地址或节点服务信息。

确认包管理器。在SSH中执行opkg --version或apk --version。OpenWrt资料显示，较新的系统可能使用APK，而传统系统使用OPKG；安装包格式必须与路由器环境匹配。可查看OpenWrt APK说明和OpenWrt OPKG说明。
确认架构与存储。安装前记录设备架构、可用空间和当前已安装的代理插件。不要把其他设备的IPK或APK直接套用到本机。
避免规则重复接管。如果已经启用了其他透明代理、DNS接管或防火墙脚本，先停用其中一套并记录原状态。多个组件同时修改转发规则时，问题会变得难以定位。
准备回滚。至少记下当前LAN、WAN、DNS和防火墙设置；首次配置尽量只让一台测试设备接入，确认无误后再扩大范围。

OpenWrt在较新的防火墙架构中使用fw4和nftables；旧教程如果直接复制iptables规则，可能与当前环境不兼容。相关背景可参考OpenWrt防火墙概览和OpenWrt nftables说明。

PassWall2透明代理设置步骤：订阅、节点、分流与接管

进入PassWall2。在LuCI中打开PassWall2相关页面。项目仓库给出的基础路径是进入服务页面，再进入节点列表添加节点；如果你的菜单名称不同，以当前界面显示为准。
导入订阅或添加节点。订阅地址只应粘贴到路由器自己的配置页面，不要把包含令牌的完整地址提交给第三方。导入后先确认列表中出现节点，再选择一个节点作为主节点。
先用简单分流跑通。首次测试建议使用界面提供的默认分流方案，不要同时修改大量自定义规则。需要国内地址直连、其他流量按主节点处理时，先确认当前分流模式的文字说明，再保存应用。
开启透明代理。在基础设置或对应的透明代理设置区域开启流量接管。若页面同时提供路由器本机代理和客户端代理选项，先只启用一种范围：要测试全屋设备，就先选择局域网客户端接管；要测试路由器自身联网，再单独确认本机代理状态。
按设备扩大范围。先让一台测试设备重新获取DHCP地址或断开重连。确认该设备行为正常后，再把其他设备加入访问控制范围。访客网络、物联网网络或旁路由网络应单独验证，不要默认它们与主LAN规则完全相同。
保存并应用。点击当前页面的保存应用按钮，等待服务和规则重新加载。不要只保存不应用，也不要在服务仍处于重载状态时连续点击多次。

最小成功判据：PassWall2服务能够保持运行；一台测试设备能正常访问直连目标；需要经由主节点处理的目标，其连接行为与所选分流规则一致；日志没有反复出现节点解析失败、核心启动失败或防火墙规则加载失败。

DNS、IPv6和UDP怎么处理：先用保守方案再逐项打开

DNS：透明代理不仅是转发TCP连接，还会受到客户端DNS、路由器DNS和规则解析方式影响。首次配置时，先确认局域网设备把路由器作为DNS或按照你的网络设计使用指定DNS；如果设备绕过路由器直接使用自定义DNS，PassWall2的域名分流结果可能与预期不同。

远程DNS、DoH和FakeDNS：这些选项的字段和行为可能因核心、构建版本及当前配置而不同。不要把“开启某个DNS选项”直接等同于一定不会泄露或一定能解决污染问题。一次只改一个选项，保存后用日志和实际查询结果对照；异常时回退到上一个已知可用配置。

IPv6：如果宽带和局域网同时启用了IPv6，必须单独确认PassWall2当前配置是否接管IPv6流量。若只配置了IPv4透明代理，可能出现IPv4访问正常、IPv6目标行为不同的现象。排查时分别记录IPv4和IPv6结果；不要为了“看起来全走同一条路径”而直接删除所有IPv6设置，除非你明确知道上游网络和设备的影响。

UDP：部分应用依赖UDP。TCP测试正常不代表UDP一定可用。若视频、实时通信或其他应用异常，先查看当前节点和核心是否支持所需UDP，再检查透明代理模式、防火墙和日志。不要把TCP端口连通直接当作UDP成功。

验证与排错：按“现象—检查—判定—下一步”处理

现象	先查什么	如何判断	下一步
路由器本机正常，局域网设备不通	访问控制、DHCP、设备是否重新获取地址、LAN规则是否加载	只有路由器产生预期日志，测试设备没有对应流量记录	先只接管一台设备，重新连接网络后复测
节点列表为空	订阅返回内容、DNS、令牌有效性和解析错误	订阅更新日志出现超时、解析失败或返回格式异常	脱敏检查订阅地址，不要公开完整令牌；必要时改用手动节点测试
服务启动后立即停止	节点字段、核心依赖、架构和系统日志	日志反复出现配置解析失败或核心进程退出	先恢复到默认节点或备份配置，再逐项添加参数
部分网站打不开	DNS分流、IPv6、规则顺序和MTU	同一设备在不同协议栈或不同域名下表现不同	分别关闭自定义DNS、IPv6或高级规则进行单变量复测
重启后失效	服务自启动、依赖加载顺序和规则是否持久化	手动启动后正常，重启后服务未运行或规则为空	记录启动日志，确认当前版本对应的自启动设置，不要直接复制旧版脚本

SSH排查时可以先查看PassWall2相关日志，例如项目仓库列出的logread | grep passwall2；日志文件位置和名称可能随构建版本改变，因此以实际生成的日志为准。若修改后无法联网，优先关闭透明代理、恢复原DNS和防火墙设置，再重启网络服务或路由器，避免继续叠加改动。

完成后建议保留的配置记录

记录OpenWrt版本、设备架构、PassWall2构建来源和使用的核心。
记录包管理器是OPKG还是APK，以及安装过程中出现过的依赖提示。
记录主节点、分流模式、DNS方式、IPv4/IPv6开关和测试设备。
记录修改前后的日志关键词，不要保存或公开包含完整订阅令牌的配置截图。
后续升级前先导出或备份配置；升级后先用一台设备验证，再恢复更复杂的规则。

如果当前页面没有你看到的字段，不要按旧教程猜测枚举值。以当前界面帮助、项目说明和实际日志为准，先完成最小配置，再逐步增加DNS、IPv6、UDP或按设备规则。

常见问题

PassWall2透明代理开启后，路由器能上网但手机不能用怎么办？

先检查手机是否重新获取了路由器的DHCP配置，再检查访问控制是否包含该设备、LAN规则是否加载，以及手机是否手动指定了其他DNS。先只测试一台设备，不要立即扩大到全网。

PassWall2一定要开启IPv6透明代理吗？

不一定。是否开启取决于你的上游网络、局域网设备和当前PassWall2核心是否能正确处理IPv6。若只验证了IPv4，就不要把IPv6结果当成已验证；应分别测试IPv4和IPv6，异常时先回退到上一个可用配置。

为什么订阅导入成功，但节点不能连接？

订阅成功只说明配置内容被读取，不代表节点一定可用。继续检查节点字段、核心依赖、DNS解析、系统时间、日志中的启动错误和当前防火墙规则。不要公开完整订阅地址，因为其中可能包含获取配置的权限。

PassWall2可以和其他透明代理插件同时开启吗？

不建议在排错阶段同时开启多个会修改转发、DNS或防火墙规则的插件。先保留一套接管方案，确认服务、规则和局域网设备均正常后，再逐项测试其他组件。

OpenWrt新系统用APK安装时，能直接照搬IPK命令吗？

不能直接照搬。PassWall2项目同时列出了IPK和APK安装方式，OpenWrt资料也区分OPKG与APK。先用版本对应的包管理器检查命令，再选择匹配的安装包和依赖。

参考资料

PassWall2项目仓库：安装、基础配置、日志与功能说明
OpenWrt官方文档：APK包管理器（openwrt.org）
OpenWrt官方文档：OPKG包管理器（openwrt.org）
OpenWrt官方文档：防火墙概览（openwrt.org）
OpenWrt官方文档：nftables与fw4说明（openwrt.org）