在服务器上安装AdGuardHome需要遵循一定的步骤,并确保环境满足其运行需求。以下是详细的安装与配置指南:

AdGuardHome简介
AdGuardHome是一款基于Go语言开发的本地DNS过滤工具,能够实现广告拦截、恶意软件过滤、内容分级等功能。它通过自定义规则和过滤列表,有效减少网络流量中的冗余数据,提升设备运行效率,同时增强网络安全防护能力。
系统要求
AdGuardHome支持多种操作系统,包括Linux(Debian/Ubuntu/CentOS)、macOS和Windows。以下是不同系统的最低要求:
| 系统类型 | 最低版本 | 额外依赖 |
|---|---|---|
| Linux (Debian/Ubuntu) | Ubuntu 16.04 或更高版本 | Go语言环境、glibc |
| Linux (CentOS/RHEL) | CentOS 7 或更高版本 | Go语言环境、glibc |
| macOS | macOS 10.12 或更高版本 | Go语言环境 |
| Windows | Windows 10 64位 | 无 |
安装步骤
以下是基于Linux系统的安装流程,其他系统可参考官方文档调整:
下载安装包
访问AdGuardHome官网https://adguardhome.com/download,选择对应系统的安装包。以Debian/Ubuntu为例,使用命令下载:
curl -fsSL https://raw.githubusercontent.com/AdguardTeam/AdGuardHome/master/script/install.sh | sh
配置服务
安装完成后,默认会以守护进程方式运行。通过以下命令查看服务状态:
systemctl status adguardhome
修改配置文件,路径通常为/etc/adguardhome/settings.yaml,可自定义过滤规则、DNS端口等参数。
启动服务
运行命令启动AdGuardHome服务:
systemctl start adguardhome
设置开机自启:
systemctl enable adguardhome
访问管理界面
浏览器打开http://服务器IP:3000,使用默认账户(admin/admin)登录,根据提示完成初始配置。
常用命令
以下命令可用于日常管理:
| 命令 | 功能 |
|---|---|
systemctl restart adguardhome |
重启服务 |
systemctl stop adguardhome |
停止服务 |
adguardhome -h |
查看帮助信息 |
adguardhome --config /path/to/config.yaml |
指定自定义配置文件 |
网络配置
为确保AdGuardHome能有效拦截广告,需配置以下网络参数:
设置DNS转发:将服务器的DNS指向AdGuardHome的本地端口(默认3000),并通过iptables或nftables规则将流量重定向。
启用IPv6支持(如需):修改配置文件中的dns.ListenIPv6参数为true。
调整防火墙规则:开放3000端口以允许管理访问,如使用UFW可添加规则:
ufw allow 3000/tcp
高级功能配置
AdGuardHome支持自定义过滤策略,包括:
1. 规则列表管理
可通过管理界面添加或删除过滤规则,例如:
Ads拦截:启用默认的EasyList规则。
内容过滤:配置SafeSearch、Torrent等过滤器。
自定义规则:上传自定义过滤规则文件(如hosts.txt)。
2. 用户管理
在管理界面中创建用户,分配网络访问权限,实现多设备差异化过滤策略。
常见问题及解决方案
安装过程中可能出现的问题及处理方法:
| 问题 | 解决方案 |
|---|---|
| 服务启动失败 | 检查日志文件(/var/log/adguardhome/adguardhome.log),确认是否缺少依赖或端口冲突。 |
| 无法访问管理界面 | 确保防火墙未阻止3000端口,或尝试更换端口后重新启动服务。 |
| 规则未生效 | 确认规则文件格式正确,且已成功上传至服务端。检查DNS解析是否正常。 |
| 占用过多内存 | 优化规则列表,移除不必要过滤器;调整服务配置中的memoryUsage参数。 |
注意事项
1. 确保服务器有稳定的网络连接,以避免过滤功能异常。
2. 定期更新规则列表(如通过https://adguardteam.github.io/AdGuardHome/changelog/获取最新版本)。
3. 若需在内网中使用,建议通过局域网DNS设置或路由器重定向流量。

查看详情

查看详情