适用范围
本文以具备合法访问授权的代理服务为例,讲解 PassWall 的通用管理思路。不同分支和固件版本的菜单、内核与字段会有差异,请以安装版本的界面为准。
一、下载来源与安装前检查
- 项目源码入口可从 OpenWrt PassWall 项目 进入,核对 README、Release 和依赖。
- 只安装与当前 OpenWrt 版本、架构相匹配的包。第三方固件可能已经集成插件;重复安装可能导致依赖冲突。
- 备份 UCI 配置:通过 LuCI 生成配置备份,或 SSH 下导出相关配置文件。保留一条有线管理路径。
二、先理解数据流
典型的数据链路是:客户端 → 路由器 DNS 服务 → 访问控制/透明代理规则 → 代理核心 → 上游节点。实际链路取决于插件模式、所选内核和防火墙后端。
- 节点配置:服务端地址、端口、协议、认证参数等。任何秘密字段都不要公开。
- 节点/策略选择:决定哪些流量经由某个上游出口。
- 访问控制:以客户端 IP 或插件支持的标识决定设备是否启用代理。
- DNS 设置:决定客户端请求由谁解析、使用什么上游,以及解析结果怎样送入规则系统。
- 防火墙规则:负责接管或重定向特定流量;不能只看网页测试结果。
三、添加节点并验证
- 打开 PassWall 管理页,进入节点配置,新增由你合法持有的节点参数。
- 保存后执行插件提供的节点测试;测试失败时先检查地址、端口、认证与协议,不要立即改 DNS。
- 在主页面选择节点作为默认策略,先只让测试设备使用。
- 保存并应用后,查看服务运行状态、系统日志和连接日志。
- 分别验证 DNS、HTTPS、局域网访问与重启持久性。
四、按设备进行访问控制
- 在 DHCP 静态租约中,为测试设备绑定稳定的内网地址。
- 在 PassWall 访问控制中填写该设备对应地址,选择本机插件支持的策略。
- 保存并应用,断开设备 Wi-Fi 后重新连接以刷新租约。
- 访问授权的测试站点并查看连接日志;再测试 NAS、打印机、路由器管理页是否仍能访问。
- 确认无误后,一次增加一台设备,便于定位问题。
五、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 才会让相关组件重新读取配置。
- 请先阅读当前插件生成的配置结构,不要随意拼写不存在的键值。
查看日志可使用:
七、常见故障定位顺序
- 先确认路由器本身能否联网。
- 再确认节点连通性。
- 然后检查代理服务进程与日志。
- 接着检查 DNS 转发、缓存和 IPv6。
- 最后检查访问控制、路由表和防火墙规则。
一次只改一个变量,记录改动前后结果。修改防火墙前导出配置备份并确保能通过有线方式恢复。
官方参考
注意:协议、节点与网络策略请使用有授权的服务,并遵守当地法律及服务条款。
- 作者:墨殇个人博客
- 链接:https://moshang.eu.org/article/openwrt-passwall-dns-troubleshooting
- 声明:本文采用 CC BY-NC-SA 4.0 许可协议,转载请注明出处。






