Asuswrt-Merlin 安装 AdGuardHome 实操教程【免费下载链接】Asuswrt-Merlin-AdGuardHome-InstallerThe Official Installer of AdGuardHome for Asuswrt-Merlin项目地址: https://gitcode.com/gh_mirrors/as/Asuswrt-Merlin-AdGuardHome-InstallerAsuswrt-Merlin-AdGuardHome-Installer 是 AdGuard Home 在华硕路由器上的官方安装脚本。你用 SSH 连上运行 Asuswrt-Merlin 固件的 ARM 华硕路由器执行一条命令就能把 AdGuard Home 部署到 Entware 环境并接管局域网 DNS。它到底干什么AdGuard Home 本身是一个开源 DNS 服务器装好之后它监听路由器的 53 端口局域网里所有设备的 DNS 查询都先经过它命中过滤规则的域名直接返回拦截结果未命中的转发给你配置的上游 DNS支持普通 DNS、DoT、DoH 等格式。这个项目的价值在于把部署过程标准化下载官方二进制、写入 Entware 启动脚本、挂接 Asuswrt-Merlin 的服务事件、处理 dnsmasq 的端口让渡后续的升级、备份、回滚、卸载都从同一个入口完成不用每次手写脚本。先确认你的路由器能不能装安装前对照这几点ARM 架构的华硕路由器Asuswrt-Merlin 固件 384.11 或更高版本JFFS 自定义脚本和配置已启用管理页-系统里勾选Entware 安装在独立的 USB 存储上AdGuardHome 也存放在这块盘里建议配置至少 2GB 的 swap 文件AMTM 可以帮忙创建性能建议高于 RT-AC68UAC68U 能跑但余量有限Entware 挂载成功后在路由器上执行下面这条命令能正常跑完就说明依赖就绪opkg update opkg upgrade双 NAT 或多 WAN 的环境可能不兼容AdGuard Home 必须独占 53 端口安装时 dnsmasq 会被让渡到安装器管理的备用端口。一条命令装完先用 SSH 登录路由器。为不让 Entware 的命令抢占固件自带命令先执行一次路径设置export LC_ALLC export PATH/sbin:/bin:/usr/sbin:/usr/bin:${PATH:-}接着下载 installer 脚本并直接运行。脚本会自检环境、下载对应架构armv5/armv7/armv8的 AdGuardHome 官方压缩包、校验 SHA-256然后进入交互式菜单/usr/sbin/curl -L -s -O https://gitcode.com/gh_mirrors/as/Asuswrt-Merlin-AdGuardHome-Installer/master/installer sh installer按提示选择 AdGuardHome 版本通道选 release 稳定版即可和 DNS 方案后安装器会下载二进制、写入 /opt/etc/init.d/S99AdGuardHome 启动脚本并在 /jffs 下挂好 dnsmasq 和防火墙钩子。过程中断也没关系重跑同一条命令可以恢复不需要从头装。装完后浏览器访问http://路由器IP:3000首次进入会让你设置管理员账号和密码。过滤规则、上游 DNS、查询日志都在这个 WebUI 里管理。装完先验证有没有跑起来先确认进程存在返回一个或多个 PID 就说明服务正常pidof AdGuardHome再用安装器自带的 status 看完整摘要它列出服务状态、53 端口归属、AdGuardHome 版本和 WebUI 地址sh installer status想看得更细执行sh installer doctor输出为[OK]、[WARN]、[FAIL]状态行能看出 Entware 挂载、配置文件、端口监听哪一环出了问题。按需调一调安装器的运行时设置集中在 /opt/etc/AdGuardHome/.configNAMEvalue 格式最常用的是这三项网络探测模式默认按安装时的 DNS 方案保存。如果路由器只做纯局域网服务改成 lan 模式避免公网探测卡住启动检查一条命令写入sh installer netcheck --mode lan性能优化档位新装默认 balanced调 UDP 缓冲和 conntrack 超时内存紧张可降为 low-memory想恢复旧版激进调参用 fastsh installer performance --profile balanced上游 DNS 与 Web 端口上游 DNS 在 WebUI 的DNS 设置页直接改Web 管理端口默认 3000被占用时改 /opt/etc/AdGuardHome/AdGuardHome.yaml 里的 bind_port 后重启服务改完 .config 后执行service restart_AdGuardHome让设置生效。卡住了怎么办WebUI 打不开跑netstat -tlnp | grep 3000看端口有没有监听。没有监听大概率是进程没起来执行sh installer doctor看报错再service start_AdGuardHome拉起。启动报 53 端口被占用用netstat -tlnp | grep :53 找到占用者。新版默认拒绝强杀未知进程并中止启动确认该进程可以停掉后手动停掉再启动 AdGuardHome。DNS 解析异常跑logread | grep -iE AdGuardHome|dnsmasq看事件日志再执行sh installer doctor --fix修复权限、旧 pid 文件这类安全项它不会改写你的 DNS 和防火墙设置。再往前一步装稳之后立刻做一份备份以后升级或改配置前都先备一份sh installer backup --yes更新 AdGuardHome 版本走同一个入口先 dry-run 预览再正式执行配置和过滤规则都会保留sh installer update --dry-run sh installer update --yes过滤列表堆多了的话菜单选项 9sh installer blocklists可以分析查询日志找出统计窗口内一次都没命中的列表需要 Entware python3。更多非交互命令、IPSET 集成和诊断包打包方法见 WIKI.md环境要求与静态归档说明见 README.md。改配置或升级固件前先跑一次sh installer backup --yes备份回滚才有底。【免费下载链接】Asuswrt-Merlin-AdGuardHome-InstallerThe Official Installer of AdGuardHome for Asuswrt-Merlin项目地址: https://gitcode.com/gh_mirrors/as/Asuswrt-Merlin-AdGuardHome-Installer创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
