在跑 Merlin 固件的华硕路由器上部署 AdGuard Home全屋去广告的 20 分钟完整实操笔记【免费下载链接】Asuswrt-Merlin-AdGuardHome-InstallerThe Official Installer of AdGuardHome for Asuswrt-Merlin项目地址: https://gitcode.com/gh_mirrors/as/Asuswrt-Merlin-AdGuardHome-InstallerAsuswrt-Merlin-AdGuardHome-Installer 是为 ARM 架构华硕华硕 Asuswrt-Merlin 固件路由器提供的 AdGuard Home 官方安装器它负责下载并校验 AdGuardHome 官方二进制、接管 53 DNS 端口、处理 dnsmasq路由器自带的 DNS 服务的交接并提供更新、备份、重配置、卸载等全套日常运维能力。这篇笔记按自检、部署、验证、日常调用的顺序带你完整走一遍。[此处插入管理界面截图]客厅电视又弹出一条购物广告晚上十一点你窝在沙发上看剧电视突然弹出一整屏的购物广告找不到关闭按钮。手机上你可以装拦截插件可电视盒子、老人的平板、小孩的玩具学习机一个个装根本不现实。AdGuard Home 换了一条路走它是个跑在路由器上的开源 DNS 服务器。部署之后家里所有设备——手机、电脑、电视——的域名解析都自动经过它广告域名在解析环节就拿不到结果弹窗自然就消失了而且一次配置、全屋生效。它拦截的是什么定位DNS 级拦截器。和浏览器插件的区别是它不坐在任何终端里而是坐在路由器上替局域网里所有设备统一做域名解析。广告和追踪域名在解析这一步就被挡掉设备拿到的是域名不存在而不是广告内容。附带能力查询日志能看清家里每一台设备解析过什么还可以把上游换成 DoH/DoT 这类加密 DNS 通道简单说就是把解析请求加密防止线路被人偷看。动手前把路由器自检一遍开工前确认这五件事缺哪样先补哪样ARM 架构华硕路由器Asuswrt-Merlin 固件 384.11 或更高项目官方支持的起点版本JFFS路由器上的一块可读写存储分区已启用自定义脚本和配置在网页端 管理 → 系统 里USB 存储已连接Entware路由器的 Linux 包管理器已装好并挂载交换文件swap内存不够时借磁盘顶上的机制已配置建议 2GB 起AMTM 工具可以帮忙建硬件建议 RT-AC68U 及以上更弱的型号能跑但余量有限安装前先把 Entware 的包列表刷新一遍保证后续取包不出错opkg update opkg upgrade用一行安装脚本命令拉下来跑第一步SSH 进路由器ssh admin192.168.50.1IP 换成你自己的。第二步一行命令下载安装脚本并立即执行curl -L -s -O https://gitcode.com/gh_mirrors/as/Asuswrt-Merlin-AdGuardHome-Installer/raw/master/installer sh installer这行命令把 installer 脚本拉到路由器上然后直接跑脚本先自检依赖再按你的路由器架构下载官方 AdGuardHome 二进制并校验 SHA-256最后写入配置、装服务。如果不确定环境是否干净可以先单独跑sh installer preflight它只检查不改动路由器状态。第三步跟着交互式菜单做选择每个提示在干什么版本通道release 是稳定版直接选它beta/edge 适合想尝鲜的人。DNS 接管方式决定 53 端口交给谁。全部接管最省心但原有的 dnsmasq 自定义规则会被挪到一边想清楚再选。上游 DNS拦截之后解析请求转给谁支持普通 DNS 和加密的 DoH/DoT 格式。Web 端口管理页地址默认 3000。后台同时在做的事配置文件写入/opt/etc/AdGuardHome/服务脚本 S99AdGuardHome 装进 Entware 的 init 目录/jffs下挂好开机钩子让重启后能自动拉起服务。第四步收尾。装完别删掉 installer 文件以后更新、重配置、备份、卸载都是再跑一遍sh installer同一个入口。它也支持非交互模式比如sh installer update --yes直接更新方便写进定时任务。装完先验一遍 AdGuardHome 是否活着在路由器 shell 里敲pidof AdGuardHome返回一个进程号说明服务进程活着。然后打开电脑浏览器访问http://192.168.50.1:3000管理页能打开、提示你设置管理员账号就算部署完成。页面打不开也别慌按顺序跑两条命令定位sh installer status sh installer doctorstatus 给一份简报服务状态、53 端口归属、WebUI 地址doctor 把 Entware 挂载、配置完整性、端口监听等环境项逐项体检输出 OK / WARN / FAIL看到 FAIL 就从那里下手。把 AdGuardHome 用起来把默认 DNS 交出去安装时选的接管方式一般够用但两种模式值得分清楚模式工作方式适合场景完全接管AdGuardHome 直接监听 53dnsmasq 被挪到 553 端口希望所有设备全部走拦截部分重定向dnsmasq 留在 53靠 Merlin 的DNS Filter选项把局域网查询指过来自己还有 dnsmasq 规则只想叠加广告拦截选错了不用重装再跑一次sh installer走重配置流程即可。加一份中文规则列表默认过滤列表以英文源为主国内广告和追踪域名建议再补一份中文规则。打开管理页 → 过滤 → DNS 阻止列表 → 添加粘贴列表 URL 保存即可。每个列表都带自动更新周期比如每天一次平时不用手动刷新。调一下端口和缓存如果 3000 端口冲突或者想调 DNS 缓存大小改/opt/etc/AdGuardHome/AdGuardHome.yaml里这几行bind_port: 3000 cache_size: 4194304bind_port 是 Web 管理端口cache_size 是 DNS 缓存字节数默认 4MB。改完保存执行service restart_AdGuardHome生效。让规则自己刷新AdGuard Home 内置调度器会按各自周期更新列表不需要额外写 crontab。列表加多了、怀疑有些没用时跑sh installer blocklists需 Entware 的 python3它基于查询日志统计出窗口期内命中为零的列表顺手清理。大改动之前先sh installer backup --yes做一次全量配置备份更稳。三个高频坑的答案Q3000 管理页打不开。A先pidof AdGuardHome看进程在不在。没有进程就sh installer doctor找 FAIL 项进程在但页面不通用netstat -lnp | grep :3000 查端口被谁占着。Q装完之后部分设备解析不了、上不了网。A重点看 53 端口。netstat -lnp | grep :53 里应该显示 AdGuardHome。如果 53 被别的进程占着新版安装器默认拒绝强杀、直接放弃启动日志里会写占用者的 PID先把那个服务停掉再service start_AdGuardHome。Q路由器重启后服务没自动起来。A查两件事顺序别反JFFS 自定义脚本是否启用、Entware 是否挂载成功。sh installer doctor会直接报出/opt 未挂载这类项。Entware 装在 USB 上拔了 U 盘 AdGuardHome 自然也没了启动脚本/opt/etc/init.d/S99AdGuardHome缺失时重跑sh installer可以重建。收尾一句话总结53 端口交给 AdGuardHome全屋去广告就落地了。更深的 IPSET 路由集成、备份恢复、诊断打包等内容在项目内的 README.md 和 WIKI.md 里遇到问题时把sh installer status和sh installer doctor的输出一起贴到项目的问题反馈里定位会快很多。【免费下载链接】Asuswrt-Merlin-AdGuardHome-InstallerThe Official Installer of AdGuardHome for Asuswrt-Merlin项目地址: https://gitcode.com/gh_mirrors/as/Asuswrt-Merlin-AdGuardHome-Installer创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
