DDNS-Updater项目中使用Porkbun DNS服务时的配置问题解析

问题现象

在使用DDNS-Updater项目配置Porkbun DNS服务时，用户遇到了无法更新DNS记录的HTTP 400错误。具体表现为：

• 首次创建DNS记录时能够成功
• 后续更新操作失败并返回错误信息："Edit error: We were unable to edit the DNS record."
• 使用通配符(*)作为主机名时工作正常，但指定多个特定子域名时出现故障

根本原因分析

经过技术排查，发现问题的根源在于配置文件中host字段的格式问题。当用户使用如下格式配置多个子域名时：

"host": "[subdomain1], [subdomain2], ... [subdomain7]"

其中的空格字符被URL编码为%20，导致Porkbun API无法正确识别请求参数。具体表现为：

1. 程序尝试查询%20request这样的无效主机名
2. 查询无结果后尝试创建新记录
3. 由于记录实际已存在，创建操作失败并返回400错误

解决方案

配置格式修正

正确的配置方式应该是去除host字段值中的所有空格：

"host": "[subdomain1],[subdomain2],...,[subdomain7]"

项目改进

项目开发者已在最新版本中添加了自动去除空格的功能，防止类似问题再次发生。这一改进体现在commit ae4ab3942144c8480da92990e6e750dc366a4910中。

最佳实践建议

1. 配置格式检查：确保host字段值中不包含任何空格字符
2. API密钥安全：调试时注意日志中可能泄露的敏感信息，如发现泄露应立即更换密钥
3. 记录管理：如遇到更新问题，可尝试先删除Porkbun控制台中的原有记录再重新创建
4. 版本更新：建议使用最新版本的DDNS-Updater以获取自动去除空格等改进功能

技术背景

Porkbun的DNS API对请求参数格式要求严格。当host字段包含空格时，URL编码会将其转换为%20，这可能导致API端点无法正确匹配现有记录。通配符(*)之所以能正常工作，是因为它不涉及复杂的URL编码问题，且Porkbun对其有特殊处理逻辑。

对于使用Docker部署的用户，特别是在Unraid环境下，更应注意配置文件的格式问题，因为这类环境中的文本编辑可能无意间引入特殊字符。