pluim003/pihole-unbound

Pi-Hole + Unbound Docker镜像

镜像概述

本镜像为Pi-Hole与Unbound的单容器集成方案，基于Chris Crowe（cbcrowe）的仓库分叉开发，旨在提供更及时的更新和功能增强。该镜像将Unbound直接安装到Pi-Hole容器中，确保使用最新版本的Unbound解析器，而非系统包管理器中的旧版本，从而提供更优的DNS解析性能和安全性。

核心功能与特性

1. 单容器集成

• Unbound直接安装在Pi-Hole容器内，无需额外容器部署，简化架构与维护。

2. 最新Unbound版本

• 通过添加Debian测试分支（bookworm）到软件源，确保安装最新可用的Unbound版本：
  • 2022年10月14日：Unbound 1.17.0
  • 2023.02.0版本起：Unbound 1.17.1
  • 2024.07.0版本起：Unbound 1.21.1（2024.05.0为最后使用1.17.1的版本）

3. 版本标签策略

• 当Unbound发布新版本时，镜像将以<Pihole-docker-tag>_<日期>格式打标签，便于区分Unbound版本更新（即使Pi-Hole基础标签相同）。

4. "nightly"标签说明

• 原"nightly"标签基于Pi-Hole Docker镜像的 nightly 构建版本，但由于Pi-Hole nightly构建改用Alpine Linux，导致Unbound集成困难，目前（2024年10月6日）"nightly"标签与2024.07.0版本内容一致，且已暂停更新。

使用场景与适用范围

• 家庭网络广告拦截：结合Pi-Hole的广告拦截功能与Unbound的本地DNS解析，提升网络浏览体验。
• 本地DNS解析：通过Unbound提供递归DNS解析，减少对第三方DNS服务的依赖，增强隐私保护。
• 小型网络环境：适用于家庭、小型办公室等场景，简化部署与管理。

使用方法与配置说明

基本部署

由于本镜像基于Pi-Hole官方镜像扩展，基本部署方式可参考Pi-Hole官方文档，核心需注意以下配置：

Docker Run示例

bash
docker run -d \
  --name pihole-unbound \
  -p 53:53/tcp -p 53:53/udp \
  -p 80:80 \
  -e TZ="Asia/Shanghai" \
  -e WEBPASSWORD="your_secure_password" \
  -v /path/to/pihole/etc-pihole:/etc/pihole \
  -v /path/to/pihole/etc-dnsmasq.d:/etc/dnsmasq.d \
  --restart=unless-stopped \
  <镜像标签>

Docker Compose示例

yaml
version: "3"
services:
  pihole-unbound:
    image: <镜像标签>
    container_name: pihole-unbound
    ports:
      - "53:53/tcp"
      - "53:53/udp"
      - "80:80"
    environment:
      - TZ=Asia/Shanghai
      - WEBPASSWORD=your_secure_password
    volumes:
      - /path/to/pihole/etc-pihole:/etc/pihole
      - /path/to/pihole/etc-dnsmasq.d:/etc/dnsmasq.d
    restart: unless-stopped

关键配置说明

• 端口映射：需映射53端口（DNS）和80端口（Web管理界面）。
• 环境变量：
  • TZ：设置时区，如"Asia/Shanghai"。
  • WEBPASSWORD：Pi-Hole Web界面登录密码。
• 数据持久化：通过挂载/etc/pihole和/etc/dnsmasq.d目录，确保配置和数据持久化。

版本选择

• 选择特定版本标签（如<Pihole-docker-tag>_<日期>）以明确使用的Unbound版本，例如使用最新Unbound的标签可确保获得最新解析功能与安全更新。