首页
/ ddns-updater项目中的Porkbun DNS提供商通配符记录更新问题解析

ddns-updater项目中的Porkbun DNS提供商通配符记录更新问题解析

2025-07-02 17:04:29作者:董宙帆

问题背景

在ddns-updater项目中,用户报告了一个与Porkbun DNS提供商相关的技术问题:当尝试更新通配符(*)DNS记录时,系统没有正确更新现有记录,而是不断创建新的通配符记录条目。这一问题会导致DNS记录堆积,影响系统性能和DNS解析效率。

问题表现

用户在使用ddns-updater配置Porkbun DNS提供商时,发现日志中显示以下错误信息:

ERROR creating record: HTTP status is not valid: 400: Create error: We were unable to create the DNS record.

同时,在Porkbun的DNS管理界面中,可以观察到多个重复的通配符记录被创建,而非更新现有的单一记录。随着时间推移,这些重复记录会不断累积,最终导致容器加载时间延长和系统资源浪费。

技术分析

经过深入调查,发现问题根源在于API请求构造方式。当ddns-updater尝试获取现有通配符记录时,它向Porkbun API发送的请求URL中包含特殊字符""。在URL规范中,星号()并不是一个有效的URL字符,这导致API无法正确处理请求,返回错误响应。

具体来说,项目原本使用的API请求格式为: https://porkbun.com/api/json/v3/dns/retrieveByNameType/domain.com/A/*

这种包含星号的URL构造方式不符合HTTP规范,导致Porkbun API无法正确识别和返回现有的通配符记录。因此,ddns-updater误判为记录不存在,转而尝试创建新记录而非更新现有记录。

解决方案

项目维护者针对此问题实施了以下修复措施:

  1. 修改了API请求构造逻辑,移除了URL中的特殊字符"*"和"@"。
  2. 确保所有主机名记录(包括通配符和根域)都使用标准化的URL格式进行请求。
  3. 更新了记录检索和更新的逻辑流程,使其更符合Porkbun API的实际工作方式。

修复后的版本(commit 987138dfc165f3b087d494cf4c3ed605bbeba529)已经解决了这一问题。用户只需更新到最新版本即可恢复正常功能。

验证方法

为确保修复效果,用户可以采取以下步骤进行验证:

  1. 手动将现有A记录IP地址修改为127.0.0.1
  2. 观察ddns-updater是否能够正确检测到需要更新
  3. 检查更新后Porkbun DNS记录中是否仅存在单一通配符记录
  4. 确认没有新的重复记录被创建

总结

DNS记录管理是动态DNS更新的核心功能,正确处理通配符记录对于许多应用场景至关重要。ddns-updater项目团队及时响应并修复了Porkbun提供商中的这一技术问题,展现了开源项目对用户体验的重视。用户遇到类似问题时,应及时更新到最新版本,并按照推荐方法进行验证。

对于使用Porkbun作为DNS提供商的ddns-updater用户,建议定期检查DNS记录状态,确保没有意外创建重复记录,以维持系统的最佳性能和稳定性。

登录后查看全文
热门项目推荐
相关项目推荐