78 lines
3.8 KiB
Markdown
78 lines
3.8 KiB
Markdown
---
|
||
outline: deep
|
||
---
|
||
|
||
# DDNS
|
||
|
||
DDNS 功能适用于使用动态 IP 的服务器，当 Agent 上报了一个新的 IP（10分钟一次），Dashboard 会根据配置自动更新 DNS 记录。
|
||
|
||
## 为什么我要使用哪吒监控的 DDNS 功能？
|
||
|
||
- 方便集中管理 DDNS 设置，而不是在每台服务器上都部署一个 DDNS 服务。
|
||
- 仅在面板服务器上保存您的机密信息，防止外泄。
|
||
|
||
## 配置说明
|
||
|
||
可以直接在 Dashboard 管理页面中添加 DDNS 配置。
|
||
|
||
1. 点击菜单栏中的“动态 DNS”选项，进入配置页面。
|
||
2. 点击“新配置”按钮，在弹出窗口中按需填写信息。选项说明：
|
||
- **名称**：配置名称。
|
||
- **DDNS供应商**：供应商类型，决定了使用何种方法更新 DNS 记录。
|
||
- **域名（逗号分隔）**：域名，如填写多个域名需要用 `,` 分隔。支持 IDN（国际化域名）。
|
||
- **最大重试次数**：DDNS 更新尝试次数，默认为 3，范围为 1 到 10 的整数。
|
||
- **DDNS 凭据 1** 以及 **DDNS 凭据 2** 为选填，通常需要至少填 1 个。下面的[表格](#供应商列表)列出了所有供应商的对应选项。
|
||
3. 如果使用 `webhook` 供应商，那么需要按需填写 Webhook 的对应选项。具体的说明请见 [Webhook 配置说明](#webhook-配置说明)。
|
||
4. 需要至少勾选 **启用DDNS IPv4** 和 **启用DDNS IPv6** 中的一个，否则不会进行任何更新操作。
|
||
5. 在添加了新的配置后，还需要修改服务器配置才能使 DDNS 生效。服务器相关选项说明：
|
||
- **启用 DDNS**：为此服务器启用 DDNS 功能。
|
||
- **DDNS 配置**：要使用的 DDNS 配置 ID 列表，可以根据配置名称进行搜索。
|
||
|
||
## Webhook 配置说明
|
||
|
||
Webhook 需要自行构建 HTTP 请求，适用于需要使用其它供应商的服务且操作较为简单的情况。
|
||
|
||
Webhook 相关选项说明：
|
||
- **Webhook 地址**：HTTP 请求 URL。其中只有参数可以使用占位符。
|
||
- **Webhook 请求方式**：HTTP 请求方式。支持 `GET`、`POST`、`PATCH`、`DELETE` 以及 `PUT`。
|
||
- **Webhook 请求类型**：HTTP 请求体格式，为 `JSON` 或者 `Form`。
|
||
- **Webhook 请求头**：HTTP 请求头，用 JSON 填写，注意不支持嵌套。
|
||
- **Webhook 请求体**：HTTP 请求体，`GET` 和 `DELETE` 不会使用。如需使用嵌套格式，必须选择 `JSON` 作为请求类型。
|
||
|
||
Webhook 支持的占位符：
|
||
- `#ip#`：主机 IP。
|
||
- `#domain#`：DDNS 域名。每个域名的请求是分别进行的，所以此项的值只会是单个域名字符串。
|
||
- `#type#`：IP 类型，值为 `"ipv4"` 或 `"ipv6"`。
|
||
- `#record#`：记录类型，值为 `"A"` 或 `"AAAA"`。
|
||
- `#access_id#`：DDNS 凭据 1。
|
||
- `#access_secret#`：DDNS 凭据 2。
|
||
|
||
### 花生壳 Webhook 示例
|
||
<details>
|
||
<summary>点击展开/收起</summary>
|
||
|
||
- URL：`http://ddns.oray.com/ph/update?hostname=#domain#&myip=#ip#`
|
||
- 请求方式: `GET`
|
||
- 请求头：`{"Authorization": "Basic pass"}`，把 `pass` 替换成你的用户名:密码的 Base64 编码（例如，`user:pass` 为 `dXNlcjpwYXNzCg==`）。
|
||
- 花生壳只支持 A 记录，所以只勾选启用 IPv4。其它 Webhook 选项不需要填。
|
||
|
||
</details>
|
||
|
||
## 供应商列表
|
||
|
||
| 供应商 | 凭据1（ID） | 凭据2（Secret） |
|
||
| ------------ | ----------- | --------------- |
|
||
| `dummy` | ❌️ | ❌️ |
|
||
| `webhook` | 可选 | 可选 |
|
||
| `cloudflare` | ❌️ | ✅ |
|
||
| `tencentcloud`| ✅ | ✅ |
|
||
|
||
## 查看日志
|
||
|
||
在 Dashboard 的日志中，可以看到 DDNS 功能的相关日志，配置正确时，更新 DNS 记录时会有相应的日志记录。
|
||
|
||
```shell
|
||
dashboard_1 | 2024/03/16 23:16:25 NEZHA>> 正在尝试更新域名(ddns.example.com)DDNS(1/3)
|
||
dashboard_1 | 2024/03/16 23:16:28 NEZHA>> 尝试更新域名(ddns.example.com)DDNS成功
|
||
```
|