西部數碼的域名如何實現DDNS功能(動態解析)
發佈時間:2023-11-06
功能簡介:
動態域名解析(Dynamic DNS,簡稱DDNS)可以讓用戶使用固定的域名來訪問動態IP地址,解決因IP地址變化造成服務無法訪問的情況。
本文將介紹如何使用西部數碼的API實現DDNS功能,使您的域名始終指向您的動態IP地址。
API介紹:
接口地址 https://api.west.cn/API/v2/domain/dns/ 相關文檔>>
接口支持兩種認證方式
1、域名級認證(僅單域名)
支持參數 https://api.west.cn/API/v2/domain/dns/?act=dnsrec.update&domain=指定域名&apidomainkey=域名密鑰&hostname=完整子域名&record_value=設置的IP
域名KEY獲取方法:
如下圖所示,進入管理中心-域名管理-點擊域名-右側上方【ApiKey】 點擊後複製。

2、用戶級認證 (支持管理多域名,僅限代理商使用)
支持參數 https://api.west.cn/API/v2/domain/dns/?act=dnsrec.update&username=用戶名&apikey=用戶密鑰&domain=指定域名&hostname=完整子域名&record_value=設置的IP
用戶KEY獲取地址:https://www.west.cn/manager/API/APIconfig.asp

注意:dnsrec.update接口在更新解析時會刪除存在的a記錄重新添加,其他api功能可參看 域名API接口文檔
使用示例:
配置示例 (不兼容IPv6,如需IPv6建議使用DDNS-GO的第三方套件或Docker實例)
首先添加自定義服務商
服務供應商:
west
Query URL:
https://api.west.cn/API/v2/domain/dns/?act=dnsrec.update&domain=__USERNAME__&hostname=__HOSTNAME__&record_value=__MYIP__&apidomainkey=__PASSWORD__

新增DDNS,選擇west 服務商,密碼/密鑰請填寫域名的【ApiKey】,按截圖添加相應的信息

配置示例
| 參數名稱 (英/中) | 參數值 | 配置說明 |
| Service provider/服務提供商 | --custom-- | |
| update_url/自定義更新URL | https://api.west.cn/API/v2/domain/dns/?act=dnsrec.update&domain=[USERNAME]&hostname=[DOMAIN]&record_value=[IP]&apidomainkey=[PASSWORD] | |
| LookupHost/查詢主機名 | test.domain.com | 此項為要解析的主機名,如test.domain.com或者domain.com |
| domain/域名 | test.domain.com | 此項為要解析的主機名,如test.domain.com或者domain.com |
| username/用戶名 | domain.com | 填寫為主域名 |
| password/密碼 | 域名KEY | 填寫域名詳情頁的【ApiKey】 |
這裡的域名KEY填寫域名詳情頁的【ApiKey】,獲取方法見本文第一條。
注意:custom 模式下,您需要先在西部數碼的域名控制面板中手工添加一條 test.domain.com(其中test.domain.com要換為您自己的實際域名情況) 的A記錄解析。
配置示例 (兼容IPv6)
DNS服務商選擇【Callback】
URL:https://api.west.cn/API/v2/domain/dns/
RequestBody:act=dnsrec.update&domain=#{domain}&hostname=#{domain}&record_value=#{ip}&apidomainkey=域名KEY
注意這裡的域名KEY填寫域名詳情頁的【ApiKey】,獲取方法見本文第一條。
Domains:子域名:根域名
注意在實際填寫時,將截圖中的:ddnsgo:westlytest.top 部分換為您自己的實際 情況,其中 ddnsgo 這部分是指子域名,可以定義為其他子域名,如bbs。
westlytest.top 這個換為您自己的域名。

