手动在腾讯云锐驰服务器（Debain12）上搭建 AdGuard Home

在 Debian 12 上安装 AdGuard Home 有两种主流方式：Docker 安装和二进制文件安装。Docker 方式更简单且能避免环境冲突，特别推荐给新手；二进制安装则更直接。下面我为你详细说明这两种方法。

下面是两种安装方式的对比，帮你快速了解核心区别：

🐳 Docker 方式安装

如果你的系统还没有安装 Docker，需要先执行以下命令进行安装：

sudo apt update
sudo apt install -y docker.io
sudo systemctl start docker
sudo systemctl enable docker

安装并启动 Docker 后，就可以部署 AdGuard Home 了。

1. 拉取镜像 从 Docker Hub 获取最新的 AdGuard Home 镜像。

   sudo docker pull adguard/adguardhome

2. 创建数据目录 为了持久化保存你的配置和数据（即使容器删除也不会丢失），需要在宿主机上创建目录。

   sudo mkdir -p /opt/adguardhome/work
   sudo mkdir -p /opt/adguardhome/conf

运行容器 使用 docker run 命令启动 AdGuard Home 容器。下面的命令映射了必要的端口。

sudo docker run -d \
    --name adguardhome \
    --restart unless-stopped \
    -v /opt/adguardhome/work:/opt/adguardhome/work \
    -v /opt/adguardhome/conf:/opt/adguardhome/conf \
    -p 53:53/tcp -p 53:53/udp \
    -p 3000:3000/tcp \
    -p 80:80/tcp -p 443:443/tcp -p 443:443/udp \
    adguard/adguardhome

参数说明：

• -v ...: 将容器内的配置和数据目录挂载到宿主机。

• -p 53:53/...: 映射 DNS 服务端口（核心端口）。

• -p 3000:3000/tcp: 映射 Web 管理界面端口。

• -p 80:80/tcp -p 443:443/tcp: 映射这些端口可用于 AdGuard Home 的 DoH（DNS over HTTPS）等服务。

• --restart unless-stopped: 设置容器自动重启，确保服务稳定。

• -d: 让容器在后台运行。

⚙️ 二进制文件安装

如果你选择二进制方式，操作步骤如下：

下载并解压 前往 AdGuard Home 的 GitHub Releases 页面查找适用于 linux_amd64 的最新版本链接，然后下载解压。

# 示例版本，请替换为最新的稳定版链接
wget https://static.adguard.com/adguardhome/release/AdGuardHome_linux_amd64.tar.gz
tar xvf AdGuardHome_linux_amd64.tar.gz
cd AdGuardHome

解决端口冲突（常见问题） 在安装前，需要确保系统的 53 端口 没有被占用。AdGuard Home 需要独占此端口。

# 检查 53 端口是否被占用
sudo netstat -tulpn | grep ':53 '

如果发现被 systemd-resolved 等服务占用，需要先停止并禁用它们：

sudo systemctl stop systemd-resolved
sudo systemctl disable systemd-resolved

注意：禁用系统解析服务可能会暂时影响部分系统网络查询，但安装 AdGuard Home 后即会接管 DNS 解析工作。

安装并启动服务 进入解压后的目录，执行安装命令将其注册为系统服务。

sudo ./AdGuardHome -s install

安装后，使用 systemctl 命令来管理服务：

sudo systemctl start AdGuardHome  # 启动服务
sudo systemctl enable AdGuardHome # 设置开机自启
sudo systemctl status AdGuardHome # 查看服务状态

🛠️ 初始配置

无论采用哪种安装方式，后续的配置步骤都是一样的。

1. 访问管理界面：在浏览器中打开 http://<你的 Debian 服务器IP地址>:3000，你将看到 AdGuard Home 的初始设置向导。

2. 完成向导：

配置网络接口和端口：通常保持默认设置即可。

设置管理员账户：为 Web 管理界面设置一个用户名和密码，请务必牢记。

设置上游 DNS 服务器：这是 AdGuard Home 查询最终域名答案的服务器。建议选择速度快、隐私性好的 DNS，例如：

119.29.29.29       # DNSPod
223.5.5.5          # 阿里 DNS
8.8.8.8            # Google DNS
1.1.1.1            # Cloudflare DNS
tls://dns.adguard-dns.com  # AdGuard 的加密 DNS

1. 配置设备 DNS：安装配置完成后，最关键的一步是将你网络内设备（如电脑、手机）的 DNS 服务器地址设置为 AdGuard Home 所在 Debian 服务器的 IP 地址。这样，所有设备的 DNS 查询请求就会经过 AdGuard Home 进行过滤。

💡 使用建议

• 添加拦截规则：在 AdGuard Home 管理后台的 过滤器 > DNS 封锁清单 中，可以添加更多规则（如 AdGuard DNS filter、OISD 等）来增强广告拦截效果。

• 性能调优：在 设置 > DNS 设置 中，可以启用 并行请求 以提升解析速度，并适当调整缓存大小。