# 动态域名

> 为设备绑定动态域名，选择内网或公网地址解析方式。

来源: https://www.widewired.com.cn/page/docs/dynamic-domains

## 绑定域名

在「配置 → 动态域名」选择设备，输入域名前缀，从 `ifconfig.earth`、`ipconfig.earth` 与 `ddns123.net` 中选择后缀，设置解析方式。点击「检测可用性」，确认可用后点击「绑定」。修改前缀或后缀后需要重新检测。

前缀为 1–63 位字母、数字或连字符，首尾不能是连字符。每台设备可绑定一个域名。绑定时会再次检测占用；设备必须已获批准，且有所选解析方式可用的地址。

## 解析方式

| 方式 | 返回地址 |
| --- | --- |
| 仅内网地址 | 设备的 Overlay 地址 |
| 仅公网地址 | 当前可用公网地址 |
| 内网地址优先 | 同时返回内网和公网地址，内网排前 |
| 公网地址优先 | 同时返回公网和内网地址，公网排前 |

修改解析方式后使用 ✓ 保存，✗ 取消；选择和失焦不会自动保存。优先顺序只表示权威 DNS 的应答顺序，递归解析器和操作系统可能重排，不保证连接故障时自动切换。

内网地址只能经虚拟网络访问。公网地址能否访问取决于设备服务、防火墙和端口映射，绑定域名不会建立转发。

## 同步状态

设备地址变化后自动更新解析。页面显示已发布的 IPv4、IPv6 地址和最后同步时间。IPv6 可来自设备已校验格式的公网候选，不代表服务已通过公网可达性验证。公网地址长期未更新时撤下；恢复观测后重新发布。设备禁用或网络挂起时撤下解析，配置保留。

同步失败时保留绑定并自动重试，页面显示「同步失败」。没有对应地址时显示「等待地址」。DNS 记录 TTL 为 5 分钟，已有解析缓存和未找到域名的缓存均可能延迟生效。

## 解绑

在设备动态域名页面底部点击「解绑」并确认。DNS 删除成功后即可重新绑定；已有 DNS 缓存按原 TTL 到期。更换域名通过解绑、输入、检测和绑定完成。

## 故障速查

| 现象 | 处理 |
| --- | --- |
| 域名已被使用 | 更换前缀或后缀，重新检测可用性。 |
| 等待地址 | 检查设备地址，或改用内网地址、地址优先方式并保存。 |
| 同步失败或解绑未完成 | 系统会自动重试，稍后查看同步状态。 |
| 解析仍返回旧地址 | 已有缓存最多保留剩余 300 秒，重新查询后确认。 |
