西部数码的域名如何实现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获取地址:

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

使用示例:

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

1、群晖NAS

首先添加自定义服务商

服务供应商: 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组件

配置示例

service_name--custom--update_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部分换为您自己的域名,如您不使用二级域名可直接替换test.domain.com为domain.com)domain/域名test.domain.com (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:子域名:根域名

商务达