mirror of
https://github.com/NewFuture/DDNS.git
synced 2026-10-19 16:15:45 +00:00
Copilot
7490657d82
* fix(ip): remove unavailable ipify cn endpoint * test(ip): avoid substring matching in fallback test * fix(ip): remove unavailable ipw endpoints * fix(ip): add ddnsip public endpoints * docs: use http ipify URL in examples --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
115 lines
5.3 KiB
Markdown
115 lines
5.3 KiB
Markdown
# NameSilo DNS 配置指南
|
||
|
||
## 概述
|
||
|
||
NameSilo 是美国知名的域名注册商和 DNS 服务提供商，提供可靠的域名管理和 DNS 解析服务，支持动态 DNS 记录的创建与更新。本 DDNS 项目通过 API Key 进行认证。
|
||
|
||
> ⚠️ **注意**：NameSilo Provider 目前处于**待验证**状态，缺少充分的真实环境测试。请通过 [GitHub Issues](https://github.com/NewFuture/DDNS/issues) 反馈。
|
||
|
||
官网链接：
|
||
|
||
- 官方网站：<https://www.namesilo.com/>
|
||
- 服务商控制台：<https://www.namesilo.com/account_home.php>
|
||
|
||
## 认证信息
|
||
|
||
### API Key 认证
|
||
|
||
NameSilo 使用 API Key 进行身份验证，这是唯一的认证方式。
|
||
|
||
#### 获取认证信息
|
||
|
||
1. 登录 [NameSilo 控制台](https://www.namesilo.com/account_home.php)
|
||
2. 进入「Account Options」→「API Manager」或访问 <https://www.namesilo.com/account/api-manager>
|
||
3. 生成新的 API Key
|
||
|
||
> **注意**：API Key 具有账户的完整权限，请确保妥善保管，不要泄露给他人。
|
||
|
||
```jsonc
|
||
{
|
||
"dns": "namesilo",
|
||
"token": "your_api_key_here" // NameSilo API Key, ID 不需要
|
||
}
|
||
```
|
||
|
||
## 完整配置示例
|
||
|
||
```jsonc
|
||
{
|
||
"$schema": "https://ddns.newfuture.cc/schema/v4.1.json", // 格式验证
|
||
"dns": "namesilo", // 当前服务商
|
||
"token": "c40031261ee449dda629d2df14e9cb63", // NameSilo API Key
|
||
"index4": ["url:http://api.ipify.org", "public"], // IPv4地址来源
|
||
"index6": "public", // IPv6地址来源
|
||
"ipv4": ["ddns.newfuture.cc"], // IPv4 域名
|
||
"ipv6": ["ddns.newfuture.cc", "ipv6.ddns.newfuture.cc"], // IPv6 域名
|
||
"ttl": 3600 // DNS记录TTL（秒）
|
||
}
|
||
```
|
||
|
||
### 参数说明
|
||
|
||
| 参数 | 说明 | 类型 | 取值范围/选项 | 默认值 | 参数类型 |
|
||
| :-----: | :----------- | :------------- | :--------------------------------- | :-------- | :--------- |
|
||
| dns | 服务商标识 | 字符串 | `namesilo` | 无 | 服务商参数 |
|
||
| token | 认证密钥 | 字符串 | NameSilo API Key | 无 | 服务商参数 |
|
||
| index4 | IPv4 来源 | 数组 | [参考配置](../config/json.md#ipv4-ipv6) | `default` | 公用配置 |
|
||
| index6 | IPv6 来源 | 数组 | [参考配置](../config/json.md#ipv4-ipv6) | `default` | 公用配置 |
|
||
| ipv4 | IPv4 域名 | 数组 | 域名列表 | 无 | 公用配置 |
|
||
| ipv6 | IPv6 域名 | 数组 | 域名列表 | 无 | 公用配置 |
|
||
| ttl | TTL 时间 | 整数（秒） | 300 ~ 2592000 | `7200` | 服务商参数 |
|
||
| proxy | 代理设置 | 数组 | [参考配置](../config/json.md#proxy) | 无 | 公用网络 |
|
||
| ssl | SSL 验证方式 | 布尔/字符串 | `"auto"`、`true`、`false` | `auto` | 公用网络 |
|
||
| cache | 缓存设置 | 布尔/字符串 | `true`、`false`、`filepath` | `true` | 公用配置 |
|
||
| log | 日志配置 | 对象 | [参考配置](../config/json.md#log) | 无 | 公用配置 |
|
||
|
||
> **参数类型说明**：
|
||
>
|
||
> - **公用配置**：所有支持的DNS服务商均适用的标准DNS配置参数
|
||
> - **公用网络**：所有支持的DNS服务商均适用的网络设置参数
|
||
> - **服务商参数**：当前服务商支持,值与当前服务商相关
|
||
>
|
||
> **注意**：NameSilo 不支持 `id` 参数，仅使用 `token` 进行认证。
|
||
> **注意**：NameSilo 官方 API 端点为 `https://www.namesilo.com`，除非使用代理服务，否则不建议修改。
|
||
|
||
## 故障排除
|
||
|
||
### 调试模式
|
||
|
||
启用调试日志查看详细信息：
|
||
|
||
```sh
|
||
ddns -c config.json --debug
|
||
```
|
||
|
||
### 常见问题
|
||
|
||
- **认证失败**：检查 API Key 是否正确，确认 API Key 没有被禁用，验证账户状态是否正常
|
||
- **域名未找到**：确保域名已添加到 NameSilo 账户，配置拼写无误，域名处于活跃状态
|
||
- **记录创建失败**：检查子域名格式是否正确，TTL 值在允许范围内（300-2592000秒），验证是否存在冲突记录
|
||
- **请求频率限制**：NameSilo 有 API 调用频率限制（建议每分钟不超过 60 次），降低请求频率
|
||
|
||
### API 响应代码
|
||
|
||
| 响应代码 | 说明 | 解决方案 |
|
||
| :------ | :----------- | :----------------- |
|
||
| 300 | 成功 | 操作成功 |
|
||
| 110 | 域名不存在 | 检查域名配置 |
|
||
| 280 | 无效的域名格式 | 检查域名格式 |
|
||
| 200 | 无效的API Key | 检查API密钥 |
|
||
|
||
## API 限制
|
||
|
||
- **请求频率**：建议每分钟不超过 60 次请求
|
||
- **域名数量**：根据账户类型不同而限制
|
||
- **记录数量**：每个域名最多 100 条 DNS 记录
|
||
|
||
## 支持与资源
|
||
|
||
- [NameSilo 官网](https://www.namesilo.com/)
|
||
- [NameSilo API 文档](https://www.namesilo.com/api-reference)
|
||
- [NameSilo 控制台](https://www.namesilo.com/account_home.php)
|
||
- [NameSilo API Manager](https://www.namesilo.com/account/api-manager)
|
||
|
||
> ⚠️ **待验证状态**：NameSilo Provider 缺少充分的真实环境测试，建议在生产环境使用前进行充分测试。如遇问题请通过 [GitHub Issues](https://github.com/NewFuture/DDNS/issues) 反馈。
|