mpgirro/pihole-unbound

镜像概述和主要用途

本Docker镜像将Pi-Hole（网络广告拦截工具）与Unbound（轻量级DNS解析器）集成在单个容器中，旨在简化部署流程，同时提供广告拦截和本地DNS解析能力。通过整合两个工具的功能，用户无需分别部署服务即可实现网络广告过滤、DNS查询管理及增强的DNS隐私保护。

核心功能和特性### 1. 广告拦截与网络管理

• Pi-Hole核心功能：拦截网页广告、***域名及跟踪器，支持自定义拦截规则
• 网络统计：实时监控网络流量、客户端请求及拦截效果，提供可视化数据报表
• 客户端管理：支持按设备IP或MAC地址设置自定义过滤策略

2. 本地DNS解析与安全增强

• Unbound DNS解析：提供本地递归DNS解析，减少对第三方DNS服务器的依赖
• DNSSEC支持：验证DNS数据完整性，防止DNS缓存投毒***
• 隐私保护：避免DNS查询数据泄露至外部服务，增强网络隐私

3. 容器化优势

• 单容器部署：无需单独配置Pi-Hole和Unbound，简化部署步骤
• 资源优化：共享容器资源，降低系统内存和CPU占用
• 跨平台兼容：支持x86_64、ARM等架构，适用于树莓派等嵌入式设备

使用场景和适用范围

• 家庭网络环境：为所有联网设备（电脑、手机、智能家电）提供广告拦截
• 小型办公网络：统一管理网络广告过滤策略，提升工作效率
• 隐私敏感场景：通过本地DNS解析减少第三方依赖，保护用户上网隐私
• 嵌入式设备部署：适用于资源受限的设备（如树莓派），实现轻量级网络管理

使用方法和配置说明### 前置要求

• Docker引擎（20.10+版本推荐）
• 网络权限：容器需访问互联网以更新广告规则和DNS根服务器信息

快速启动（docker run）

bash
docker run -d \
  --name pihole-unbound \
  -p 53:53/tcp -p 53:53/udp \  # DNS服务端口
  -p 80:80/tcp \                # Pi-Hole管理界面端口
  -e WEBPASSWORD="your_secure_password" \  # Pi-Hole管理密码（必填）
  -e TZ="Asia/Shanghai" \       # 时区设置（如Asia/Shanghai）
  -v pihole_data:/etc/pihole \  # Pi-Hole数据持久化
  -v unbound_data:/etc/unbound \# Unbound配置持久化
  --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/tcp"
    environment:
      - WEBPASSWORD=your_secure_password  # 管理界面密码
      - TZ=Asia/Shanghai                  # 时区
      - PIHOLE_DNS_1=127.0.0.1#5335       # 指向容器内Unbound服务（默认配置）
      - ServerIP=192.168.1.100            # 服务器IP（可选，自动检测）
    volumes:
      - pihole_data:/etc/pihole
      - unbound_data:/etc/unbound
    restart: unless-stopped

volumes:
  pihole_data:
  unbound_data:

关键配置参数#### 环境变量

数据卷挂载

服务验证与管理#### 访问管理界面

启动容器后，通过浏览器访问 http://<容器IP或主机IP>:80，使用 WEBPASSWORD 登录Pi-Hole管理界面，可配置拦截规则、查看客户端统计及DNS查询日志。

验证DNS服务

• 测试DNS解析：
  nslookup example.com <容器IP> 或 dig @<容器IP> example.com
• 验证广告拦截：
  访问含广告的网站（如 https://www.example.com），确认广告内容被屏蔽
• 检查Unbound状态：
  查看容器日志：docker logs pihole-unbound，确认Unbound服务正常启动（关键词：unbound: started）

注意事项

• 端口冲突：确保主机53（DNS）和80（HTTP）端口未被其他服务占用
• 网络权限：容器需具备互联网访问权限以更新广告规则（https://raw.githubusercontent.com）
• 规则更新：Pi-Hole默认每日自动更新拦截规则，可在管理界面手动触发更新
• 备份策略：定期备份 /etc/pihole 和 /etc/unbound 数据卷，防止配置丢失