DDNS/docs/providers/west.md

西部数码 配置指南

概述

西部数码 (west.cn) 是中国知名的域名服务商，提供域名注册、DNS解析等服务。本 DDNS 项目支持西部数码的动态 DNS 记录管理。

官网链接：

• 官方网站：https://www.west.cn/
• API文档：https://console-docs.apipost.cn/preview/bf57a993975b67e0/7b363d9b8808faa2

注意：三五互联 (35.cn) 使用相同的 API，可以使用 35cn 作为服务商标识。

认证信息

西部数码支持两种认证方式：

1. 域名认证方式（推荐）

使用域名管理密码进行认证，只需要 token（apidomainkey）。

获取认证信息

1. 登录 西部数码会员中心
2. 进入"域名管理" > 选择域名 > "管理密码"
3. 复制 APIkey（32位 MD5 值），这是域名管理密码的 MD5 哈希值

{
    "dns": "west",
    "token": "ec4c66e34561428b2e9ad65048f9bsed"  // 域名 APIkey
}

2. 账号认证方式

使用会员账号和 API 密码进行认证。

获取认证信息

1. 登录 西部数码会员中心
2. 进入"账号管理" > "API接口设置"
3. 设置 API 密码
4. id 填写您的会员账号
5. token 填写 API 密码的 32 位 MD5 值

{
    "dns": "west",
    "id": "your_username",                      // 会员账号
    "token": "md5_of_your_api_password"         // API密码的MD5值
}

完整配置示例

域名认证方式

{
    "$schema": "https://ddns.newfuture.cc/schema/v4.1.json",
    "dns": "west",
    "token": "ec4c66e34561428b2e9ad65048f9bsed",
    "index4": ["url:http://api.ipify.cn", "public"],
    "index6": "public",
    "ipv4": ["ddns.example.com"],
    "ipv6": ["ipv6.example.com"],
    "ttl": 900
}

账号认证方式

{
    "$schema": "https://ddns.newfuture.cc/schema/v4.1.json",
    "dns": "west",
    "id": "your_username",
    "token": "md5_of_your_api_password",
    "index4": ["url:http://api.ipify.cn", "public"],
    "index6": "public",
    "ipv4": ["ddns.example.com"],
    "ipv6": ["ipv6.example.com"],
    "ttl": 900
}

三五互联配置

三五互联使用相同的 API，只需更改 dns 参数或使用 endpoint 参数：

{
    "$schema": "https://ddns.newfuture.cc/schema/v4.1.json",
    "dns": "35cn",
    "token": "your_apidomainkey",
    "endpoint": "https://api.35.cn/API/v2/domain/dns/",
    "ipv4": ["ddns.example.com"]
}

参数说明

参数	说明	类型	取值范围/选项	默认值	参数类型
dns	服务商标识	字符串	west, 35cn	无	服务商参数
id	会员账号	字符串	账号认证时必填	无	服务商参数
token	认证密钥	字符串	apidomainkey 或 MD5(API密码)	无	服务商参数
endpoint	API地址	字符串	自定义API端点	西部数码	服务商参数
index4	IPv4 来源	数组	参考配置	default	公用配置
index6	IPv6 来源	数组	参考配置	default	公用配置
ipv4	IPv4 域名	数组	域名列表	无	公用配置
ipv6	IPv6 域名	数组	域名列表	无	公用配置
line	解析线路	字符串	参考下方	默认	服务商参数
ttl	TTL 时间	整数（秒）	60 ~ 86400	900	服务商参数
proxy	代理设置	数组	参考配置	无	公用网络
ssl	SSL 验证方式	布尔/字符串	"auto"、true、false	auto	公用网络
cache	缓存设置	布尔/字符串	true、false、filepath	true	公用配置
log	日志配置	对象	参考配置	无	公用配置

参数类型说明：

• 公用配置：所有支持的DNS服务商均适用的标准DNS配置参数
• 公用网络：所有支持的DNS服务商均适用的网络设置参数
• 服务商参数：当前服务商支持，值与当前服务商相关

line

line 参数指定 DNS 解析线路，西部数码支持的线路代码：

线路代码	说明
（空）	默认线路
LTEL	中国电信
LCNC	中国联通
LMOB	中国移动
LEDU	中国教育网
LSEO	搜索引擎
LFOR	境外访问

故障排除

调试模式

启用调试日志查看详细信息：

ddns -c config.json --debug

常见问题

• 认证失败：检查 APIkey 或账号密码是否正确，确认 token 是 32 位 MD5 值
• 域名未找到：确保域名已在西部数码账号下，配置拼写无误
• 记录创建失败：检查子域名是否有冲突记录，TTL 设置是否合理
• 请求频率限制：降低请求频率

支持与资源

• 西部数码官网
• 西部数码会员中心
• API 文档
• 三五互联官网

建议：推荐使用域名认证方式（apidomainkey），配置更简单且更安全。