unbound-docker新手入门：从安装到运行的完整步骤

unbound-docker新手入门：从安装到运行的完整步骤

【免费下载链接】unbound-dockerUnbound DNS Server Docker Image项目地址: https://gitcode.com/gh_mirrors/unb/unbound-docker

Unbound DNS Server Docker Image（unbound-docker）是一个基于Docker的DNS解析服务器解决方案，它提供了验证、递归和缓存DNS解析功能。本教程将为新手用户提供从安装到运行unbound-docker的完整步骤，帮助你快速搭建自己的DNS服务器。

什么是Unbound DNS Server？

Unbound是一个功能强大的DNS解析器，它具有以下特点：

• 支持DNSSEC验证，增强网络安全性
• 递归查询能力，直接从根域名服务器获取信息
• 本地缓存功能，提高重复查询的响应速度
• 轻量级设计，资源占用低

通过Docker容器化部署Unbound，可以简化安装过程并提高系统兼容性。

准备工作

在开始之前，请确保你的系统已经安装了以下软件：

• Docker Engine（推荐版本19.03或更高）
• Git（用于克隆代码仓库）

如果你还没有安装Docker，可以参考Docker官方文档进行安装。

步骤1：获取unbound-docker代码

首先，克隆unbound-docker项目仓库到本地：

git clone https://gitcode.com/gh_mirrors/unb/unbound-docker cd unbound-docker

仓库中包含多个版本的Unbound Docker配置，最新版本通常位于带有"latest"标签的目录中，如1.20.0目录。

步骤2：了解项目结构

unbound-docker项目包含以下主要文件和目录：

• 各版本目录（如1.20.0/、1.19.3/等）：每个版本目录包含该版本的Dockerfile和配置文件
• Dockerfile：用于构建Docker镜像的文件
• unbound.sh：启动脚本，位于各版本目录中（如1.20.0/data/unbound.sh）
• 配置文件：包括a-records.conf、forward-records.conf和srv-records.conf，用于自定义DNS记录和转发规则
• unbound.conf：Unbound的主配置文件示例

步骤3：构建Docker镜像（可选）

虽然可以直接使用官方预构建的镜像，但如果你需要自定义配置，可以自行构建：

# 进入最新版本目录 cd 1.20.0 # 构建镜像 docker build -t my-unbound:latest .

步骤4：运行unbound-docker容器

基本运行方式

使用以下命令启动一个基本的unbound-docker容器：

docker run \ --name=my-unbound \ --detach=true \ --publish=53:53/tcp \ --publish=53:53/udp \ --restart=unless-stopped \ mvance/unbound:latest

这个命令会：

• 创建一个名为"my-unbound"的容器
• 在后台运行（--detach=true）
• 映射53端口（DNS服务默认端口）
• 设置容器在系统重启后自动启动

自定义DNS转发规则

默认情况下，unbound-docker使用Cloudflare DNS作为转发服务器。如果你想使用其他DNS服务器，可以通过自定义forward-records.conf文件来实现：

1. 创建自定义的forward-records.conf文件：

forward-zone: name: "." forward-tls-upstream: yes # 使用Google DNS forward-addr: 8.8.8.8@853#dns.google forward-addr: 8.8.4.4@853#dns.google

2. 使用自定义配置文件启动容器：

docker run \ --name my-unbound \ --detach=true \ --publish=53:53/tcp \ --publish=53:53/udp \ --restart=unless-stopped \ --volume $(pwd)/forward-records.conf:/opt/unbound/etc/unbound/forward-records.conf:ro \ mvance/unbound:latest

添加本地网络DNS记录

如果你需要为本地网络添加自定义DNS记录，可以创建a-records.conf文件：

# A Record local-data: "server.local. A 192.168.1.100" local-data: "printer.local. A 192.168.1.101" # PTR Record local-data-ptr: "192.168.1.100 server.local." local-data-ptr: "192.168.1.101 printer.local."

然后在启动容器时挂载该文件：

docker run \ --name my-unbound \ --detach=true \ --publish=53:53/tcp \ --publish=53:53/udp \ --restart=unless-stopped \ --volume $(pwd)/a-records.conf:/opt/unbound/etc/unbound/a-records.conf:ro \ mvance/unbound:latest

步骤5：使用Docker Compose（高级选项）

对于更复杂的配置，可以使用Docker Compose来管理容器。创建一个docker-compose.yml文件：

version: '3' services: unbound: container_name: unbound image: "mvance/unbound:latest" ports: - "53:53/tcp" - "53:53/udp" volumes: - ./forward-records.conf:/opt/unbound/etc/unbound/forward-records.conf:ro - ./a-records.conf:/opt/unbound/etc/unbound/a-records.conf:ro restart: unless-stopped

然后使用以下命令启动：

docker-compose up -d

步骤6：验证Unbound服务

启动容器后，可以使用dig命令验证DNS服务是否正常工作：

dig @localhost example.com

如果一切正常，你应该能看到来自Unbound的DNS响应。

步骤7：管理和维护

查看容器日志

docker logs my-unbound

停止容器

docker stop my-unbound

启动容器

docker start my-unbound

更新容器

# 拉取最新镜像 docker pull mvance/unbound:latest # 停止并删除旧容器 docker stop my-unbound && docker rm my-unbound # 使用新镜像启动容器 docker run ... (使用之前的启动命令)

常见问题解决

端口冲突

如果启动时出现"Bind for 0.0.0.0:53 failed"错误，可能是因为系统中已有其他服务占用了53端口。可以：

1. 停止占用53端口的服务
2. 或修改端口映射，使用其他端口（如5353:53）

配置不生效

如果修改了配置文件但没有生效，可能需要重启容器：

docker restart my-unbound

健康检查失败

默认情况下，容器会定期检查自身健康状态。如果健康检查失败，可以查看日志了解具体原因。

总结

通过本教程，你已经学会了如何安装和运行unbound-docker，包括基本配置、自定义DNS记录和使用Docker Compose进行管理。unbound-docker提供了一个简单而强大的方式来部署自己的DNS服务器，帮助你提高网络安全性和解析速度。

如果你需要更高级的配置，可以参考项目中的unbound.conf示例文件，或查阅Unbound官方文档获取更多信息。

【免费下载链接】unbound-dockerUnbound DNS Server Docker Image项目地址: https://gitcode.com/gh_mirrors/unb/unbound-docker