安装
方式一:使用 Docker 部署
记得先放行 TCP/UDP 的 3000、853、53、443 等端口。
先拉取 AdGuard Home 镜像:docker pull adguard/adguardhome:latest
执行下面的命令安装并运行:
docker run -d \
--name adguardhome \
--restart unless-stopped \
--log-opt max-size=1m \
--network host \
-v $PWD/adguardhome/work:/opt/adguardhome/work \
-v $PWD/adguardhome/conf:/opt/adguardhome/conf \
adguard/adguardhome
方式二:手动下载程序安装
前往 GitHub 下载:AdGuardHome Releases
在版本列表中找到对应服务器架构的程序文件并下载。我的是 armv7l。

扩展:如何查看Linux服务器架构?
在终端执行
uname -m即可查看,例如下图:
将下载的文件上传到服务器并解压。
例如我把文件上传到 /mnt/App 目录:先进入该目录 cd /mnt/App,再解压 tar xvf ./AdGuardHome_linux_armv7.tar.gz,最后删除压缩包 rm ./AdGuardHome_linux_armv7.tar.gz。

进入 AdGuardHome 文件夹执行安装程序。
# 下列安装命令二选一:
# 执行安装程序
./AdGuardHome --service install
# 执行安装程序并自启动(推荐)
sudo ./AdGuardHome -s install
# 启动程序
./AdGuardHome -s start
方式三:一键安装脚本
直接执行下面的命令即可完成上述步骤,并自动安装启动。
wget --no-verbose -O - https://raw.githubusercontent.com/AdguardTeam/AdGuardHome/master/scripts/install.sh | sh -s -- -v
服务控制命令
# 扩展命令
./AdGuardHome -s uninstall #卸载 AdGuard Home 服务。
./AdGuardHome -s start #启动服务。
./AdGuardHome -s stop #停止服务。
./AdGuardHome -s restart #重新启动服务。
./AdGuardHome -s status #显示当前服务状态。
打开初始化页面

随后可通过终端给出的 ip+端口 打开 Web 入口,我这里为 http://192.168.3.28:3000。
如果网页打不开,先在防火墙放行 3000 端口,或直接重启服务器:sudo reboot

随后开始初始配置。
网页管理页面 端口改为 3000;DNS服务器端口 保持默认 53,若被占用可改用 5353。

如果选用 53 端口时,DNS 服务器下方出现 validating ports: listen tcp 0.0.0.0: 53: bind: address already in use,说明 53 端口已被占用,可用下面的命令释放:
# 查找占用端口的进程
sudo lsof -i :53
# 我这显示systemd-resolve用了53端口:
root@onecloud:/mnt/App/AdGuardHome# sudo lsof -i :53
COMMAND PID USER FD TYPE DEVICE SIZE/OFF NODE NAME
systemd-r 439 systemd-resolve 17u IPv4 3536 0t0 UDP 127.0.0.53:domain
systemd-r 439 systemd-resolve 18u IPv4 3537 0t0 TCP 127.0.0.53:domain (LISTEN)
systemd-r 439 systemd-resolve 19u IPv4 3538 0t0 UDP 127.0.0.54:domain
systemd-r 439 systemd-resolve 20u IPv4 3539 0t0 TCP 127.0.0.54:domain (LISTEN)
# 停止并禁用 systemd-resolved
sudo systemctl stop systemd-resolved
sudo systemctl disable systemd-resolved
配置上游 DNS
进入后点击
设置-DNS设置开始配置
上游DNS服务器
tls://dot.360.cn 114.114.114.114 114.114.115.115 119.28.28.28 119.29.29.29 180.184.1.1 180.184.2.2后备 DNS 服务器填入下边的,Bootstrap DNS 服务器默认即可,然后
应用并测试上游180.76.76.76 114.114.114.114 119.29.29.29 119.28.28.28
只要弹窗
指定的DNS服务器现已正常运行那就对了。DNS服务配置-速度限制改为
0,然后保存。
配置过滤规则
点击
过滤器-DNS黑名单
添加黑名单

可以把下方规则看你自己的选择一个一个填进去

规则:
# 黑名单 https://adrules.top/dns.txt https://adguardteam.github.io/AdGuardSDNSFilter/Filters/filter.txt https://anti-ad.net/easylist.txt 秋风广告规则:https://raw.githubusercontent.com/TG-Twilight/AWAvenue-Ads-Rule/main/AWAvenue-Ads-Rule.txt # 白名单 https://api.ksmlc.cn/AdGuardHome/whitelist.txt
接入设备
配置完成后,可在 设置指导 中查看各平台设备的接入方法。

私人 DNS
先绑定一个域名并申请 SSL 证书(https://app.zerossl.com/)。随后进入 AdGuard Home 的 加密设置 页面,勾选 启用加密 选项,并把 服务器名称 填为该域名;若 443 端口被占用,可将 HTTPS端口 改为 4433;最后将申请到的 SSL 证书和私钥填入证书配置,保存即可。

