sujiba/pihole-unbound-hyperlocal

Pi-hole-Unbound-Hyperlocal Docker镜像文档

镜像概述

本Docker镜像集成了Pi-hole、Unbound和Hyperlocal三个组件，旨在为本地网络提供一站式DNS解决方案。Pi-hole作为网络级广告和***域名拦截工具，Unbound作为安全递归DNS解析器，结合Hyperlocal的本地化配置管理能力，可实现高效广告过滤、隐私保护及本地网络DNS服务优化。

核心功能和特性

1. 广告与***内容拦截

• 基于Pi-hole核心功能，自动屏蔽广告、跟踪器及***域名
• 支持自定义黑白名单，灵活管理拦截规则
• 提供Web界面统计与监控拦截效果

2. 安全DNS递归解析

• 集成Unbound递归DNS解析器，直接从根域名服务器获取解析结果，避免第三方DNS服务依赖
• 支持DNSSEC验证，防止DNS缓存投毒***
• 优化解析速度，减少解析延迟

3. 本地化DNS服务管理

• Hyperlocal组件提供本地网络DNS配置优化
• 支持本地设备IP与域名绑定（本地DNS记录）
• 适配家庭/小型网络环境的本地化服务发现

4. 易用性与可扩展性

• 容器化部署，简化安装与升级流程
• 支持数据持久化存储，配置与统计数据不丢失
• 兼容主流Docker环境及Docker Compose编排

使用场景

• 家庭网络环境：为家庭设备提供广告拦截、隐私保护DNS服务
• 小型办公室网络：屏蔽工作环境中的干扰广告，提升网络安全性
• 开发测试环境：快速部署本地DNS服务，模拟特定域名解析场景
• 边缘计算节点：在边缘设备（如树莓派）上部署，提供本地化网络服务

使用方法

基本部署（Docker Run）

bash
docker run -d \
  --name pihole-unbound-hyperlocal \
  -p 53:53/tcp -p 53:53/udp \  # DNS服务端口
  -p 80:80/tcp \                # Pi-hole Web管理界面端口
  -e TZ="Asia/Shanghai" \       # 设置时区
  -e WEBPASSWORD="your_secure_password" \  # Pi-hole Web界面密码
  -v /path/to/pihole-data:/etc/pihole \    # Pi-hole数据持久化
  -v /path/to/unbound-config:/etc/unbound \ # Unbound配置持久化
  --restart=unless-stopped \
  sujiba/pihole-unbound-hyperlocal:latest

Docker Compose部署

创建docker-compose.yml文件：

yaml
version: '3'
services:
  pihole-unbound-hyperlocal:
    image: sujiba/pihole-unbound-hyperlocal:latest
    container_name: pihole-unbound-hyperlocal
    ports:
      - "53:53/tcp"
      - "53:53/udp"
      - "80:80/tcp"
    environment:
      - TZ=Asia/Shanghai
      - WEBPASSWORD=your_secure_password
      - PIHOLE_DNS_1=127.0.0.1#5335  # 指向Unbound解析器
      - DNSSEC=true  # 启用DNSSEC
    volumes:
      - ./pihole-data:/etc/pihole
      - ./unbound-config:/etc/unbound
      - ./hyperlocal-config:/etc/hyperlocal  # Hyperlocal配置目录
    restart: unless-stopped

启动命令：

bash
docker-compose up -d

配置说明

核心环境变量

持久化目录

访问与管理

• Pi-hole Web管理界面：http://<容器IP或主机IP>/admin
• 默认用户名：admin
• 密码：通过WEBPASSWORD环境变量设置或容器日志中获取

注意事项

• 部署时需确保主机53端口（DNS）和80端口（Web界面）未被其他服务占用
• 首次启动后建议通过Web界面更新Pi-hole Gravity列表以获取最新拦截规则
• 如需自定义Unbound解析规则，可修改unbound-config目录下的unbound.conf文件

详细配置与高级用法请参考官方文档：https://github.com/sujiba/pihole-unbound-hyperlocal