
powerdns/pdns-recursor-51PowerDNS Recursor是PowerDNS项目旗下的DNS递归服务器组件,负责接收客户端DNS查询请求,通过迭代查询从根域名服务器获取解析结果并返回。该Docker镜像封装了PowerDNS Recursor v5.1.x版本,旨在简化部署流程,确保跨环境的一致性,为各类DNS解析场景提供开箱即用的解决方案。
使用默认配置启动容器(仅监听本地回环地址,适用于测试):
bashdocker run -d --name pdns-recursor \ -p 53:53/udp -p 53:53/tcp \ powerdns/pdns-recursor:5.1
创建本地配置文件(示例recursor.conf):
ini# 允许所有IP发起查询(生产环境建议限制来源IP) allow-from=0.0.0.0/0 # 监听所有网络接口 local-address=0.0.0.0 # 启用DNS查询日志 log-dns-queries=yes # 缓存最大生存时间(24小时) max-cache-ttl=86400 # 启用DNSSEC验证 dnssec=validate # 启用Web监控接口(用于Prometheus指标) webserver=0.0.0.0:8081 webserver-password=your-secure-password
启动容器并挂载配置文件:
bashdocker run -d --name pdns-recursor \ -p 53:53/udp -p 53:53/tcp -p 8081:8081 \ -v $(pwd)/recursor.conf:/etc/powerdns/recursor.conf \ -v $(pwd)/logs:/var/log/powerdns \ # 挂载日志目录(可选) powerdns/pdns-recursor:5.1
支持部分常用参数通过环境变量传递(完整列表见官方文档):
bashdocker run -d --name pdns-recursor \ -p 53:53/udp -p 53:53/tcp \ -e ALLOW_FROM=192.168.1.0/24 \ # 限制仅内网IP可查询 -e LOCAL_ADDRESS=0.0.0.0 \ -e LOG_DNS_QUERIES=yes \ -e DNSSEC=validate \ powerdns/pdns-recursor:5.1
创建docker-compose.yml文件,定义服务与持久化配置:
yamlversion: '3' services: pdns-recursor: image: powerdns/pdns-recursor:5.1 container_name: pdns-recursor ports: - "53:53/udp" - "53:53/tcp" - "8081:8081" # 监控接口 volumes: - ./recursor.conf:/etc/powerdns/recursor.conf - ./logs:/var/log/powerdns environment: - TZ=Asia/Shanghai # 设置时区 restart: unless-stopped # 容器退出时自动重启
启动服务:
bashdocker-compose up -d
| 参数名 | 描述 | 默认值 | 建议配置 |
|---|---|---|---|
allow-from | 允许发起查询的客户端IP范围 | 127.0.0.0/8 | 生产环境限制为信任网段(如10.0.0.0/8) |
local-address | 服务监听IP地址 | 127.0.0.0 | 0.0.0.0(需要对外提供服务时) |
log-dns-queries | 是否记录DNS查询日志 | no | yes(便于审计与问题排查) |
max-cache-ttl | 缓存记录最大生存时间(秒) | 86400 (24小时) | 根据网络稳定性调整(如43200) |
dnssec | DNSSEC验证模式 | process-no-validate | validate(启用严格验证) |
webserver | 监控接口地址与端口 | 未启用 | 0.0.0.0:8081(启用监控时) |
webserver-password | 监控接口访问密码 | 未设置 | 复杂密码(如P@ssw0rd!2024) |
docker logs pdns-recursor实时查看;挂载日志目录后,日志文件位于./logs/recursor.log。http://<容器IP>:8081/metrics获取Prometheus格式指标,包含查询量、缓存命中率、响应时间等关键指标(访问需验证密码)。





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