iStoreOS广告过滤插件AdGuard Home部署完整指南

📚 目录导航

1. 🚀 工具简介与核心价值
2. 📥 一、下载并安装 AdGuard Home
3. ⚙️ 二、AdGuard Home 初始化配置
4. 🔧 三、AdGuard Home 核心功能配置
5. 💡 四、使用技巧与常见问题解决
6. 🗑️ 五、卸载 AdGuard Home 与残留清理
7. 🎯 总结与维护建议

🚀 工具简介与核心价值

• 🛡️ 全网广告拦截：覆盖视频广告、网页弹窗、App 开屏广告等，支持自定义拦截规则；
• 🔒 强化隐私保护：阻止第三方跟踪器收集上网行为数据，拦截恶意网站与钓鱼链接；
• ⚡ DNS 加速优化：通过配置优质上游 DNS，提升域名解析速度，改善网络访问体验；
• 📊 详细数据统计：记录 DNS 查询量、广告拦截数量、设备上网行为等核心数据；
• 🎯 灵活家长控制：可过滤不良内容，设置设备上网时间限制，守护家庭上网安全。

📥 一、下载并安装 AdGuard Home

1. 下载适配安装包

• 官方下载地址：AdGuard Home GitHub Releases
• 关键注意事项：需根据路由器硬件架构选择对应版本（常见架构：x86_64、aarch64、armv7 等），可通过 iStoreOS 后台「系统→系统信息」查看设备架构。

2. 安装步骤（图形化操作）

1. 登录 iStoreOS 管理后台（默认地址：http://192.168.100.1，具体以实际配置为准）；
2. 进入顶部菜单「软件包管理」（部分版本为「iStore→本地安装」）；
3. 点击「上传安装包」，选择下载好的 AdGuard Home 安装文件（后缀通常为 .ipk 或 .tar.gz）；
4. 点击「安装」，等待页面提示「安装完成」（过程中确保路由器网络稳定，切勿中断操作）。

⚙️ 二、AdGuard Home 初始化配置

1. 启动 AdGuard Home 服务

• 安装完成后，进入 iStoreOS 后台「服务」菜单，找到「AdGuard Home」，点击「启动」；
• 启动前检查：确保路由器网络正常，防火墙未拦截 3000 端口（初始化配置端口）和 53 端口（DNS 服务端口）。

2. 解决 DNS 端口冲突（关键步骤）

1. 进入 iStoreOS 后台「网络→DHCP/DNS→高级设置」；
2. 找到「DNS 服务器端口」，将默认的 53 改为其他未占用端口（推荐 5353）；
3. 点击「保存并应用」，完成系统 DNS 端口调整。

3. 网页端初始化设置

1. 打开浏览器，访问地址：http://iStoreOS-IP地址:3000（将「iStoreOS-IP 地址」替换为路由器实际 LAN 口 IP，如 192.168.1.1）；
2. 进入初始化向导，按提示完成基础配置：
   • 网页管理界面端口：默认 3000（可自定义，建议保留默认）；
   • DNS 服务端口：默认 53（无需修改，已提前调整系统 DNS 端口避免冲突）；
   • 管理员账号设置：创建用户名和密码（用于登录 AdGuard Home 管理后台）；
3. 点击「完成」，进入 AdGuard Home 主管理界面。

🔧 三、AdGuard Home 核心功能配置

1. 上游 DNS 服务器配置（优化解析速度与隐私）

223.5.5.5
119.29.29.29
https://dns.alidns.com/dns-query
https://doh.pub/dns-query
https://dns.cloudflare.com/dns-query

• 配置步骤：
  1. 进入 AdGuard Home 管理后台「设置→DNS 设置→上游 DNS 服务器」；
  2. 清空默认内容，粘贴上述 DNS 地址，点击「保存」；
• 各 DNS 说明：
  • 223.5.5.5（阿里公共 DNS）：国内响应速度快，解析准确；
  • 119.29.29.29（腾讯公共 DNS）：稳定性强，支持恶意域名过滤；
  • DoH 加密 DNS（如 cloudflare）：通过 HTTPS 加密 DNS 查询，防止被监听，提升隐私保护。

2. DNS 黑名单配置（核心广告拦截功能）

1. 进入 AdGuard Home 管理后台「过滤器→DNS 黑名单」；
2. 配置方式：
   • 导入第三方过滤列表（推荐）：点击「添加过滤器」，粘贴知名过滤列表链接（如 EasyList、AdGuard DNS 过滤列表），开启自动更新；
   • 自定义规则：点击「添加规则」，输入需拦截的域名（如 *.ad.com），选择拦截类型（默认「拒绝」即可）；
3. 点击「保存并应用」，规则立即生效。

3. 可选配置：DHCP 服务（实现自动分发 DNS）

1. 进入 AdGuard Home 管理后台「设置→DHCP 设置」；
2. 开启「DHCP 服务器」，配置网段（需与路由器 LAN 口网段一致，如 192.168.1.0/24）、网关（路由器 LAN 口 IP）、DNS 服务器（填写路由器 LAN 口 IP，即 AdGuard Home 所在 IP）；
3. 关闭 iStoreOS 自带 DHCP 服务（「网络→DHCP/DNS」中关闭），避免冲突；
4. 点击「保存」，设备重新联网后即可自动获取 AdGuard DNS。

💡 四、使用技巧与常见问题解决

1. 性能优化建议

• 定期更新过滤规则：进入「过滤器→DNS 黑名单」，点击「更新所有过滤器」，确保广告拦截效果；
• 监控系统资源：在 iStoreOS 后台「状态→系统信息」查看 CPU、内存占用，若资源紧张可减少过滤列表数量；
• 备份配置：进入 AdGuard Home 管理后台「设置→备份与恢复」，导出配置文件，避免重装后重复设置。

2. 常见问题解决

• 无法访问 AdGuard Home 管理界面：
  1. 检查路由器 IP 是否正确，端口 3000 是否被防火墙拦截；
  2. 若端口被占用，可进入 iStoreOS 后台「服务→AdGuard Home」，修改管理端口后重启服务。
• DNS 解析失败：
  1. 验证上游 DNS 服务器可用性（可在 AdGuard Home 「查询日志」中查看解析状态）；
  2. 检查网络是否正常，关闭路由器防火墙后重试。
• 广告拦截失效：
  1. 更新过滤规则，清除设备 DNS 缓存；
  2. 检查是否有设备手动设置了其他 DNS，需改为自动获取或指定路由器 IP 为 DNS。

🗑️ 五、卸载 AdGuard Home 与残留清理

1. 登录 iStoreOS 管理后台，进入「系统→软件包」；
2. 在「已安装」标签页搜索「adguard」或「AdGuardHome」，找到对应安装包（通常为 adguardhome 或 luci-app-adguardhome）；
3. 点击包右侧「移除」，等待页面提示「卸载完成」；
4. 重启路由器（可选但推荐），确保端口和服务完全释放；
5. 残留检查与恢复：
   • 确认「服务」菜单中无 AdGuard Home 入口；
   • 检查关键端口是否释放：通过 SSH 登录路由器，执行命令 netstat -lnp | grep -E ':53|:3000|:8080'，无返回即正常；
   • 恢复系统 DNS 端口：进入「网络→DHCP/DNS→高级设置」，将「DNS 服务器端口」改回 53 并保存。

🎯 总结与维护建议

• 每周更新一次过滤规则，每月备份一次配置；
• 定期查看 AdGuard Home 「统计」页面，了解广告拦截数量与设备上网情况；
• 若路由器性能较弱，可适当精简过滤列表，优先保留核心广告拦截规则。