DDNS

NameSilo DNS 配置指南

概述

NameSilo 是美国知名的域名注册商和 DNS 服务提供商,提供可靠的域名管理和 DNS 解析服务,支持动态 DNS 记录的创建与更新。本 DDNS 项目通过 API Key 进行认证。

⚠️ 注意:NameSilo Provider 目前处于待验证状态,缺少充分的真实环境测试。请通过 GitHub Issues 反馈。

官网链接:

认证信息

API Key 认证

NameSilo 使用 API Key 进行身份验证,这是唯一的认证方式。

获取认证信息

  1. 登录 NameSilo 控制台
  2. 进入「Account Options」→「API Manager」或访问 https://www.namesilo.com/account/api-manager
  3. 生成新的 API Key

注意:API Key 具有账户的完整权限,请确保妥善保管,不要泄露给他人。

{
    "dns": "namesilo",
    "token": "your_api_key_here" // NameSilo API Key, ID 不需要
}

完整配置示例

{
    "$schema": "https://ddns.newfuture.cc/schema/v4.0.json", // 格式验证
    "dns": "namesilo",                  // 当前服务商
    "token": "c40031261ee449dda629d2df14e9cb63", // NameSilo API Key
    "index4": ["url:http://api.ipify.cn", "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 来源 数组 参考配置 default 公用配置
index6 IPv6 来源 数组 参考配置 default 公用配置
ipv4 IPv4 域名 数组 域名列表 公用配置
ipv6 IPv6 域名 数组 域名列表 公用配置
ttl TTL 时间 整数(秒) 300 ~ 2592000 7200 服务商参数
proxy 代理设置 数组 参考配置 公用网络
ssl SSL 验证方式 布尔/字符串 "auto"truefalse auto 公用网络
cache 缓存设置 布尔/字符串 truefalsefilepath true 公用配置
log 日志配置 对象 参考配置 公用配置

参数类型说明

注意:NameSilo 不支持 id 参数,仅使用 token 进行认证。 注意:NameSilo 官方 API 端点为 https://www.namesilo.com,除非使用代理服务,否则不建议修改。

故障排除

调试模式

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

ddns -c config.json --debug

常见问题

API 响应代码

响应代码 说明 解决方案
300 成功 操作成功
110 域名不存在 检查域名配置
280 无效的域名格式 检查域名格式
200 无效的API Key 检查API密钥

API 限制

支持与资源

⚠️ 待验证状态:NameSilo Provider 缺少充分的真实环境测试,建议在生产环境使用前进行充分测试。如遇问题请通过 GitHub Issues 反馈。