西部數碼的域名如何實現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】 點擊後複製。

image.png


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

image.png

注意:dnsrec.update接口在更新解析時會刪除存在的a記錄重新添加,其他api功能可參看 域名API接口文檔


使用示例:



1、群暉NAS - 內置DDNS


配置示例 (不兼容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__

image.png

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

image.png


2、openwrt - ddns-script組件

配置示例

參數名稱 (英/中)
參數值配置說明
Service provider/服務提供商--custom--
update_url/自定義更新URLhttps://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記錄解析。


3、DDNS-GO

配置示例 (兼容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 這個換為您自己的域名。

image.png