AdGuardHome 端口冲突快速搞定53 与 3000 默认端口一次改对【免费下载链接】AdGuardHomeNetwork-wide ads trackers blocking DNS server项目地址: https://gitcode.com/gh_mirrors/ad/AdGuardHome刚部署 AdGuardHome 时最常见的报错就是address already in use——这是典型的 AdGuardHome 端口冲突。原因不复杂它默认占用 53DNS和 3000Web 管理界面两个端口而这两个端口恰好都是服务器上热门货。这篇指南带你按部署方式把端口改好、验证通过。TL;DR只关心答案看这里 编辑AdGuardHome.yaml把dns.port改成 1024 以上的空闲端口如 5353把http.address改成如0.0.0.0:8080然后重启服务。就这两个字段。为什么会撞端口AdGuardHome 是一个进程、两副面孔一侧是面向全家设备提供解析的 DNS 服务默认听 53 端口——这正好是系统自带 dnsmasq、systemd-resolved 的本职端口几乎必然打架另一侧是 Web 管理界面默认听 3000 端口——这个端口很多 Node 应用、其他代理管理页也爱用撞车概率也不低。两者相互独立所以常常只需改其中一个。先确认谁占用了 53 端口动手前先定位别盲改。任选一条ss -tulnp | grep -E :(53|3000)\b lsof -iUDP:53 -iTCP:3000输出里能看到是dnsmasq、systemd-resolved还是别的进程。确认被谁占之后再决定是把对方停掉还是给 AdGuardHome 让个新端口。裸机 / 直接改配置文件怎么改配置文件默认在二进制同目录AdGuardHome.yaml仓库里有一份可直接对照的示例 AdGuardHome.example.yaml。最小改动如下dns: port: 5353 http: address: 0.0.0.0:8080改完执行systemctl restart AdGuardHome或你实际的启动方式。如果服务文件里写死了配置路径改的必须是同一个文件——这是新手最容易改错的地方。Docker 部署怎么同步改端口Docker 场景多一层容器内端口和宿主机映射要一起看。AdGuardHome 镜像支持环境变量覆盖docker-compose.yml里这样写最省事environment: - DNS_PORT5353 - WEB_ADDR0.0.0.0:8080 ports: - 8080:8080 # 宿主机:容器 - 5353:5353/udp 注意ports左边的宿主机端口要跟着改漏改映射是 Docker 场景下改了半天还是不通的头号原因。改完跑这几条命令验证ss -tulnp | grep AdGuardHome # 应看到新端口在 LISTEN dig 127.0.0.1 -p 5353 example.com # 换你的新 DNS 端口 curl -I http://127.0.0.1:8080 # 管理界面应返回 HTTP 响应三条都通再登录http://服务器IP:8080看看面板和过滤列表是否正常加载过滤流程可参考 agh-filtering.png 的示意。容易踩的坑新端口在防火墙 / 安全组里没放行容器内通、外面不通。设备端 DNS 还指向旧端口路由器 DHCP 下发地址也要改。选了 1024 以下的端口非 root 进程直接绑不上5353 这类高端口更稳。只改了配置文件忘了 Dockerports映射或 systemd 里--config指向的是别的文件。想省事的可以改用命令行--config指向外部配置文件避免升级时覆盖安装目录里的配置。改完端口只是部署的第一关想继续了解配置如何随版本演进可以看 configmigrate 模块项目整体行为与配置项说明见 README.md。【免费下载链接】AdGuardHomeNetwork-wide ads trackers blocking DNS server项目地址: https://gitcode.com/gh_mirrors/ad/AdGuardHome创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考