mvance/unbound-rpi

Unbound DNS解析器（树莓派Docker镜像）

镜像概述

本Docker镜像专为树莓派（Raspberry Pi）架构设计，用于快速部署Unbound DNS解析器，并集成最新版本的OpenSSL库。Unbound是一款轻量、安全的递归DNS解析器，结合OpenSSL可提供加密DNS查询能力（如DNS over TLS），适用于构建本地DNS服务器或缓存节点。

核心功能与特性

• Unbound DNS解析器：提供高效的递归DNS查询、缓存功能，支持DNSSEC验证，增强域名解析的真实性与完整性。
• 最新OpenSSL集成：集成当前最新稳定版OpenSSL，支持TLS 1.3等现代加密协议，保障DNS查询过程中的数据传输安全。
• 树莓派架构优化：针对ARM架构（树莓派主流架构）编译，确保在树莓派设备上高效运行。
• Docker化部署：通过容器化封装，简化部署流程，隔离运行环境，便于版本管理与升级。
• 可定制配置：支持挂载外部配置文件，灵活调整Unbound的解析规则、缓存策略、加密设置等。

使用场景

• 家庭网络DNS服务器：在家庭网络中部署，替代公共DNS服务，提升DNS查询速度并过滤***域名。
• 本地DNS缓存节点：减少重复DNS查询的网络延迟，提升局域网内设备的域名解析效率。
• 增强DNS安全场景：通过DNSSEC验证与加密DNS（如DoT），防范DNS劫持、缓存投毒等***。
• 树莓派嵌入式应用：作为树莓派家庭服务器、智能家居网关的配套DNS组件，提供本地化网络服务。

使用方法

基本运行

通过以下命令在树莓派上启动容器（需提前安装Docker）：

bash
docker run -d \
  --name unbound-rpi \
  --restart unless-stopped \
  -p 53:53/udp \
  -p 53:53/tcp \
  -v /path/to/unbound/config:/etc/unbound \
  -v unbound-data:/var/lib/unbound \
  docker.xuanyuan.run/your-image-name:latest

参数说明：

• -p 53:53/udp与-p 53:53/tcp：映射容器内Unbound服务的53端口（DNS标准端口）到主机，支持UDP（主要）与TCP（大查询包）协议。
• -v /path/to/unbound/config:/etc/unbound：挂载主机上的Unbound配置文件目录（需提前创建并配置unbound.conf），用于自定义解析规则、加密设置等。
• -v unbound-data:/var/lib/unbound：挂载数据卷以持久化Unbound的缓存数据与运行状态。

配置说明

1. 配置文件结构：主机挂载的/path/to/unbound/config目录需包含至少unbound.conf主配置文件，可根据需求添加forward-zone（转发规则）、tls-cert-bundle（CA证书）等配置段。

   示例unbound.conf片段（启用DNSSEC与基本转发）：

   conf
   server:
     verbosity: 1
     interface: 0.0.0.0
     port: 53
     do-ip4: yes
     do-udp: yes
     do-tcp: yes
     dnssec-enable: yes
     dnssec-validation: yes
   
   forward-zone:
     name: "."
     forward-addr: 8.8.8.8  # 上游DNS服务器（如Google DNS）
     forward-addr: 8.8.4.4
   

2. 权限设置：确保主机配置目录权限允许容器内用户读取（建议设置权限为755，所有者为root:root）。

环境变量

目前镜像支持以下可选环境变量（通过-e参数传递）：

• UNBOUND_VERBOSITY：日志详细程度，默认值1（0=安静，5=调试）。
• DNSSEC_VALIDATION：是否启用DNSSEC验证，默认yes，可选no。
• FORWARD_ADDR：默认上游DNS服务器地址，多个地址用逗号分隔（如8.8.8.8,8.8.4.4）。

维护与升级

• 查看日志：docker logs -f unbound-rpi
• 重启容器：docker restart unbound-rpi
• 升级镜像：

  bash
  docker pull docker.xuanyuan.run/your-image-name:latest
  docker stop unbound-rpi && docker rm unbound-rpi
  # 重新运行docker run命令启动新版本容器
  

注意事项

• 树莓派需运行支持Docker的操作系统（如Raspberry Pi OS with Desktop/Server）。
• 宿主机53端口需确保未被其他服务（如systemd-resolved）占用，否则需调整端口映射或停止冲突服务。
• 首次启动时，Unbound会生成必要的加密密钥，可能需要数秒时间完成初始化。