如何在 30 分钟内为华硕路由器部署 DNS 广告拦截Asuswrt-Merlin-AdGuardHome-Installer 安装指南【免费下载链接】Asuswrt-Merlin-AdGuardHome-InstallerThe Official Installer of AdGuardHome for Asuswrt-Merlin项目地址: https://gitcode.com/gh_mirrors/as/Asuswrt-Merlin-AdGuardHome-Installer孩子平板上的全屏广告从路由器层面拦截周五晚上孩子的平板弹出一条全屏广告点掉之后又弹出第二条。逐台设备装拦截软件既繁琐又覆盖不全而所有设备的 DNS 查询其实都先经过路由器。Asuswrt-Merlin-AdGuardHome-Installer 就是为此而生它把 AdGuard Home 部署到运行 Asuswrt-Merlin 固件的华硕路由器上在 DNS 层面做广告拦截局域网内所有设备一次配置全部生效不需要在手机上或电视盒子上单独安装任何东西。动手前确认检查固件版本与 Entware 就绪状态项目要求路由器为 ARM 架构的华硕机型固件为 Asuswrt-Merlin 384.11 或更高版本并且已启用 JFFS 自定义脚本、在独立 USB 存储上装好 EntwareAdGuard Home 的文件与 Entware 存放在同一块盘。开始前先在 USB 盘上执行opkg update opkg upgrade更新软件源并建议用 AMTM 创建至少 2GB 的交换文件。SSH 登录后跑下面三条命令确认架构、机型和 Entware 挂载状态uname -m # ARM 架构输出 armv7l 或 aarch64 nvram show boardid # 查看路由器机型 ls /opt/bin/opkg # 文件存在说明 Entware 已挂载下载安装器并执行安装再用 status 验证连接用ssh admin192.168.50.1换成你的路由器 IP登录后续命令都在路由器终端执行。执行curl -L -s -O https://gitcode.com/gh_mirrors/as/Asuswrt-Merlin-AdGuardHome-Installer/master/installer sh installer这条命令先下载 installer 脚本再用 sh 运行它。安装器会按路由器架构下载对应的 AdGuard Home 二进制包按菜单提示选择 Web 端口默认 3000和上游 DNS 策略并自动完成 dnsmasq 端口 53 的交接与启动脚本写入。验证sh installer status输出会列出服务状态、53 端口归属、WebUI 地址与版本信息再用浏览器访问http://192.168.50.1:3000首次访问需要设置管理员账号pidof AdGuardHome能返回进程号说明进程存活。进入 WebUI管理后台四个核心菜单功能速览登录后日常使用集中在下面几个菜单菜单主要功能仪表盘实时查询统计、拦截数量与 DNS 解析状态过滤列表添加或移除 DNS 阻止列表规则源DNS 设置配置上游 DNS支持 DoT / DoH 加密解析保护客户端按 MAC 地址把个别设备设为白名单或黑名单想快速判断 DNS 广告拦截是否生效看仪表盘上的拦截数是否随正常浏览持续增长即可。调优实战修改 Web 端口、DNS 缓存与过滤规则源最值得动的参数有三个。Web 管理端口局域网里 3000 端口被占用时改它。编辑/opt/etc/AdGuardHome/AdGuardHome.yamlwebui: address: 0.0.0.0:8080保存后执行service restart_AdGuardHome浏览器访问新地址确认能登录。DNS 缓存大小设备多的局域网可以调大内存紧张则调小。同一文件里修改dns: cache_size: 4194304这是 4MB内存紧张改成 20971522MB。重启后看仪表盘的缓存命中率命中率上升说明改动有效。过滤规则源默认列表对国内域名覆盖有限。不需要改文件在 WebUI 的过滤列表菜单添加第三方列表 URL 并点更新完成后一两分钟内新规则生效可以用一个已知广告域名交叉验证拦截计数是否增长。运维速查AdGuardHome 服务启停与日志常用命令操作命令启动service start_AdGuardHome停止service stop_AdGuardHome重启service restart_AdGuardHome查进程pidof AdGuardHome状态摘要sh installer status查看日志logread \| grep -i AdGuardHome疑难解答管理界面打不开与重启后解析失败现象浏览器访问 WebUI 地址超时。排查sh installer status看 WebUI 端口归属netstat -lnp | grep :3000 看端口是否被别的进程占用。解法端口被占用就按上一节方法改端口后重启进程未运行则执行sh installer doctor --fix修复权限与链接再service restart_AdGuardHome。现象重启后部分设备无法打开网页或解析缓慢。排查netstat -lnp | grep :53 确认 53 端口由 AdGuardHome 持有logread | grep -iE AdGuardHome|dnsmasq查看启动日志。解法新安装的默认策略是 53 被未知进程占用时中止启动而不强杀找到并停掉占用服务后执行service restart_AdGuardHome即可恢复。延伸阅读备份更新流程与运行时参数文档WIKI.md面向任务的运维手册包含备份、恢复、更新、卸载的完整流程和故障排查步骤。README.md项目主文档涵盖非交互命令preflight、doctor、性能配置档与运行时行为参数的全部说明。安装器会自动配置反向 DNS 相关规则一般无需手动处理需要微调时查看 WebUI 中的 Private Reverse DNS Servers 设置即可。配置生效后重启路由器前确认 DNS 解析恢复正常。【免费下载链接】Asuswrt-Merlin-AdGuardHome-InstallerThe Official Installer of AdGuardHome for Asuswrt-Merlin项目地址: https://gitcode.com/gh_mirrors/as/Asuswrt-Merlin-AdGuardHome-Installer创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考