No-IP 配置指南
概述
No-IP 是流行的动态 DNS 服务提供商，支持标准的 DDNS 动态更新协议，采用 Basic Auth 认证，支持动态 DNS 记录的创建与更新。本 DDNS 项目支持通过用户名密码或 DDNS KEY 进行认证。
官网链接：
认证信息
1. DDNS KEY + ID 认证（推荐）
使用 DDNS ID 和 DDNS KEY 进行认证，更加安全。
获取DDNS KEY
- 登录 No-IP 官网
- 进入 Dynamic DNS > No-IP Hostnames
- 创建或编辑动态 DNS 主机名
- 生成 DDNS KEY 用于 API 认证
jsonc
{
"dns": "noip",
"id": "your_ddns_id", // DDNS ID
"token": "your_ddns_key" // DDNS KEY
}2. 用户名密码认证
使用 No-IP 账户用户名和密码进行认证，这是最简单的认证方式。
账号密码
- 注册或登录 No-IP 官网
- 使用注册的用户名和密码
- 在控制面板中创建主机名（hostname）
jsonc
{
"dns": "noip",
"id": "your_username", // No-IP 用户名
"token": "your_password" // No-IP 密码
}完整配置示例
jsonc
{
"$schema": "https://ddns.newfuture.cc/schema/v4.1.json", // 格式验证
"dns": "noip", // 当前服务商
"id": "myusername", // No-IP 用户名或 DDNS ID
"token": "mypassword", // No-IP 密码或 DDNS KEY
"index4": ["url:http://api.ipify.cn", "public"], // IPv4地址来源
"index6": "public", // IPv6地址来源
"ipv4": ["all.ddnskey.com"], // IPv4 域名
"ipv6": ["all.ddnskey.com"], // IPv6 域名
"endpoint": "https://dynupdate.no-ip.com" // API端点
}参数说明
| 参数 | 说明 | 类型 | 取值范围/选项 | 默认值 | 参数类型 |
|---|---|---|---|---|---|
| dns | 服务商标识 | 字符串 | noip | 无 | 服务商参数 |
| id | 认证 ID | 字符串 | No-IP 用户名或 DDNS ID | 无 | 服务商参数 |
| token | 认证密钥 | 字符串 | No-IP 密码或 DDNS KEY | 无 | 服务商参数 |
| index4 | IPv4 来源 | 数组 | 参考配置 | default | 公用配置 |
| index6 | IPv6 来源 | 数组 | 参考配置 | default | 公用配置 |
| ipv4 | IPv4 域名 | 数组 | 域名列表 | all.ddnskey.com | 公用配置 |
| ipv6 | IPv6 域名 | 数组 | 域名列表 | all.ddnskey.com | 公用配置 |
| proxy | 代理设置 | 数组 | 参考配置 | 无 | 公用网络 |
| ssl | SSL 验证方式 | 布尔/字符串 | "auto"、true、false | auto | 公用网络 |
| cache | 缓存设置 | 布尔/字符串 | true、false、filepath | true | 公用配置 |
| log | 日志配置 | 对象 | 参考配置 | 无 | 公用配置 |
参数类型说明：
- 公用配置：所有支持的DNS服务商均适用的标准DNS配置参数
- 公用网络：所有支持的DNS服务商均适用的网络设置参数
- 服务商参数：前服务商支持,值与当前服务商相关
故障排除
调试模式
启用调试日志查看详细信息：
sh
ddns -c config.json --debug常见问题
- 认证失败：检查用户名和密码是否正确，确认账户没有被禁用
- 主机名未找到：确保主机名已在 No-IP 控制面板中创建，配置拼写无误
- 更新失败：检查主机名状态是否正常，确认账户权限足够
- 请求频率限制：No-IP 建议更新间隔不少于 5 分钟，避免频繁更新
No-IP 响应代码
| 响应代码 | 说明 | 解决方案 |
|---|---|---|
good <ip> | 更新成功 | 操作成功 |
nochg <ip> | IP地址无变化 | 操作成功 |
nohost | 主机名不存在 | 检查主机名设置 |
badauth | 认证失败 | 检查用户名密码 |
badagent | 客户端被禁用 | 联系No-IP支持 |
!donator | 需要付费账户功能 | 升级账户类型 |
abuse | 账户被封禁或滥用 | 联系No-IP支持 |
API 限制
- 更新频率：建议间隔不少于 5 分钟
- 免费账户：30 天内需至少一次登录确认
- 主机名数量：免费账户限制 3 个主机名
支持与资源
建议：推荐使用 DDNS KEY 认证方式以提高安全性，定期检查主机名状态确保服务正常运行。