# DDNS 系统

## 选择订阅支持服务商

* [x] 阿里云（国际 & 国内）
* [x] 🆕 Amazon Route 53
* [x] 🆕 Microsoft Azure
* [x] 🆕 百度智能云
* [x] CloudFlare
* [x] 🆕 ClouDNS
* [x] 🆕 DigitalOcean
* [x] 🆕 DNSimple
* [x] 🆙 DNSPod
* [x] 🆕 GoDaddy
* [x] 🆕 Google Cloud DNS
* [x] 🆕 HuaweiCloud 华为云
* [x] 🆕 Namecheap
* [x] Namesilo
* [x] 🆕 Porkbun
* [x] 🆕 Vercel
* [x] 🆕 Vultr

## 使用

1. 访问：网站地址/admin/system#extend
2. 设置【DNS服务商Key】【DNS服务商Secret】【DDNS模式】

### 设置详细

{% hint style="info" %}
✔️ 为 必填； ❌ 为 选填/不填
{% endhint %}

<table data-header-hidden><thead><tr><th width="216.33333333333331" align="center">服务商API申请链接</th><th width="245">DNS服务商Key</th><th>DNS服务商Secret</th></tr></thead><tbody><tr><td align="center"><p>服务商API</p><p>申请链接</p></td><td>DNS服务商Key</td><td>DNS服务商Secret</td></tr><tr><td align="center"><a href="https://ram.console.aliyun.com/manage/ak">阿里云（国际 &#x26; 国内）</a></td><td>✔️AccessKey ID</td><td>✔️AccessKey Secret</td></tr><tr><td align="center"><a href="https://console.aws.amazon.com/iam/home#/security_credentials">Amazon Route 53</a></td><td>✔️Access key ID 访问密钥 ID</td><td>✔️Secret access key 秘密访问密钥</td></tr><tr><td align="center">Microsoft Azure</td><td>✔️订阅ID,目录(租户) ID,应用程序(客户端) ID</td><td>✔️客户端密码【值】</td></tr><tr><td align="center"><a href="https://console.bce.baidu.com/iam/#/iam/accesslist">百度智能云</a></td><td>✔️Access Key</td><td>✔️Secret Key</td></tr><tr><td align="center"><a href="https://dash.cloudflare.com/profile/api-tokens">CloudFlare</a></td><td>✔️账号邮箱</td><td>✔️API 密钥- Global API Key</td></tr><tr><td align="center"><a href="https://www.cloudns.net/api-settings/">ClouDNS</a></td><td>✔️auth-id</td><td>✔️auth-password</td></tr><tr><td align="center"><a href="https://cloud.digitalocean.com/account/api/tokens">DigitalOcean</a></td><td>❌</td><td>✔️Personal access tokens</td></tr><tr><td align="center"><a href="https://dnsimple.com/dashboard">DNSimple</a></td><td>✔️account ID</td><td>✔️Access tokens</td></tr><tr><td align="center"><a href="https://console.dnspod.cn/account/token">DNSPod</a></td><td>✔️ SecretId</td><td>✔️SecretKey</td></tr><tr><td align="center"><a href="https://developer.godaddy.com/keys">GoDaddy</a></td><td>✔️Key</td><td>✔️Secret</td></tr><tr><td align="center"><a href="https://console.cloud.google.com/apis/credentials">Google</a></td><td>❌</td><td>✔️credentials</td></tr><tr><td align="center"><a href="https://console.huaweicloud.com/iam/#/mine/accessKey">HuaweiCloud 华为云</a></td><td>✔️Access Key ID</td><td>✔️Secret Access Key</td></tr><tr><td align="center"><a href="https://ap.www.namecheap.com/settings/tools/apiaccess/">Namecheap</a></td><td>✔️Username</td><td>✔️API Key</td></tr><tr><td align="center"><a href="https://www.namesilo.com/account/api-manager">Namesilo</a></td><td>❌</td><td>✔️API key</td></tr><tr><td align="center"><a href="https://porkbun.com/account/api">Porkbun</a></td><td>✔️API Key</td><td>✔️Secret Key</td></tr><tr><td align="center"><a href="https://vercel.com/account/tokens">Vercel</a></td><td>✔️Team ID</td><td>✔️Token</td></tr><tr><td align="center"><a href="https://my.vultr.com/settings/#settingsapi">Vultr</a></td><td>❌</td><td>✔️API Key</td></tr></tbody></table>

#### 备注 / 注意事项

<details>

<summary>Microsoft Azure</summary>

Key值 为 `订阅ID,目录(租户) ID,应用程序(客户端) ID`，这3个值用`,`连接！

1. 获取订阅ID: <https://portal.azure.com/#view/Microsoft_Azure_Billing/SubscriptionsBladeV2>
2. 创建客户端，获取 【应用程序(客户端) ID】 和 【目录(租户) ID】<br>

   <div data-full-width="true"><figure><img src="https://2245841974-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MCJ37x3F9xZgjO4aIyo%2Fuploads%2FUzj23iWBaGtrgOO42gA1%2Ff1f11196ab0bbc798012f4fbe053b3a2.png?alt=media&#x26;token=0911863f-313a-434e-a60b-007df7a51e3e" alt="创建客户端" width="563"><figcaption><p>创建客户端</p></figcaption></figure></div>

   <figure><img src="https://2245841974-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MCJ37x3F9xZgjO4aIyo%2Fuploads%2FTGmN0JHZF0bCsvzlGhOS%2Fc119589d1ca79acf47b80d81b19d92d0.png?alt=media&#x26;token=8bb51aff-1dd8-42b1-9797-cd3ce8799d28" alt="" width="563"><figcaption><p>获取 【应用程序(客户端) ID】 和 【目录(租户) ID】</p></figcaption></figure>
3. 创建客户端密码 获取 客户端密码【值】<br>

   <figure><img src="https://2245841974-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MCJ37x3F9xZgjO4aIyo%2Fuploads%2FLJb2mLeAOESKki67druK%2Fd6f792d75f4563edf6f4aefd814b6727.png?alt=media&#x26;token=ad92f50b-0eea-465c-a61b-eb7663badc39" alt="" width="563"><figcaption><p>获取 客户端密码【值】</p></figcaption></figure>
4. 给予客户端访问权限 （可重复设置多个域名的权限，DDNS系统能区分不同域名）；
   1. 前往 DNS 区域，对应的域名；

      <figure><img src="https://2245841974-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MCJ37x3F9xZgjO4aIyo%2Fuploads%2FaFqnlkOpsMZfQP42v56v%2Fd0f3aeccfdbcefe0ea87130388cbebc4.png?alt=media&#x26;token=d5eddb85-4177-4ea3-814f-141119f626f4" alt=""><figcaption><p>添加角色分配</p></figcaption></figure>
   2. 添加角色, DNS 区域参与者；<br>

      <figure><img src="https://2245841974-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MCJ37x3F9xZgjO4aIyo%2Fuploads%2FV5D6phfIYoOgWCDjNXHB%2F90b85bc45ecfb7118534a3358d52164a.png?alt=media&#x26;token=17659901-2ecf-4176-8493-337465772838" alt="" width="563"><figcaption><p>搜索 [DNS]</p></figcaption></figure>

      <figure><img src="https://2245841974-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MCJ37x3F9xZgjO4aIyo%2Fuploads%2FpCEdfPGOg0gTDzjOpCTN%2F57cd0b00806174b90db06d1ab80b178a.png?alt=media&#x26;token=3592d6cb-9a3c-4673-b853-3e5fdb01227f" alt="" width="563"><figcaption><p>搜索 【客户端名称】</p></figcaption></figure>

      审批和分配完，既可

</details>

<details>

<summary>CloudFlare</summary>

API 不支持`cf，ga，gq，ml，tk`结尾的域名！！！

</details>

<details>

<summary>DigitalOcean</summary>

Custom Scopes 中勾选 domain；

</details>

<details>

<summary>DNSimple</summary>

相关信息获取路径为 Account => Access tokens；

</details>

<details>

<summary>GoDaddy</summary>

相关信息获取路径为 Account => Access tokens；

</details>

<details>

<summary>Google Cloud DNS</summary>

* 确保 Cloud DNS API 服务已经开启；在<https://console.cloud.google.com/apis/dashboard>开启
  * 在这里点击启用 开启<https://console.cloud.google.com/marketplace/product/google/dns.googleapis.com><br>

    <figure><img src="https://2245841974-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MCJ37x3F9xZgjO4aIyo%2Fuploads%2Fbtdy78H4TcQ18zfbQ7UD%2Fimage.png?alt=media&#x26;token=ade69a89-4d26-4595-abee-b5d1345fdf81" alt="" width="521"><figcaption></figcaption></figure>
* 从 <https://console.cloud.google.com/apis/credentials> 创建&下载 `服务账号`
* 赋予角色 `DNS Administrator`

  <figure><img src="https://2245841974-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MCJ37x3F9xZgjO4aIyo%2Fuploads%2FjlcGwgrJU60DvtGPriZU%2Fimage.png?alt=media&#x26;token=68d07891-345f-44f7-bbe4-3e9d7407d867" alt="" width="431"><figcaption></figcaption></figure>
* 创建密钥 json 类型<br>

  <figure><img src="https://2245841974-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MCJ37x3F9xZgjO4aIyo%2Fuploads%2F6F9ybyz3zITWDGxOfvfn%2Fimage.png?alt=media&#x26;token=84eac4fa-afb9-44b4-b1a2-624186ea2c08" alt="" width="495"><figcaption></figcaption></figure>

可以将自动下载的json文件中内容全部填入Secret中，其中含有以下内容。其余值可以不保留；

```
project_id
private_key_id
client_email
private_key
```

</details>

<details>

<summary>Namecheap</summary>

* API 开通资格的前置条件：账户余额超过 50 美元，账户中的域名超过 20 个，或在过去两年内购买的域名总价值超过 50 美元；
* 请将会使用本服务的服务器IP 在 【Whitelisted IPs】中加白；

</details>

<details>

<summary>Porkbun</summary>

API 功能开启参考 <https://kb.porkbun.com/article/190-getting-started-with-the-porkbun-dns-api>

</details>

<details>

<summary>Vercel</summary>

域名所在 Project => Settings => General,  获取 Team ID；

</details>

<details>

<summary>Vultr</summary>

请将会使用本服务的服务器IP 在 【Access Control】中加白；

</details>

### 触发条件

{% hint style="info" %}
本系统默认使用的是子域名；例：当域名为baidu.com， 那么node.baidu.com，ex.test.baidu.com 均为baidu.com的子域名。
{% endhint %}

#### 节点添加

* 自动将子域名（面板标签为域名），IPV4和IPV6信息进行绑定；

#### 节点编辑

* 修改子域名时，自动删除原有域名，并将IPV4和IPV6加入至新域名
* 修改IP时，自动修改原有域名，至最新IP地址；

#### 节点删除

* 删除使用的子域名

#### 注意事项

* 当节点设置中开启了【DDNS】，本系统将不会主动设置该节点；

## 对接新服务商教程

{% hint style="info" %}
下表中提及文件皆可作为新对接文件的参考和代码规范资料！
{% endhint %}

将对接文件置于 `\app\Utils\DDNS` 下