ddclient项目中多级子域名解析问题的解决方案

在动态DNS更新工具ddclient中，当用户尝试配置多级子域名（如sub2.sub1.domain.com）时，可能会遇到域名解析失败的问题。这一问题源于ddclient在处理多级子域名时的拆分逻辑存在缺陷，导致生成的API请求不符合Porkbun DNS服务的预期格式。

问题分析

在默认配置下，ddclient会将"sub2.sub1.domain.com"拆分为：

• 子域名部分："sub2"
• 主域名部分："sub1.domain.com"

这种拆分方式会导致生成的API请求路径为：

/dns/retrieveByNameType/sub1.domain.com/A/sub2

而实际上Porkbun API期望的格式应该是：

/dns/retrieveByNameType/domain.com/A/sub2.sub1

解决方案

ddclient开发团队针对这一问题进行了修复，引入了新的配置参数root-domain。用户可以通过以下方式配置多级子域名：

usev6=ifv6, ifv6=pppoe0, \
usev4=ifv4, ifv4=pppoe0, \
protocol=porkbun, \
apikey=your_api_key, \
secretapikey=your_secret_key, \
login=your_api_key, \
root-domain=domain.com, \
password=your_secret_key \
sub2.sub1.domain.com

实现原理

新加入的root-domain参数允许用户显式指定根域名，ddclient会根据这个参数正确拆分多级子域名：

• 根域名部分：用户指定的domain.com
• 子域名部分：sub2.sub1

这样生成的API请求就能正确匹配Porkbun服务的预期格式，解决了多级子域名更新的问题。

注意事项

1. 该解决方案已通过实际测试验证有效性
2. 用户迁移到Porkbun等服务时可能会遇到类似问题，建议检查配置
3. 目前发现Porkbun服务会清除DNS记录中的notes字段，这是服务端行为

总结

ddclient的这一改进为使用多级子域名的用户提供了更好的支持，特别是对于那些从其他DNS服务迁移到Porkbun的用户。通过明确指定根域名，用户可以灵活地配置任意层级的子域名，确保动态DNS更新功能正常工作。

对于系统管理员和网络工程师来说，理解这一配置方式有助于更高效地管理复杂的域名解析需求，特别是在需要为不同层级的服务配置独立DNS记录的场景下。