第10章 DNS 集群与 DNSSEC 配置指南
第10章:DNS 集群与 DNSSEC
INFO 从 1.7.0 版本开始,我们已实现 DNSSEC 支持。DNSSEC 要求采用“主 -> 从”架构。如果现有实施是“主 <-> 主”架构,则不支持。此外,DNSSEC 还要求系统至少为 Ubuntu 22.04 或 Debian 11!
在 Hestia 上为您的域名托管 DNS
前提条件
这些步骤要求您配置域名的 DNS 服务器,使其指向您的 Hestia 服务器。 请注意,大多数域名注册商要求配置两个或更多 DNS 服务器。 域名服务器很可能需要注册为“Glue records”(胶水记录)。 您可能需要等待长达 24 小时,直到域名服务器变为可用。
准备域名和 DNS
1. 在您的 Hestia 主服务器上,使用 child-ns 模板创建 DNS 区域。 2. 在您的域名注册商面板中,将域名的域名服务器设置为 Hestia 服务器。
如果您希望最小化 DNS 相关停机时间,或者寻找一种在所有服务器间自动同步 DNS 区域的方法,可以考虑搭建 DNS 集群。
如果 DNSSEC 对您很重要,则必须使用“主 -> 从”模式。如果您希望在任一服务器上添加区域并让它们复制到另一台服务器,则配置为“主 <-> 主”模式。
TIP 如果您刚配置了从服务器,请检查主机名是否正确解析,以及是否拥有有效的 SSL 证书。
DNS 集群设置
主服务器是创建 DNS 区域的地方,从服务器通过 API 接收区域。Hestia 可以配置为“主 <-> 主”或“主 -> 从”。在“主 <-> 主”配置中,每个主服务器也是从服务器,因此可以视为“主/从 <-> 主/从”。
在每个从服务器上,需要一个唯一用户来被分配区域,并且该用户必须被分配“Sync DNS User”或“dns-cluster”角色。
INFO 从 1.6.0 版本开始,我们实现了一套新的 API 访问密钥认证系统。我们强烈建议采用此方法替代旧的“用户名/密码”系统,因为访问密钥和密钥的长度使其更加安全! 如果您仍希望使用旧 API 并以管理员用户名和密码进行认证,请确保“Enable legacy API access”已设置为“yes”。
带有 Hestia API 的“主 <-> 主” DNS 集群(默认设置)
WARNING 此方法不支持 DNSSEC!
在每个充当“从”角色的 Hestia 服务器上创建新用户。确保其用户名为“dns-cluster”或拥有“dns-cluster”角色。
运行以下命令以启用 DNS 服务器:
```bash v-add-remote-dns-host slave.yourhost.com 8083 'accesskey:secretkey' '' 'api' 'username' ```
或者,如果您仍想使用“管理员”和“密码”认证(不推荐):
```bash v-add-remote-dns-host slave.yourhost.com 8083 'admin' 'strongpassword' 'api' 'username' ```
通过这种方式,您可以设置“主 -> 从”或“主 <-> 主 <-> 主”集群。 在如何链接 DNS 服务器方面没有限制。
带有 Hestia API 的“主 -> 从” DNS 集群
INFO 如果尝试通过本地网络同步,将无法正常工作!参见问题列表。务必使用公网 IP 地址。
准备从服务器: 1. 在“配置服务器 -> 安全 -> API 允许的 IP 地址”中,将主服务器 IP 加入白名单。 2. 启用“管理员”(或所有用户)的 API 访问。 3. 在“管理员”用户下创建一个 API 密钥,至少包含“sync-dns-cluster”权限。这位于“用户设置 / 访问密钥”中。 4. 创建一个新的 DNS 同步用户,要求如下: - 拥有电子邮件地址(可以是通用的)。 - 拥有“dns-cluster”角色。 - 如果不是常规用户,您可能需要设置“Do not allow user to log in to Control Panel”(不允许用户登录控制面板)。 - 如果拥有多个从服务器,从用户必须是唯一的。 5. 编辑 `/usr/local/hestia/conf/hestia.conf`,将 `DNS_CLUSTER_SYSTEM='hestia'` 更改为 `DNS_CLUSTER_SYSTEM='hestia-zone'`。 6. 编辑 `/etc/bind/named.conf.options`,进行以下更改,然后通过 `systemctl restart bind9` 重启 bind9:
```bash # 修改此行 allow-recursion { 127.0.0.1; ::1; }; # 改为 allow-recursion { 127.0.0.1; ::1; your.master.ip.address; }; # 添加此行 allow-notify{ your.master.ip.address; }; ```
准备主服务器: 1. 在主服务器上,打开 `/usr/local/hestia/conf/hestia.conf`,将 `DNS_CLUSTER_SYSTEM='hestia'` 更改为 `DNS_CLUSTER_SYSTEM='hestia-zone'`。 2. 编辑 `/etc/bind/named.conf.options`,进行以下更改,然后通过 `systemctl restart bind9` 重启 bind9。
```bash # 修改此行 allow-transfer { "none"; }; # 改为 allow-transfer { your.slave.ip.address; }; # 或者,如果添加多个从服务器,改为 allow-transfer { first.slave.ip.address; second.slave.ip.address; }; # 如果添加多个从服务器,添加此行 also-notify { second.slave.ip.address; }; ```
3. 运行以下命令以启用每个从 DNS 服务器,并稍等片刻以完成区域传输:
```bash
v-add-remote-dns-host
如果仍想使用“管理员”和“密码”认证(不推荐):
```bash v-add-remote-dns-host slave.yourhost.com 8083 'admin' 'strongpassword' 'api' 'user-name' ```
4. 通过以下方法验证是否生效:使用 CLI 命令 `v-list-dns-domains dns-user` 列出从服务器上 `dns-user` 的 DNS 区域,或者以 `dns-user` 身份连接到 Web 界面并检查 DNS 区域。
将现有 DNS 集群转换为“主 -> 从”
1. 在主服务器和从服务器上,打开 `/usr/local/hestia/conf/hestia.conf`,将 `DNS_CLUSTER_SYSTEM='hestia'` 更改为 `DNS_CLUSTER_SYSTEM='hestia-zone'`。 2. 在主服务器上,打开 `/etc/bind/named.conf.options`,进行以下更改,然后通过 `systemctl restart bind9` 重启 bind9。
```bash # 修改此行 allow-transfer { "none"; }; # 改为 allow-transfer { your.slave.ip.address; }; # 或者,如果添加多个从服务器,改为 allow-transfer { first.slave.ip.address; second.slave.ip.address; }; # 如果添加多个从服务器,添加此行 also-notify { second.slave.ip.address; }; ```
3. 在从服务器上,打开 `/etc/bind/named.conf.options`,进行以下更改,然后通过 `systemctl restart bind9` 重启 bind9:
```bash # 修改此行 allow-recursion { 127.0.0.1; ::1; }; # 改为 allow-recursion { 127.0.0.1; ::1; your.master.ip.address; }; # 添加此行 allow-notify{ your.master.ip.address; }; ```
4. 使用 `v-sync-dns-cluster` 更新 DNS。
启用 DNSSEC
WARNING 当 Hestia 集群处于“主 <-> 主”激活状态时,无法使用 DNSSEC。
1. 要启用 DNSSEC,勾选 DNSSEC 复选框并保存。 2. 要查看公钥,请前往“DNS 域名列表”并点击相应图标。 3. 根据您的注册商,您可以基于 DNSKEY 或基于 DS 密钥创建新记录。在将 DNSSEC 公钥添加到注册商后,DNSSEC 即被启用并生效。
DANGER 在 Hestia 中删除或禁用私钥会导致域名无法访问。
FAQ 与故障排除
我能按用户隔离 DNS 账户吗? 是的,您只需在命令末尾提供“用户”变量即可。
```bash v-add-remote-dns-host slave.yourhost.com 8083 'access_key:secret_key' '' '' 'username' ``` 或 ```bash v-add-remote-dns-host slave.yourhost.com 8083 admin p4sw0rd '' 'username' ``` 在新的 API 系统中,您也可以用 `access_key:secret_key` 替换 `api_key`。
INFO 默认情况下,用户 `dns-cluster` 或拥有 `dns-cluster` 角色的用户被豁免同步到其他 DNS 服务器!
无法将服务器添加为 DNS 主机 尝试为集群添加 DNS 服务器时,出现以下错误:
```bash /usr/local/hestia/func/remote.sh: line 43: return: Error:: numeric argument required Error: api connection to slave.domain.tld failed ```
默认情况下,针对非本地 IP 地址的 API 访问是被禁用的。在您的从服务器上,将主服务器的 IP 地址添加到“服务器设置 -> 配置 -> 安全 -> 系统 -> API 允许的 IP 地址”字段中,并按下“保存”。