西部数码的域名如何实现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:子域名:根域名