西部数码的域名如何实现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】 点击后复制。

image.png


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

支持参数 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:子域名:根域名

image.png


编辑:西部数码
日期:2023-11-06

收藏 】 【 打印 】   
您可对文档进行评分哟~

勾选遇到的问题提交给我们,收到反馈后保证及时修正更新!

提交反馈需要先登陆会员帐号

上一篇:使用westssl工具实现自动更新SSL证书的流程
下一篇:RDS恢复其中某个数据库备份的流程
若文档内容对您没有帮助,不能解决问题? 您还可以 咨询在线客服提交工单搜索常见问题 ,我们将竭诚为您服务。
  >> 相关文章
 
分享至: