
PowerDNS Recursor v5.0.x 是由PowerDNS.COM BV开发的高性能DNS递归解析器Docker镜像,是PowerDNS项目的核心组件之一。该镜像提供稳定、高效的DNS递归解析服务,负责接收客户端DNS查询,通过迭代查询从权威DNS服务器获取结果并返回给客户端。v5.0.x版本包含性能优化、安全性增强及新功能支持,适用于构建企业级、运营商级的DNS解析基础设施。
PowerDNS Recursor Docker镜像可从Docker Hub获取,v5.0.x版本标签通常为powerdns/recursor:5.0(具体标签请参考https://hub.docker.com/r/powerdns/recursor%EF%BC%89%EF%BC%9A
bashdocker pull powerdns/recursor:5.0
启动容器并映射默认DNS端口(53/udp、53/tcp),使用默认配置:
bashdocker run -d \ --name pdns-recursor \ -p 53:53/udp \ -p 53:53/tcp \ powerdns/recursor:5.0
配置文件挂载
创建本地配置文件
创建recursor.conf配置文件(示例):
ini# 监听地址(多个地址用逗号分隔) local-address=0.0.0.0 # 转发规则:格式为"zone=server[,zone=server...]","."表示默认区域 forward-zones=example.com=192.168.1.100, .tld=8.8.8.8 # DNSSEC模式:off(关闭)、validate(验证)、process-no-validate dnssec=validate # 缓存最大条目数 max-cache-entries=1000000 # 日志级别:critical/error/warn/info/debug log-level=info # 启用Web监控接口 webserver=yes webserver-address=0.0.0.0 webserver-port=8082
挂载配置文件运行
bashdocker run -d \ --name pdns-recursor \ -p 53:53/udp \ -p 53:53/tcp \ -p 8082:8082/tcp \ # Web监控端口 -v $(pwd)/recursor.conf:/etc/powerdns/recursor.conf \ powerdns/recursor:5.0
环境变量配置
通过环境变量传递简单配置,格式为PDNS_<配置项>:
bashdocker run -d \ --name pdns-recursor \ -p 53:53/udp \ -p 53:53/tcp \ -e PDNS_LOCAL_ADDRESS=0.0.0.0 \ -e PDNS_DNSSEC=validate \ -e PDNS_FORWARD_ZONES="example.com=192.168.1.100, .tld=8.8.8.8" \ -e PDNS_LOG_LEVEL=info \ -e PDNS_WEBSERVER=yes \ -e PDNS_WEBSERVER_ADDRESS=0.0.0.0 \ powerdns/recursor:5.0
| 配置项 | 环境变量对应 | 说明 | 默认值 |
|---|---|---|---|
local-address | PDNS_LOCAL_ADDRESS | 监听IP地址,多个地址用逗号分隔 | 0.0.0.0 |
local-port | PDNS_LOCAL_PORT | 监听UDP/TCP端口 | 53 |
forward-zones | PDNS_FORWARD_ZONES | 转发规则,格式"zone=server[,zone=server...]",.表示默认区域 | 未设置 |
dnssec | PDNS_DNSSEC | DNSSEC模式:off/validate/process-no-validate | off |
max-cache-entries | PDNS_MAX_CACHE_ENTRIES | 缓存最大条目数 | 1000000 |
log-level | PDNS_LOG_LEVEL | 日志级别:critical/error/warn/info/debug | info |
webserver | PDNS_WEBSERVER | 是否启用Web监控接口:yes/no | no |
webserver-address | PDNS_WEBSERVER_ADDRESS | Web监控接口地址 | 127.0.0.1 |
webserver-port | PDNS_WEBSERVER_PORT | Web监控接口端口 | 8082 |
创建docker-compose.yml文件:
yamlversion: '3' services: pdns-recursor: image: powerdns/recursor:5.0 container_name: pdns-recursor ports: - "53:53/udp" - "53:53/tcp" - "8082:8082/tcp" # Web监控端口 environment: - PDNS_LOCAL_ADDRESS=0.0.0.0 - PDNS_DNSSEC=validate - PDNS_LOG_LEVEL=info - PDNS_WEBSERVER=yes - PDNS_WEBSERVER_ADDRESS=0.0.0.0 volumes: - ./recursor.conf:/etc/powerdns/recursor.conf restart: unless-stopped
启动服务:
bashdocker-compose up -d
chmod 644 recursor.conf调整权限。您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。






探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
无需登录使用专属域名
Kubernetes 集群配置 Containerd
K3s 轻量级 Kubernetes 镜像加速
VS Code Dev Containers 配置
Podman 容器引擎配置
HPC 科学计算容器配置
ghcr、Quay、nvcr 等镜像仓库
Harbor Proxy Repository 对接专属域名
Portainer Registries 加速拉取
Nexus3 Docker Proxy 内网缓存
需要其他帮助?请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
docker search 限制
站内搜不到镜像
离线 save/load
插件要用 plugin install
WSL 拉取慢
安全与 digest
新手拉取配置
镜像合规机制
manifest unknown
no matching manifest(架构)
invalid tar header(解压)
TLS 证书失败
DNS 超时
域名连通性排查
410 Gone 排查
402 与流量用尽
401 认证失败
429 限流
D-Bus 凭证提示
413 与超大单层
来自真实用户的反馈,见证轩辕镜像的优质服务