imthai/adguardhome-unbound-redis

🚀 AdGuard Home + Unbound + Redis

一个结合了https://github.com/AdguardTeam/AdGuardHome%E3%80%81Unbound%EF%BC%88%E5%B8%A6DNS%E9%A2%84%E5%8F%96%E5%8A%9F%E8%83%BD%EF%BC%89%E5%92%8CRedis%E4%BD%9C%E4%B8%BA%E5%86%85%E5%AD%98%E7%BC%93%E5%AD%98%E5%B1%82%E7%9A%84Docker%E5%AE%B9%E5%99%A8%EF%BC%8C%E4%B8%93%E4%B8%BA%E9%80%9F%E5%BA%A6%E3%80%81%E9%9A%90%E7%A7%81%E5%92%8C%E6%80%A7%E8%83%BD%E8%80%8C%E6%9E%84%E5%BB%BA%E3%80%82

该镜像支持多架构，原生支持amd64（个人电脑、Unraid服务器）和arm64（树莓派、Apple M系列等）平台。

🔍 为何选择此配置？

✅ Unbound带预取功能的优势：

• 更快的DNS解析：主动解析并缓存频繁访问的DNS记录。
• 更低的延迟：减少DNS查询导致的延迟，对延迟敏感型应用尤其有用。
• 更好的网络性能：预取的响应立即可用，减少等待时间。

🧠 使用Redis的优势：

• 内存级速度：Redis将DNS结果缓存在内存中，提供近乎即时的检索。
• 更高的吞吐量：减轻上游服务器的重复DNS请求负担。
• 减少负载：最小化外部DNS查询的数量。
• 可靠的缓存：即使在高负载下也能保持快速访问。

🚀 快速启动（docker-compose）

以下是一个示例docker-compose.yml文件，帮助您快速开始。

yaml
version: "3.8"
services:
  adguard-dns:
    image: imthai/adguardhome-unbound-redis:latest
    container_name: adguard-dns
    # 建议使用专用IP（macvlan/ipvlan）
    # 若使用桥接模式，请映射必要端口：
    ports:
      - "53:53/tcp"
      - "53:53/udp"
      - "3000:3000/tcp" # AdGuard Web UI端口
    volumes:
      # /config是所有配置和数据的主卷
      - ./config:/config
    restart: unless-stopped

⚙️ 配置和路径

🔷 Unraid用户注意事项

此容器专为Unraid优化，使用时请注意：

1. 添加容器时，将容器路径/config映射到appdata中的目标主机路径，例如/mnt/user/appdata/adguard-unbound-redis/
2. 强烈建议为容器分配专用IP（如br0.100），因为端口53通常会被Unraid/Docker占用。

📂 文件结构

所有配置都持久化在您映射到/config的卷中。首次运行后，该文件夹将包含以下内容：

默认设置：

• AdGuard Home Web UI：http://<您的IP>:3000
• 默认凭据：admin / admin

🌐 DNS配置

默认情况下，Unbound设置为将所有DNS请求转发到公共解析器。当前使用Cloudflare DNS。

• 您可以在./unbound/forward-queries.conf文件中修改此行为。
• 预定义了其他DNS提供商，可自定义或添加。
• 要启用完全递归解析（Unbound直接查询根服务器），只需删除forward-queries.conf文件并重启容器。

📂 自定义用户过滤器

您可以通过将自定义过滤blockList文件放置在/config/userfilters/文件夹中来添加到容器中。

重要：
要让AdGuard Home读取您的自定义过滤器文件，必须确保配置文件（./AdGuardHome/AdGuardHome.yaml）包含：

yaml
safe_fs_patterns:
  - /config/userfilters/*

您有两种选择：

• 选项1：手动更新
  编辑AdGuardHome.yaml，添加或更新上述safe_fs_patterns部分，然后重启容器。

• 选项2：自动生成新配置
  删除（或移动）现有AdGuardHome.yaml配置文件并重启容器。容器将默认创建包含正确safe_fs_patterns条目的新配置文件。
  ⚠️ 警告：这会重置您所有的AdGuard Home设置！

之后：
在AdGuard Home的Web UI（过滤器 → DNS阻止列表）中添加本地阻止列表，指定文件路径，例如：/config/userfilters/myblocklist.txt。

🚫 默认启用的阻止列表

• https://github.com/AdguardTeam/AdguardSDNSFilter
• https://github.com/hagezi/dns-blocklists?tab=readme-ov-file#tif
• https://github.com/hagezi/dns-blocklists?tab=readme-ov-file#pro

享受这个一体化Docker解决方案带来的更快、更智能、更私密的DNS体验！🛡️⚡