mjenz/zerotier-dns

zerotier-dns

ZeroTier虚拟网络专用DNS服务器

镜像概述

zerotier-dns是基于uxbh/ztdns分叉的DNS服务器，专为ZeroTier虚拟网络设计，可实现网络成员的名称解析，简化虚拟网络内设备的访问管理。

核心功能

• 支持按ZeroTier成员名称解析IPv4（A记录）和IPv6（AAAA记录）地址
• 允许创建轮询DNS名称，实现负载均衡
• 镜像体积小巧，部署配置便捷
• 支持通过配置文件或命令行参数自定义服务参数

使用场景

• ZeroTier虚拟网络内部设备名称解析，替代IP地址访问
• 虚拟网络内多设备的轮询访问需求（如集群节点）
• 简化ZeroTier网络的DNS管理流程

配置说明

命令行选项

启动服务时可通过以下参数自定义配置：

bash
zerotier-dns server --help
Start the zerotier-dns DNS server.

Flags:
      --api-key string     ZeroTier API密钥（必填）
      --api-url string     ZeroTier API地址（默认：https://my.zerotier.com/api）
      --domain string      服务域名（默认：zt）
      --include-offline    包含离线成员（默认：true）
      --interface string   绑定网络接口（默认：zt0）
      --network string     ZeroTier网络ID（必填）
      --port int           监听端口（默认：53）
      --refresh int        控制器轮询间隔（分钟，默认：30）
Global Flags:
      --config string   配置文件路径（默认：zerotier-dns.yml）
      --debug           启用调试模式

配置文件

支持通过zerotier-dns.yml配置文件定义服务参数，示例：

yaml
interface: "zt0"
port: 53
domain: "zt"
refresh: 30
include-offline: true
debug: false
api-key: "YOUR_API_KEY"
api-url: "https://my.zerotier.com/api"
network: "YOUR_NETWORK_ID"
# 支持多网络映射（二选一network/networks）
# networks:
#   home: "NETWORK_ID_1"
#   office: "NETWORK_ID_2"
# 轮询DNS配置
# round-robin:
#   k8s-nodes: "k8s-node-\\w+"

环境变量覆盖

可通过环境变量覆盖配置，变量名格式为ZTDNS_+参数名大写（如ZTDNS_API_KEY替代api-key）。

部署示例

Docker运行

bash
docker run --rm \
  -p 53:53/udp \
  --volume $(pwd)/zerotier-dns.yml:/app/zerotier-dns.yml \
  mjenz/zerotier-dns server --api-key YOUR_API_KEY --network YOUR_NETWORK_ID

Docker服务部署

bash
docker run --detach \
  -p 53:53/udp \
  --volume $(pwd)/zerotier-dns.yml:/app/zerotier-dns.yml \
  --restart=unless-stopped \
  --name=zerotier-dns mjenz/zerotier-dns

Systemd服务部署

创建/etc/systemd/system/zerotier-dns.service：

ini
[Unit]
Description=ZeroTier DNS Server
After=network-online.target
Wants=network-online.target

[Service]
WorkingDirectory=/path/to/config
ExecStart=zerotier-dns server
Restart=on-failure
RestartSec=5

[Install]
WantedBy=multi-user.target

启用服务：

bash
sudo systemctl daemon-reload
sudo systemctl enable zerotier-dns.service
sudo systemctl start zerotier-dns.service