DDNS

DNS Provider 配置指南

本目录包含各个DNS服务商的详细配置指南。DDNS支持多个主流DNS服务商，每个服务商都有其特定的配置要求和API特性。

🚀 快速导航

有详细配置文档的Provider

Provider	服务商	配置文档	英文文档	特点
dnspod	DNSPod 中国版	dnspod.md	dnspod.en.md	国内最大DNS服务商
alidns	阿里云 DNS	alidns.md	alidns.en.md	阿里云生态集成
tencentcloud	腾讯云 DNSPod	tencentcloud.md	tencentcloud.en.md	腾讯云DNSPod服务
noip	No-IP	noip.md	noip.en.md	流行的动态DNS服务
callback	自定义API (Webhook)	callback.md	callback.en.md	自定义HTTP API

其他支持的Provider

Provider	服务商	官方文档	状态
cloudflare	Cloudflare	API文档	⚠️ 缺少充分测试
dnscom	DNS.COM	API文档	⚠️ 缺少充分测试
dnspod_com	DNSPod 国际版	API文档	国际版DNSPod
he	HE.net	DDNS文档	⚠️ 缺少充分测试，不支持自动创建记录
huaweidns	华为云 DNS	API文档	⚠️ 缺少充分测试

⚙️ 特殊配置说明

支持自动创建记录

大部分provider支持自动创建不存在的DNS记录，但有例外：

• ❌ HE.net: 不支持自动创建记录，需要手动在控制面板中预先创建

📝 配置示例

命令行配置

# DNSPod中国版
ddns --dns dnspod --id 12345 --token your_token --ipv4 example.com

# 阿里云DNS
ddns --dns alidns --id your_access_key --token your_secret --ipv4 example.com

# Cloudflare (使用邮箱)
ddns --dns cloudflare --id user@example.com --token your_api_key --ipv4 example.com

# Cloudflare (使用Token)
ddns --dns cloudflare --token your_api_token --ipv4 example.com

# No-IP
ddns --dns noip --id your_username --token your_password --ipv4 example.com

JSON配置文件

{
  "$schema": "https://ddns.newfuture.cc/schema/v4.0.json",
  "dns": "dnspod",
  "id": "12345",
  "token": "your_token_here",
  "ipv4": ["ddns.example.com", "*.example.com"],
  "ipv6": ["ddns.example.com"],
  "ttl": 600
}

环境变量配置

export DDNS_DNS=dnspod
export DDNS_ID=12345
export DDNS_TOKEN=your_token_here
export DDNS_IPV4=ddns.example.com
ddns --debug

📚 相关文档

• 命令行配置 - 命令行参数详细说明
• JSON配置 - JSON配置文件格式说明
• 环境变量配置 - 环境变量配置方式
• Provider开发指南 - 如何开发新的provider
• JSON Schema - 配置文件验证架构

---

如有疑问或需要帮助，请查看 FAQ 或在 GitHub Issues 中提问。

This site is open source. Improve this page.