mirror of
https://github.com/NewFuture/DDNS.git
synced 2026-10-21 12:03:21 +00:00
93d4698ff7
* Initial plan * feat(provider.west): add West.cn DNS provider support Co-authored-by: NewFuture <6290356+NewFuture@users.noreply.github.com> * refactor(provider.west): address review feedback - remove LINE_MAPPING, implement domain fallback, update docs Co-authored-by: NewFuture <6290356+NewFuture@users.noreply.github.com> * fix(provider.west): improve logging format for root domain Co-authored-by: NewFuture <6290356+NewFuture@users.noreply.github.com> * Apply suggestion from @Copilot Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * fix(provider.west): correct comment about domain parsing order and clarify error code handling Co-authored-by: NewFuture <6290356+NewFuture@users.noreply.github.com> * refactor(provider.west): simplify domain not found check to use code=404 Co-authored-by: NewFuture <6290356+NewFuture@users.noreply.github.com> --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: NewFuture <6290356+NewFuture@users.noreply.github.com> Co-authored-by: New Future <NewFuture@users.noreply.github.com> Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
166 lines
5.8 KiB
Markdown
166 lines
5.8 KiB
Markdown
# 西部数码 配置指南
|
||
|
||
## 概述
|
||
|
||
西部数码 (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. 登录 [西部数码会员中心](https://www.west.cn/manager/)
|
||
2. 进入"域名管理" > 选择域名 > "管理密码"
|
||
3. 复制 **APIkey**（32位 MD5 值），这是域名管理密码的 MD5 哈希值
|
||
|
||
```json
|
||
{
|
||
"dns": "west",
|
||
"token": "ec4c66e34561428b2e9ad65048f9bsed" // 域名 APIkey
|
||
}
|
||
```
|
||
|
||
### 2. 账号认证方式
|
||
|
||
使用会员账号和 API 密码进行认证。
|
||
|
||
#### 获取认证信息
|
||
|
||
1. 登录 [西部数码会员中心](https://www.west.cn/manager/)
|
||
2. 进入"账号管理" > "API接口设置"
|
||
3. 设置 API 密码
|
||
4. `id` 填写您的会员账号
|
||
5. `token` 填写 API 密码的 32 位 MD5 值
|
||
|
||
```json
|
||
{
|
||
"dns": "west",
|
||
"id": "your_username", // 会员账号
|
||
"token": "md5_of_your_api_password" // API密码的MD5值
|
||
}
|
||
```
|
||
|
||
## 完整配置示例
|
||
|
||
### 域名认证方式
|
||
|
||
```json
|
||
{
|
||
"$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
|
||
}
|
||
```
|
||
|
||
### 账号认证方式
|
||
|
||
```json
|
||
{
|
||
"$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` 参数：
|
||
|
||
```json
|
||
{
|
||
"$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 来源 | 数组 | [参考配置](../config/json.md#ipv4-ipv6) | `default` | 公用配置 |
|
||
| index6 | IPv6 来源 | 数组 | [参考配置](../config/json.md#ipv4-ipv6) | `default` | 公用配置 |
|
||
| ipv4 | IPv4 域名 | 数组 | 域名列表 | 无 | 公用配置 |
|
||
| ipv6 | IPv6 域名 | 数组 | 域名列表 | 无 | 公用配置 |
|
||
| line | 解析线路 | 字符串 | [参考下方](#line) | 默认 | 服务商参数 |
|
||
| ttl | TTL 时间 | 整数（秒） | 60 ~ 86400 | `900` | 服务商参数 |
|
||
| proxy | 代理设置 | 数组 | [参考配置](../config/json.md#proxy) | 无 | 公用网络 |
|
||
| ssl | SSL 验证方式 | 布尔/字符串 | `"auto"`、`true`、`false` | `auto` | 公用网络 |
|
||
| cache | 缓存设置 | 布尔/字符串 | `true`、`false`、`filepath` | `true` | 公用配置 |
|
||
| log | 日志配置 | 对象 | [参考配置](../config/json.md#log) | 无 | 公用配置 |
|
||
|
||
> **参数类型说明**：
|
||
>
|
||
> - **公用配置**：所有支持的DNS服务商均适用的标准DNS配置参数
|
||
> - **公用网络**：所有支持的DNS服务商均适用的网络设置参数
|
||
> - **服务商参数**：当前服务商支持，值与当前服务商相关
|
||
|
||
### line
|
||
|
||
`line` 参数指定 DNS 解析线路，西部数码支持的线路代码：
|
||
|
||
| 线路代码 | 说明 |
|
||
| :------- | :----------- |
|
||
| （空） | 默认线路 |
|
||
| LTEL | 中国电信 |
|
||
| LCNC | 中国联通 |
|
||
| LMOB | 中国移动 |
|
||
| LEDU | 中国教育网 |
|
||
| LSEO | 搜索引擎 |
|
||
| LFOR | 境外访问 |
|
||
|
||
## 故障排除
|
||
|
||
### 调试模式
|
||
|
||
启用调试日志查看详细信息：
|
||
|
||
```sh
|
||
ddns -c config.json --debug
|
||
```
|
||
|
||
### 常见问题
|
||
|
||
- **认证失败**：检查 APIkey 或账号密码是否正确，确认 token 是 32 位 MD5 值
|
||
- **域名未找到**：确保域名已在西部数码账号下，配置拼写无误
|
||
- **记录创建失败**：检查子域名是否有冲突记录，TTL 设置是否合理
|
||
- **请求频率限制**：降低请求频率
|
||
|
||
## 支持与资源
|
||
|
||
- [西部数码官网](https://www.west.cn/)
|
||
- [西部数码会员中心](https://www.west.cn/manager/)
|
||
- [API 文档](https://console-docs.apipost.cn/preview/bf57a993975b67e0/7b363d9b8808faa2)
|
||
- [三五互联官网](https://www.35.cn/)
|
||
|
||
> **建议**：推荐使用域名认证方式（apidomainkey），配置更简单且更安全。
|