一键部署 AdGuard Home

装在你家路由器或NAS上,全家所有设备的广告和追踪器都会被自动挡掉,网页变快,省流量,还能设置不让小孩看不良网站

前置准备

1
一台 Linux 服务器
服务器最低配置:256MB 内存 + 2GB 硬盘,推荐阿里云/腾讯云轻量应用服务器(月费约 ¥40-80)
2
安装部署 Agent
在服务器终端执行一行命令即可安装:
curl -fsSL https://awesome-toolkit.pages.dev/agent/install-agent.sh | bash
!
特别注意事项
  • 部署前请确保服务器的 53 端口没有被其他 DNS 服务占用(比如 systemd-resolved)
  • 如果 53 端口冲突,可以把 DNS 端口映射改为 5353:53/udp

一键部署到你的服务器

在网页上填写服务器 IP 和 Agent Token,自动完成:检测系统 → 拉取镜像 → 启动服务

开始部署向导
💻 或者手动使用 Agent 命令行(高级用户)

🤖 通过 Agent 部署

先安装 Agent,然后通过它一键部署。Agent 会帮你管理所有部署的工具。

步骤 1:安装 Agent

curl -fsSL https://awesome-toolkit.pages.dev/agent/install-agent.sh | bash

步骤 2:部署工具

curl -fsSL https://awesome-toolkit.pages.dev/deploy/install.sh | bash -s -- adguard-home

Agent 会自动完成:检测 Docker → 拉取镜像 → 启动服务,整个过程 3-5 分钟

🎯 部署完成后

🔗
访问地址
http://你的服务器IP:3000
💡
下一步

打开浏览器访问 http://你的服务器IP:3000,完成初始化设置。然后把家里路由器的 DNS 改成这台服务器的 IP 地址,全家的广告都会被自动拦截。

💻 服务器配置要求

256MB
内存
2GB
硬盘
3
端口
3-5分钟
部署耗时

📋 常用管理命令

部署完成后,SSH 进入 ~/awesome-tools/adguard-home 目录,然后运行:

docker compose ps查看运行状态
docker compose logs -f查看实时日志
docker compose restart重启服务
docker compose pull && docker compose up -d更新到最新版本
docker compose down停止服务