danychen/adguardhome

AdGuard Home - Docker

!AdGuard Home

您和您设备的隐私保护中心

免费开源、功能强大的网络级广告和跟踪器拦截DNS服务器。

![]([***]

• 简介
• 快速开始
• 更新到新版本
• 运行开发构建版本
• 额外配置
• DHCP服务器
• resolved守护进程

简介

AdGuard Home是一款网络级广告和跟踪拦截软件。设置完成后，它将覆盖您所有的家庭设备，无需任何客户端软件。更多信息请访问我们的https://github.com/AdguardTeam/AdGuardHome%E3%80%82

快速开始

拉取Docker镜像

以下命令将拉取最新稳定版本：

bash
docker pull adguard/adguardhome

创建持久化配置和数据目录

该镜像暴露两个卷用于数据和配置的持久化存储。您需要在主机系统的合适卷上创建一个数据目录（例如/my/own/workdir）和一个配置目录（例如/my/own/confdir）。

创建并运行容器

使用以下命令创建新容器并运行AdGuard Home：

bash
docker run --name adguardhome \
    --restart unless-stopped \
    -v /my/own/workdir:/opt/adguardhome/work \
    -v /my/own/confdir:/opt/adguardhome/conf \
    -p 53:53/tcp -p 53:53/udp \
    -p 67:67/udp -p 68:68/udp \
    -p 80:80/tcp -p 443:443/tcp -p 443:443/udp -p 3000:3000/tcp \
    -p 853:853/tcp \
    -p 784:784/udp -p 853:853/udp -p 8853:8853/udp \
    -p 5443:5443/tcp -p 5443:5443/udp \
    -d adguard/adguardhome

现在您可以打开浏览器并访问[***] Home服务。

请务必使用您自己的数据和配置目录！

您可能需要的端口映射：

• -p 53:53/tcp -p 53:53/udp：普通DNS。
• -p 67:67/udp -p 68:68/tcp -p 68:68/udp：如果打算将AdGuard Home用作DHCP服务器，请添加。
• -p 80:80/tcp -p 443:443/tcp -p 443:443/udp -p 3000:3000/tcp：如果要使用AdGuard Home的管理面板以及将其作为https://github.com/AdguardTeam/AdGuardHome/wiki/Encryption%E6%9C%8D%E5%8A%A1%E5%99%A8%E8%BF%90%E8%A1%8C%EF%BC%8C%E8%AF%B7%E6%B7%BB%E5%8A%A0%E3%80%82
• -p 853:853/tcp：如果要将AdGuard Home作为https://github.com/AdguardTeam/AdGuardHome/wiki/Encryption%E6%9C%8D%E5%8A%A1%E5%99%A8%E8%BF%90%E8%A1%8C%EF%BC%8C%E8%AF%B7%E6%B7%BB%E5%8A%A0%E3%80%82
• -p 784:784/udp -p 853:853/udp -p 8853:8853/udp：如果要将AdGuard Home作为https://github.com/AdguardTeam/AdGuardHome/wiki/Encryption%E6%9C%8D%E5%8A%A1%E5%99%A8%E8%BF%90%E8%A1%8C%EF%BC%8C%E8%AF%B7%E6%B7%BB%E5%8A%A0%E3%80%82%E6%82%A8%E5%8F%AF%E4%BB%A5%E5%8F%AA%E4%BF%9D%E7%95%99%E5%85%B6%E4%B8%AD%E4%B8%80%E4%B8%AA%E6%88%96%E4%B8%A4%E4%B8%AA%E3%80%82
• -p 5443:5443/tcp -p 5443:5443/udp：如果要将AdGuard Home作为https://github.com/AdguardTeam/AdGuardHome/wiki/DNSCrypt%E6%9C%8D%E5%8A%A1%E5%99%A8%E8%BF%90%E8%A1%8C%EF%BC%8C%E8%AF%B7%E6%B7%BB%E5%8A%A0%E3%80%82

控制容器

• 启动：docker start adguardhome
• 停止：docker stop adguardhome
• 删除：docker rm adguardhome

更新到新版本

1. 从Docker Hub拉取新版本：

bash
docker pull adguard/adguardhome

2. 停止并删除当前运行的容器（假设容器名为adguardhome）：

bash
docker stop adguardhome
docker rm adguardhome

3. 使用上一节中的命令创建并启动使用新镜像的容器。

运行开发构建版本

如果您想使用前沿版本，可以运行edge或beta标签的镜像。只需在快速开始的每个命令中将adguard/adguardhome替换为adguard/adguardhome:edge或adguard/adguardhome:beta。例如：

bash
docker pull adguard/adguardhome:edge

额外配置

首次运行时，将创建一个名为AdGuardHome.yaml的文件，并写入默认值。您可以在AdGuard Home容器未运行时修改该文件。否则，对文件的任何更改都将丢失，因为运行中的程序会覆盖它们。

设置存储在YAML中，您可以配置的可能参数列在https://github.com/AdguardTeam/Adguardhome/wiki/Configuration%E4%B8%8A%E3%80%82

DHCP服务器

如果要使用AdGuardHome的DHCP服务器，创建容器时应传递--network host参数：

bash
docker run --name adguardhome --network host ...

此选项指示Docker使用主机的网络而不是docker桥接网络。注意，在这种情况下不需要使用-p进行端口映射。

Docker文档中的说明：

主机网络驱动程序仅在Linux主机上工作，在Docker Desktop for Mac、Docker Desktop for Windows或Docker EE for Windows Server上不受支持。

resolved守护进程

如果您尝试在启动了resolved守护进程的系统上运行AdGuardHome，docker将无法绑定到53端口，因为resolved守护进程正在监听127.0.0.53:53。以下是禁用机器上DNSStubListener的方法：

1. 停用DNSStubListener并更新DNS服务器地址。创建一个新文件/etc/systemd/resolved.conf.d/adguardhome.conf（如果需要，创建/etc/systemd/resolved.conf.d目录），并添加以下内容：

ini
[Resolve]
DNS=127.0.0.1
DNSStubListener=no

指定127.0.0.1作为DNS服务器地址是必要的，否则名称服务器将是127.0.0.53，在没有DNSStubListener的情况下无法工作。

2. 激活新的resolv.conf文件：

bash
mv /etc/resolv.conf /etc/resolv.conf.backup
ln -s /run/systemd/resolve/resolv.conf /etc/resolv.conf

3. 停止DNSStubListener：

bash
systemctl reload-or-restart systemd-resolved