通过PowerDNS HTTP API添加多TXT记录（SPF/DMARC/DKIM）遇阻

我明白你遇到的问题了——当你直接修改content字段尝试添加新的TXT记录时，PowerDNS出现异常，核心原因在于你使用的changetype: "REPLACE"的行为：它会完全替换掉指定name和type下的所有现有记录，而不是追加新记录。如果之前已经有同域名的TXT记录，直接提交单条新记录会覆盖掉旧的，导致DNS记录丢失或异常。

下面是正确的操作方法，分步骤来：

1. 先查询现有TXT记录 #

在添加新记录前，先获取目标域名下所有已存在的TXT记录，避免意外覆盖。用以下命令：

curl -H 'X-API-Key: changeme' http://127.0.0.1:8081/api/v1/servers/localhost/zones/example.org. | jq '.rrsets[] | select(.type == "TXT")'

这个命令会返回所有TXT类型的记录集合，你需要留意不同的name（比如主域名example.org.、DKIM对应的dkim._domainkey.example.org.等）。

2. 构造包含所有记录的PATCH请求 #

根据不同的记录场景，分两种情况处理：

情况1：给主域名添加SPF和DMARC记录 #

SPF和DMARC都是绑定在主域名（example.org.）下的TXT记录，需要把它们和该域名下已有的TXT记录一起放在records数组里，用REPLACE来更新整个集合：

curl -X PATCH --data '{
  "rrsets": [
    {
      "name": "example.org.",
      "type": "TXT",
      "ttl": 86400,
      "changetype": "REPLACE",
      "records": [
        # 保留已有的TXT记录（如果有的话）
        {"content": "\"existing-txt-content\"", "disabled": false},
        # 添加SPF记录
        {"content": "\"v=spf1 include:_spf.example.org ~all\"", "disabled": false},
        # 添加DMARC记录
        {"content": "\"v=DMARC1; p=none; rua=mailto:dmarc@example.org\"", "disabled": false}
      ]
    }
  ]
}' -H 'X-API-Key: changeme' http://127.0.0.1:8081/api/v1/servers/localhost/zones/example.org. | jq .

情况2：添加DKIM记录 #

DKIM记录绑定在子域名（比如dkim._domainkey.example.org.）下，属于新的name+type组合，可以直接用REPLACE（如果该子域名还没有TXT记录，也可以用ADD，但REPLACE更通用）：

curl -X PATCH --data '{
  "rrsets": [
    {
      "name": "dkim._domainkey.example.org.",
      "type": "TXT",
      "ttl": 86400,
      "changetype": "REPLACE",
      "records": [
        {"content": "\"v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA...\"", "disabled": false}
      ]
    }
  ]
}' -H 'X-API-Key: changeme' http://127.0.0.1:8081/api/v1/servers/localhost/zones/example.org. | jq .

关键注意事项 #

• TXT内容的引号转义：DNS的TXT记录内容本身需要用双引号包裹，在JSON请求里要转义成\"，否则PowerDNS会解析失败。
• 同域名多TXT记录必须全量提交：只要name和type相同，所有相关记录都要放在records数组里，否则REPLACE会丢失未提交的记录。
• 不同子域名分开处理：像DKIM这种子域名下的记录，要单独创建一个rrsets对象，不要和主域名的TXT记录混在一起。

内容的提问来源于stack exchange，提问作者Rockietto