ZeroNS：围绕 ZeroTier Central API 的命名服务

ZeroNS 提供了 ZeroTier Central 配置的 网络 中的名称；一旦提供了具有 IPv4 功能的网络，它

• 将监听连接到该网络的本地接口——您将为每个 ZeroTier 网络启动一个 ZeroNS。
• 提供通用的 DNS 服务，通过将所有查询转发到不匹配 TLD 的 /etc/resolv.conf 解析器，类似于 dnsmasq。
• 告诉中央将所有具有“管理 DNS”设置开启的客户端指向它进行解析。
• 提供 UDP、TCP 和 DNS-over-TLS 支持（如果配置了证书）。
• 最后，设置提供的 TLD（默认为 .home.arpa，由 IANA 推荐），以及配置 A（IPv4）和 AAAA（IPv6）记录
  • 成员 ID：zt-<memberid>.<tld> 将解析为它们的 IPv4 和 IPv6 地址。
  • 名称：如果名称与 DNS 名称兼容，则将它们转换为这样的形式：到 <name>.<tld>。
    • 请注意，可能存在冲突，并且防止冲突的责任在于管理员。
  • 此外，还包括成员的 PTR 记录，除了 6plane 之外的所有场景。
  • 通配符一切模式：此模式（通过传递 -w 标志启用）为 TLD 下的所有名称启用通配符；例如 my-site.zt-<memberid>.<tld> 将解析为成员的 IP，命名主机以相同方式工作。

安装

在继续之前，请记住 zeronsd 是 测试版软件。话虽如此，如果您想快速开始使用 zeronsd，请点击此处获取用户友好的指南！

软件包

• Linux/Windows：发布版包含 Linux 的 *.deb、*.rpm 和 Windows 的 MSI 格式的软件包。注意：Windows MSI 将为端口 53 安装防火墙例外，以便 zeronsd 可以通信。
  • Arch Linux 软件包由 @devvick 提供！
• Mac OS X：brew tap zerotier/homebrew-tap && brew install zerotier/homebrew-tap/zeronsd
• Docker：docker pull zerotier/zeronsd（有关 Docker 的更多信息，请参阅下文）

其他方法

从 Cargo 获取发布版

请先获取一个可工作的 rust 环境。

cargo install zeronsd

从 Git（通过 Cargo）

cargo install --git https://github.com/zerotier/zeronsd --branch main

Docker

在存储库中存在一个 Dockerfile，您可以使用它来构建镜像，而不是我们的一些 官方镜像。

有一些控制行为的构建参数

• IS_LOCAL：如果设置，则使用本地源代码树，并尝试获取。
• VERSION：这是要获取的分支或标签。
• IS_TAG：如果非零，告诉 cargo 获取标签而不是分支。

示例

docker build . # builds latest master
docker build --build-arg VERSION=somebranch # builds branch `somebranch`
docker build --build-arg IS_TAG=1 --build-arg VERSION=v0.1.0 # builds version 0.1.0 from tag v0.1.0

构建完成后，镜像会自动运行 zeronsd。默认子命令是 help。

Docker（alpine 版本）

请参阅 Dockerfile.alpine。

用法

必须在环境（或提供指向包含此值的文件的 -t 标志）中设置 ZEROTIER_CENTRAL_TOKEN。您必须能够管理 ZeroTier 网络，才能使用 zeronsd。此外，作为 root 运行是必需的，因为 许多客户端解析器仅在端口 53 上工作。您的 zeronsd 实例将监听 udp 和 tcp，端口 53。

zeronsd start <network id>

# to enable
zeronsd supervise -t ~/.token -f /etc/hosts -d mydomain 36579ad8f6a82ad3
# generates systemd unit file named /lib/systemd/system/zeronsd-36579ad8f6a82ad3.service
systemctl daemon-reload
systemctl enable zeronsd-36579ad8f6a82ad3.service && systemctl start zeronsd-36579ad8f6a82ad3.service

# to disable
systemctl disable zeronsd-36579ad8f6a82ad3.service && systemctl stop zeronsd-36579ad8f6a82ad3.service
zeronsd unsupervise 36579ad8f6a82ad3
systemctl daemon-reload

docker run --net host -it \
  -v /var/lib/zerotier-one/authtoken.secret:/authtoken.secret \
  -v <token file>:/token.txt \
  zeronsd:alpine start -s /authtoken.secret -t /token.txt \
  <network id>