riftbit/coredns

CoreDNS

https://img.shields.io/docker/pulls/riftbit/coredns](https://hub.docker.com/r/riftbit/coredns/) https://img.shields.io/docker/stars/riftbit/coredns.svg](https://hub.docker.com/r/riftbit/coredns/) https://img.shields.io/docker/image-size/riftbit/coredns](https://hub.docker.com/r/riftbit/coredns/tags?ordering=last_updated) https://img.shields.io/microbadger/layers/riftbit/coredns](https://hub.docker.com/r/riftbit/coredns/tags?ordering=last_updated) https://img.shields.io/docker/v/riftbit/coredns](https://hub.docker.com/r/riftbit/coredns/tags?ordering=last_updated)

https://hub.docker.com/r/riftbit/coredns%E9%80%82%E7%94%A8%E4%BA%8Ehttps://github.com/coredns/coredns%EF%BC%88%E5%8C%85%E5%90%AB%E9%A2%9D%E5%A4%96%E6%8F%92%E4%BB%B6%EF%BC%89

该Docker镜像基于scratch镜像构建，包含CoreDNS和TLS证书（用于DoT、DoH和gRPC）。

当前版本：1.8.7

文档可查看https://rbdocker.gitlab.io/coredns

镜像概述和主要用途

CoreDNS是一款用Go语言编写的DNS服务器。与BIND、Knot、PowerDNS等其他DNS服务器相比，其核心特点是高度灵活性，几乎所有功能都通过插件实现。插件可独立工作或协同运行以实现"DNS功能"，既能添加如metrics、cache等辅助功能，也能生成DNS响应（如与Kubernetes集成提供服务发现、从文件或数据库读取数据等）。

本Docker镜像在官方CoreDNS基础上集成了额外插件，支持多种硬件平台，并包含TLS证书，可直接用于部署支持DoT（DNS over TLS）、DoH（DNS over HTTPS）和gRPC的DNS服务。

支持的平台

该容器构建的CoreDNS DNS服务器支持多种平台，包含众多插件：

• linux/amd64
• linux/arm64
• linux/arm/v7
• linux/arm/v6
• linux/mips64le
• linux/mipsle
• linux/mips64
• linux/mips
• linux/ppc64le
• linux/s390x
• linux/riscv64

核心功能和特性

插件列表

riftbit更新或创建的插件

• https://github.com/rb-coredns/coredns-dockerdiscovery/blob/master/README.md
• https://github.com/rb-coredns/coredns-pdsql/blob/master/README.md - 开发中
• https://github.com/rb-coredns/coredns-ipin/blob/master/README.md - 开发中

社区版本插件

• https://github.com/miekg/coredns-git/blob/master/README.md
• https://github.com/coredns/records/blob/master/README.md
• https://github.com/openshift/coredns-mdns/blob/master/README.md
• https://github.com/serverwentdown/alias/blob/master/README.md
• https://github.com/networkservicemesh/fanout/blob/master/README.md
• https://github.com/miekg/dump/blob/master/README.md
• https://github.com/jinzhu/gorm/tree/master/dialects/mysql
• https://github.com/jinzhu/gorm/tree/master/dialects/sqlite
• https://github.com/jinzhu/gorm/tree/master/dialects/postgres
• https://github.com/jinzhu/gorm/tree/master/dialects/mssql

待开发插件列表

以下插件已过时且无法使用，将在https://github.com/rb-coredns%E4%B8%AD%E8%A2%AB%E5%88%86%E5%8F%89%E5%B9%B6%E6%9B%B4%E6%96%B0%EF%BC%9A

• https://github.com/coredns/unbound/blob/master/README.md
• https://github.com/miekg/redis/blob/master/README.md
• https://github.com/arvancloud/redis/blob/master/README.md

使用场景和适用范围

• 企业内部DNS服务部署
• 容器环境中的服务发现（结合docker插件）
• 需要自定义DNS规则的场景（如基于文件、数据库的记录管理）
• 对DNS安全性有要求的场景（支持DoT、DoH加密传输）
• 多平台环境（如ARM、RISC-V等嵌入式设备）的DNS服务需求

使用方法和配置说明

基本配置

容器默认在/coredns-conf/Corefile路径下查找配置文件。可通过挂载该目录来自定义配置。

部署步骤

1. 创建数据和配置卷

bash
docker volume create coredns-conf

2. 准备Corefile配置

将自定义的Corefile放入上述卷中。以下是示例Corefile：

. {
    health        # 健康检查
    ready         # 就绪检查
    
    hosts         # 主机记录解析
    nsid Use The Force  # NSID标识
    
    forward . 8.8.8.8:53 8.8.4.4  # 转发至Google DNS
    
    prometheus    # Prometheus指标
    errors        # 错误日志
    log           # 访问日志
    whoami        # 客户端信息
    cache         # 缓存
}

.:5353 {
    forward . tls://1.1.1.1 tls://1.0.0.1 {  # 转发至Cloudflare DNS (DoT)
       tls_servername cloudflare-dns.com
       health_check 5s  # 健康检查间隔
    }
    
    prometheus
    errors
    log
    whoami
    cache
}

.:25353 {
    forward . tls://9.9.9.9 {  # 转发至Quad9 DNS (DoT)
        health_check 5s
        except example.org  # 排除example.org域
    }
    prometheus
    errors
    log
    whoami
    cache
}

example.com:53 {
    file /coredns-conf/example.dns.db  # 从文件加载example.com域记录
    prometheus
    errors
    log
    whoami
}

.:15353 {
    docker unix:///var/run/docker.sock {  # Docker服务发现
        domain docker.loc  # Docker容器域名后缀
        hostname_domain docker-host.loc  # 主机名域名后缀
    }
    prometheus
    errors
    log
    whoami
}

3. 启动容器

方式一：使用host网络

bash
docker run -d \
  --hostname coredns \
  --name coredns \
  --net host \
  -v /var/run/docker.sock:/var/run/docker.sock \  # 挂载Docker套接字（如需docker插件）
  -v coredns-conf:/coredns-conf \  # 挂载配置卷
  --restart unless-stopped \
riftbit/coredns

方式二：使用自定义Docker网络

首先创建网络：

bash
docker network inspect coredns-network >/dev/null 2>&1 || \
    docker network create --driver bridge --subnet=172.153.0.0/16 coredns-network

然后启动容器：

bash
docker run -d \
  --hostname coredns \
  --name coredns \
  --net coredns-network \
  --ip docker.xuanyuan.run/172.153.0.53 \ # 固定IP
  -p 127.0.0.153:53:53/udp \  # UDP 53端口映射
  -p 127.0.0.153:53:53/tcp \  # TCP 53端口映射
  -p 9153:9153 \  # Prometheus指标端口
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v coredns-conf:/coredns-conf \
  --restart unless-stopped \
riftbit/coredns

端口说明

• 53/udp：DNS服务UDP端口
• 53/tcp：DNS服务TCP端口
• 9153：Prometheus指标默认端口（用于监控）

更新时间：2022-02-06T23:35:04Z