服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- 该绕过只适用于特定 PassWall2 版本与纯源 IP 分流、默认直连 DNS 的组合,不是所有分流故障的通用解释。
- 先关联设备源地址、直连 DNS 目标地址、IPSet 成员与 nftables 顺序;单独看到 IPSet 或 SOCKS5 可用不足以定因。
- 仅当直连 DNS 白名单中的目标地址在 TPROXY 前命中 return,且 write_ipset_direct 当前值为 1 时,才评估将该选项改为 0。
- 修改前备份 PassWall2 配置并记录原值;重启服务会中断代理流量,失败时仅还原这个选项。
先确认故障是按设备分流被绕过
如果某一 LAN 设备应走 PassWall2 代理,却仍然直连,先确认该设备确实匹配了源 IP 规则,并使用正确的网关和 DNS。再从该设备重复同一请求,分别记录应用结果、路由器连接跟踪和 PassWall2 规则命中。节点的显式 SOCKS5 连通只证明代理入口可用,不能证明透明代理流量经过了预期规则。
这条诊断分支只覆盖某一 PassWall2/Xray 配置中的纯源 IP 分流和默认直连 DNS 组合。域名分流、其他 DNS 接管方式、其他核心或版本应按各自生成配置检查,不能因为症状相似就直接套用该开关。
比较 DNS 目标白名单与 TPROXY 顺序
读取实际生效的 nftables 规则,寻找 PassWall2 对直连 DNS 目标地址设置的目的集合,以及相关 return 和 TPROXY 规则的先后顺序。只有当设备发出的 DNS 请求目的地址进入该白名单,并且对应 return 在透明代理重定向之前执行,才可能绕过 TPROXY。不要公开含有客户端地址或内部网段的完整规则集。
同时读取 write_ipset_direct 的实际 UCI 值。配置文件中的一个开关名、静态规则文本或集合存在本身都不足以证明运行时绕行;把该设备的源规则、目标集合成员和生效规则顺序对应起来。
只读检查配置选项和 nftables 规则顺序
shuci show passwall2 | grep -F 'write_ipset_direct='
nft list ruleset | grep -n -E 'passwall|tproxy|redirect|return'
只在条件吻合时改一个 PassWall2 选项
只有在纯源 IP 规则、默认直连 DNS、目标地址确实属于直连目的集合、return 位于 TPROXY 之前且当前 write_ipset_direct=1 都得到确认时,才考虑把该选项设为 0。如果其中任何一项不匹配,停止这条修复分支,继续检查实际策略、设备源地址和 DNS 路径。
先通过有线 LAN 保留管理入口,并记录只读命令输出中的完整 UCI 选项键和原值。下面步骤只改这个键,备份整个 PassWall2 配置到权限为 600 的 root 文件;它含有敏感节点配置,不要传出路由器。服务重启会短暂中断代理。
备份配置并将已确认的选项设为 0
shset -eu
UCI_KEY='REPLACE_WITH_EXACT_OPTION_KEY_FROM_READ_ONLY_OUTPUT'
CURRENT="$(uci -q get "$UCI_KEY")"
[ "$CURRENT" = '1' ] || { printf 'Expected write_ipset_direct=1; stop and recheck\n' >&2; exit 1; }
umask 077
BACKUP="/root/passwall2-before-write-ipset-direct-$(date +%Y%m%d-%H%M%S)"
cp /etc/config/passwall2 "$BACKUP"
chmod 600 "$BACKUP"
uci set "$UCI_KEY=0"
uci commit passwall2
/etc/init.d/passwall2 restart
用同一设备和同一请求复核
服务重启后重新检查该选项确为 0、直连 DNS 目标不再被该生成白名单提前放行,并确认规则链仍有预期的 TPROXY 路径。从原测试设备重新发起同一请求,结合规则计数、连接跟踪和实际出口确认流量命中代理,而不是只检查路由器自己的 SOCKS5 端口。
该修复路径的验证范围不包含重启后持久性。若需要确认重启行为,应先记录当前成功状态,再单独安排有线管理可用的维护测试;不要把一次服务重启后的手机请求当成所有设备、DNS 模式或版本都已通过。
只恢复该选项即可回滚
如果同一手机请求仍被绕过、出现新的 DNS 故障或 PassWall2 无法正常重启,不要继续改 DNS、全局 IPSet、节点或防火墙。把 write_ipset_direct 恢复为修改前记录的值,再提交并重启 PassWall2;只在路由器实际状态符合脚本前置检查时执行下面命令。
回滚后复查 UCI 值、生成规则以及原设备的同一请求。保留原配置备份直到确认回滚或修复结果;它可能含节点与认证配置,应使用受限权限保存并按设备管理政策处理。
恢复 write_ipset_direct 的原值
shset -eu
UCI_KEY='REPLACE_WITH_EXACT_OPTION_KEY_CHANGED_ABOVE'
PREVIOUS_VALUE='1'
[ "$(uci -q get "$UCI_KEY")" = '0' ] || { printf 'Setting is not 0; stop and inspect current state\n' >&2; exit 1; }
uci set "$UCI_KEY=$PREVIOUS_VALUE"
uci commit passwall2
/etc/init.d/passwall2 restart
理解版本和验收边界
这条行为对应特定 PassWall2 26.10.20-r152、Xray 26.3.27 和规则组合;不要据此推断其他版本的默认值或规则生成顺序。变更未经设备重启验证,重启持久性需要单独检查。
DNS 是否被接管、最终出口地址和客户端实际访问是不同验收点。关闭直连地址写入只能验证所识别的目的白名单路径是否改变,不能替代完整的 DNS、TCP、UDP、IPv6 或其他源规则策略测试。
资料来源
常见问题
PassWall2 分流不生效时都应该关闭 write_ipset_direct 吗?
不应该。仅在纯源 IP 分流、默认直连 DNS、目标地址进入目的白名单且其 return 规则先于 TPROXY 时考虑。
显式 SOCKS5 可用是否证明透明代理规则正常?
不能。它只证明 SOCKS 入口和代理链路可用;仍需从原 LAN 设备验证透明转发、规则命中和实际出口。
可以直接清空 DNS IPSet 或全部重建 nftables 吗?
不要把全局清理当作通用修复。先确定具体目的集合、命中地址和规则顺序;若条件吻合,仅修改该选项。
修改后是否已证明重启也能正常工作?
没有。先验证服务重启后的同设备请求;设备整机重启的持久性应作为独立验收步骤。