西部数码的域名如何实现DDNS功能(动态解析)

功能简介：
动态域名解析（Dynamic DNS，简称DDNS）可以让用户使用固定的域名来访问动态IP地址，解决因IP地址变化造成服务无法访问的情况。

本文将介绍如何使用西部数码的API实现DDNS功能，使您的域名始终指向您的动态IP地址。

API介绍：

接口地址 https://api.west.cn/API/v2/domain/dns/

接口支持两种认证方式

1、域名级认证(仅单域名)

支持参数 act=dnsrec.update&domain=指定域名&apidomainkey=域名密钥&hostname=完整子域名&record_value=设置的IP
域名KEY获取方法：

如下图所示，进入管理中心-域名管理-点击域名-右侧上方【ApiKey】 点击后复制。

2、用户级认证 (支持管理多域名，仅限代理商使用)

支持参数 act=dnsrec.update&username=用户名&apikey=用户密钥&domain=指定域名&hostname=完整子域名&record_value=设置的IP

用户KEY获取地址：https://www.west.cn/manager/API/APIconfig.asp

注意：dnsrec.update接口在更新解析时会删除存在的a记录重新添加，其他api功能可参看 域名API接口文档

使用示例：

• 群晖NAS
• openwrt - ddns-script
• DDNS-GO

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__

新增DDNS，选择west 服务商，密码/密钥请填写域名的【ApiKey】，按截图添加相应的信息

2、openwrt - ddns-script组件

配置示例

这里的域名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：子域名:根域名