Lazy loaded image
🛠️OpenWrt:PassWall 节点配置、DNS 防泄漏与故障排查
字数 1189阅读时长≈ 3 分钟
2026-10-18
2026-10-18

适用范围

本文以具备合法访问授权的代理服务为例,讲解 PassWall 的通用管理思路。不同分支和固件版本的菜单、内核与字段会有差异,请以安装版本的界面为准。

一、下载来源与安装前检查

  • 只安装与当前 OpenWrt 版本、架构相匹配的包。第三方固件可能已经集成插件;重复安装可能导致依赖冲突。
  • 备份 UCI 配置:通过 LuCI 生成配置备份,或 SSH 下导出相关配置文件。保留一条有线管理路径。

二、先理解数据流

典型的数据链路是:客户端 → 路由器 DNS 服务 → 访问控制/透明代理规则 → 代理核心 → 上游节点。实际链路取决于插件模式、所选内核和防火墙后端。
  • 节点配置:服务端地址、端口、协议、认证参数等。任何秘密字段都不要公开。
  • 节点/策略选择:决定哪些流量经由某个上游出口。
  • 访问控制:以客户端 IP 或插件支持的标识决定设备是否启用代理。
  • DNS 设置:决定客户端请求由谁解析、使用什么上游,以及解析结果怎样送入规则系统。
  • 防火墙规则:负责接管或重定向特定流量;不能只看网页测试结果。

三、添加节点并验证

  1. 打开 PassWall 管理页,进入节点配置,新增由你合法持有的节点参数。
  1. 保存后执行插件提供的节点测试;测试失败时先检查地址、端口、认证与协议,不要立即改 DNS。
  1. 在主页面选择节点作为默认策略,先只让测试设备使用。
  1. 保存并应用后,查看服务运行状态、系统日志和连接日志。
  1. 分别验证 DNS、HTTPS、局域网访问与重启持久性。

四、按设备进行访问控制

  1. 在 DHCP 静态租约中,为测试设备绑定稳定的内网地址。
  1. 在 PassWall 访问控制中填写该设备对应地址,选择本机插件支持的策略。
  1. 保存并应用,断开设备 Wi-Fi 后重新连接以刷新租约。
  1. 访问授权的测试站点并查看连接日志;再测试 NAS、打印机、路由器管理页是否仍能访问。
  1. 确认无误后,一次增加一台设备,便于定位问题。

五、DNS 防故障的原则

  • 明确谁是局域网 DNS 服务入口,常见为 dnsmasq;SmartDNS、AdGuard Home 和代理插件的 DNS 模式不要未经规划就叠加。
  • 先画出“客户端 → 本地缓存/转发 → 上游解析 → 规则决策”的链路。
  • 如果出现解析慢或异常,分别比较路由器本机解析与客户端解析,检查 IPv4/IPv6、浏览器 DoH、应用内 DNS 和缓存。
  • 不要复制来源不明的一键防泄漏脚本;错误的 nftables/iptables 规则可能中断 DNS 或锁住管理路径。

六、UCI 配置与命令的运行逻辑

OpenWrt 使用 UCI 管理许多系统配置。通用读取示例:
  • uci show 是读取操作,用于查看当前配置。
  • uci set 修改内存中的配置变更集;uci commit 写入持久配置;服务 reload/restart 才会让相关组件重新读取配置。
  • 请先阅读当前插件生成的配置结构,不要随意拼写不存在的键值。
查看日志可使用:

七、常见故障定位顺序

  1. 先确认路由器本身能否联网。
  1. 再确认节点连通性。
  1. 然后检查代理服务进程与日志。
  1. 接着检查 DNS 转发、缓存和 IPv6。
  1. 最后检查访问控制、路由表和防火墙规则。
一次只改一个变量,记录改动前后结果。修改防火墙前导出配置备份并确保能通过有线方式恢复。

官方参考

注意:协议、节点与网络策略请使用有授权的服务,并遵守当地法律及服务条款。
上一篇
OpenWrt:用 mwan3 与策略路由理解多设备分流(不依赖魔改脚本)
下一篇
OpenWrt:OpenClash 从安装到规则分流的完整配置教程

评论
Loading...