mirror of https://github.com/NewFuture/DDNS.git synced 2026-10-19 16:15:45 +00:00

Files

T

Copilot 7490657d82 Use HTTP ipify URL in documentation examples (#694 )

* 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>

2026-06-12 19:51:59 +08:00

5.3 KiB

Raw Permalink Blame History

NameSilo DNS 配置指南

概述

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

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

官网链接：

官方网站：https://www.namesilo.com/
服务商控制台：https://www.namesilo.com/account_home.php

认证信息

API Key 认证

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

获取认证信息

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

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

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

完整配置示例

{
    "$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 来源	数组	参考配置	`default`	公用配置
index6	IPv6 来源	数组	参考配置	`default`	公用配置
ipv4	IPv4 域名	数组	域名列表	无	公用配置
ipv6	IPv6 域名	数组	域名列表	无	公用配置
ttl	TTL 时间	整数（秒）	300 ~ 2592000	`7200`	服务商参数
proxy	代理设置	数组	参考配置	无	公用网络
ssl	SSL 验证方式	布尔/字符串	`"auto"`、`true`、`false`	`auto`	公用网络
cache	缓存设置	布尔/字符串	`true`、`false`、`filepath`	`true`	公用配置
log	日志配置	对象	参考配置	无	公用配置

参数类型说明：

公用配置：所有支持的DNS服务商均适用的标准DNS配置参数

公用网络：所有支持的DNS服务商均适用的网络设置参数

服务商参数：当前服务商支持,值与当前服务商相关

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

故障排除

调试模式

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

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 Provider 缺少充分的真实环境测试，建议在生产环境使用前进行充分测试。如遇问题请通过 GitHub Issues 反馈。

5.3 KiB Raw Permalink Blame History Unescape Escape