jauderho/dnscontrol

dnscontrol Docker镜像

概述

本镜像为StackExchange/dnscontrol的Docker化版本，dnscontrol是一款强大的DNS配置管理工具，旨在简化多DNS提供商环境下的域名记录管理。镜像支持多平台架构，上游发布后1小时内完成构建，并每周至少重建一次以确保安全性和功能更新。

!https://github.com/jauderho/dockerfiles/workflows/dnscontrol/badge.svg
!Version
!Docker Pulls
!Image Size

核心功能与特性

• 多DNS提供商支持：兼容Cloudflare、AWS Route53、Google Cloud DNS等主流DNS服务提供商，统一管理不同平台的域名记录。
• 版本控制集成：可与Git等版本控制系统无缝配合，追踪DNS配置变更历史，支持回滚与审计。
• 自动化部署：通过命令行工具一键推送DNS配置变更，减少手动操作错误，支持CI/CD流程集成。
• DNS记录验证：内置验证机制，在推送前检查DNS记录语法及配置合法性，避免无效变更。
• 多平台支持：提供amd64、arm64等多种架构镜像，适配不同硬件环境。

使用场景

• 多域名/多提供商管理：适用于需要同时管理多个域名及DNS服务提供商（如同时使用Cloudflare和Route53）的团队。
• 版本控制需求：希望通过Git等工具追踪DNS配置变更、保留修改历史的个人或企业用户。
• 自动化部署流程：需将DNS配置更新集成到CI/CD pipeline，实现自动化测试与部署的场景。
• 配置一致性保障：需要确保不同DNS提供商间记录同步、避免配置漂移的场景。

使用方法

基本命令示例（docker run）

1. 检查DNS配置文件
   挂载本地配置文件目录，运行dnscontrol检查配置语法：

   bash
   docker run --rm -v $(pwd):/data jauderho/dnscontrol dnscontrol check -f /data/dnsconfig.js
   

   （注：$(pwd)为本地包含dnsconfig.js的目录路径）

2. 推送DNS配置变更
   向指定DNS提供商推送配置更新：

   bash
   docker run --rm -v $(pwd):/data jauderho/dnscontrol dnscontrol push -f /data/dnsconfig.js
   

docker-compose配置示例

yaml
version: '3'
services:
  dnscontrol:
    image: jauderho/dnscontrol:latest
    volumes:
      - ./dnsconfig:/data  # 本地DNS配置目录（含dnsconfig.js等文件）
    environment:
      # 按需添加DNS提供商凭证（示例为Cloudflare）
      # - CLOUDFLARE_API_TOKEN=your_cloudflare_api_token
    command: check -f /data/dnsconfig.js  # 默认执行配置检查，可替换为push等命令

注意事项

• 配置文件挂载：需将本地DNS配置文件（如dnsconfig.js、creds.json）通过卷（volume）挂载到容器内，确保工具可访问配置。
• 凭证管理：DNS提供商的API凭证建议通过环境变量或安全密钥管理工具传入，避免硬编码在配置文件中。
• 版本更新：镜像每周重建，建议定期执行docker pull jauderho/dnscontrol:latest以获取最新安全补丁和功能优化。
• 详细使用参考：更多命令及配置细节，请参见https://github.com/StackExchange/dnscontrol%E3%80%82