chanyipiaomiao / devops-dns-server

devops-dns-server 是一款简单的dns服务器，支持从外部数据源获取数据(比如从CMDB中获取数据,只要API返回固定格式的数据)、支持读取某个文件(必须是/etc/hosts文件一样的格式), 从而可以使解析主机名为IP,也可以转发DNS请求到指定的DNS服务器, 可以作为内网DNS服务器

devops-dns-server

devops-dns-server 是一款简单易用的dns服务器，支持从外部数据源获取数据(比如从CMDB中获取数据,只要API返回固定格式的数据)、支持读取某个文件(必须是/etc/hosts文件一样的格式), 从而可以使解析主机名为IP.

也可以转发DNS请求到指定的DNS服务器, 可以作为内网DNS服务器

配置

配置文件app.conf说明

[server]
# 本服务器的监听地址
# 192.168.1.1:53  只监听该地址 192.168.1.1 的53
# :53             所有接口地址都监听53端口
# 首先从环境变量中获取 DEVOPS_DNS_SERVER_LISTEN 的值 如果没有该值则使用默认的 :53
listen = "${DEVOPS_DNS_SERVER_LISTEN||:53}"

# 当本服务器无法解析的时候会向这个服务器转发DNS查询
nameserver = "${DEVOPS_DNS_SERVER_NAMESERVER||8.8.8.8:53}"

[source]
# 解析的顺序,可以这样设置
# fromFile: 只从文件获取IP
# fromAPI: 只从API获取IP
# fromFile,fromAPI: 首先从文件获取 如果文件里面没有再从API获取
order = "${DEVOPS_DNS_SERVER_ORDER||fromFile}"

[fromAPI]
# GET api的url地址, 返回的json数据格式如下:
# 必须包含data字段
#{
#    "data": "ip地址"
#    ...
#}
url = "${DEVOPS_DNS_SERVER_FROMAPI_URL||http://192.168.2.116:30080/host/findIPByName?name=hostname"

[fromFile]
# 文件格式必须要和/etc/hosts格式一样
filepath = "${DEVOPS_DNS_SERVER_FROMFILE||hosts}"

# 是否要监控该文件,一旦启用，就默认按照下面的时间间隔进行读取
watch = "${DEVOPS_DNS_SERVER_FROMFILE_WATCH||yes}"

# 间隔多久重新读取文件，默认是3s
interval = 3

解析动作

1. 从API获取IP
2. 从文件获取IP

任选一个或者2个都使用，配置好寻找顺序即可

从API获取IP

在app.conf配置文件配置CMDB API，程序会以GET方式访问API地址，结果json中必须要包含 data 字段

{
    "data": "ip地址"
    ...
}

从文件获取IP

默认是当前目录下的hosts文件, 也就是/etc/hosts文件的格式

1.1.1.1 a.com
2.2.2.2 b.com
3.3.3.3 hostname

运行

Docker

docker run -p 53:53/udp  chanyipiaomiao/devops-dns-server:latest

下载二进制包直接运行

./devops-dns-server