二、準備工作：API Token 與域名接入

2.1 將域名接入 Cloudflare

1. 注冊或登錄 Cloudflare 控制臺
2. 添加你已有的域名，例如 example.com
3. 更換域名 DNS 到 Cloudflare 提供的 NS（在域名注冊商后臺操作）

2.2 創(chuàng)建 API Token

1. 打開 Cloudflare 控制臺 → Profile → API Tokens
2. 點擊 “Create Token” → 使用 “Edit zone DNS” 模板

3. 設(shè)置權(quán)限：

   • Zone.Zone: Read
   • Zone.DNS: Edit
4. 限制 Token 的作用域為某個指定域名
5. 生成后復(fù)制保存 CF_API_TOKEN

> 長尾關(guān)鍵詞：Cloudflare API Token 最小權(quán)限、Cloudflare DNS 權(quán)限配置

三、獲取 Zone ID 與 DNS Record ID

在 Cloudflare 的 API 調(diào)用中，管理 DNS 記錄需要兩個重要參數(shù)：

• zone_id：你的域名在 Cloudflare 的唯一標識
• record_id：DNS 記錄的唯一 ID

獲取 Zone ID：

curl -X GET "https://api.cloudflare.com/client/v4/zones?name=example.com" \
  -H "Authorization: Bearer $CF_API_TOKEN" \
  -H "Content-Type: application/json"

獲取 DNS Record ID：

curl -X GET "https://api.cloudflare.com/client/v4/zones/${ZONE_ID}/dns_records?name=sub.example.com" \
  -H "Authorization: Bearer $CF_API_TOKEN" \
  -H "Content-Type: application/json"

> 相關(guān)關(guān)鍵詞：Cloudflare DNS record ID 獲取、zone id 查詢方式

四、Bash 腳本：自動更新 DNS A 記錄

以下 Bash 腳本支持自動檢測公網(wǎng) IP 并更新 DNS A 記錄，適合用于 DDNS 或開發(fā)測試環(huán)境的動態(tài)綁定。

#!/bin/bash

CF_API_TOKEN="your_api_token"
ZONE_ID="your_zone_id"
RECORD_NAME="home.example.com"
RECORD_TYPE="A"

# 獲取當前公網(wǎng) IP
IP=$(curl -s https://api.ipify.org)

# 獲取 record ID
RECORD_ID=$(curl -s -X GET "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/dns_records?type=$RECORD_TYPE&name=$RECORD_NAME" \
  -H "Authorization: Bearer $CF_API_TOKEN" | jq -r '.result[0].id')

# 獲取記錄當前值
OLD_IP=$(curl -s -X GET "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/dns_records/$RECORD_ID" \
  -H "Authorization: Bearer $CF_API_TOKEN" | jq -r '.result.content')

# 判斷是否需要更新
if [ "$IP" != "$OLD_IP" ]; then
  echo "Updating $RECORD_NAME: $OLD_IP → $IP"
  curl -s -X PUT "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/dns_records/$RECORD_ID" \
    -H "Authorization: Bearer $CF_API_TOKEN" \
    -H "Content-Type: application/json" \
    --data "{\"type\":\"$RECORD_TYPE\",\"name\":\"$RECORD_NAME\",\"content\":\"$IP\",\"ttl\":120}"
else
  echo "IP address unchanged."
fi

> 長尾關(guān)鍵詞：Cloudflare DDNS 腳本、動態(tài) A 記錄更新、Shell 自動同步 DNS

五、Python 實現(xiàn)：更適合復(fù)雜業(yè)務(wù)邏輯

如果需要更好的結(jié)構(gòu)與異常處理，可以使用 Python 腳本：

import os, requests

API_TOKEN = os.getenv("CF_API_TOKEN")
ZONE_ID = os.getenv("CF_ZONE_ID")
RECORD_NAME = "dev.example.com"

def get_public_ip():
    return requests.get("https://api.ipify.org").text.strip()

def get_record_id():
    url = f"https://api.cloudflare.com/client/v4/zones/{ZONE_ID}/dns_records?name={RECORD_NAME}"
    headers = {"Authorization": f"Bearer {API_TOKEN}"}
    response = requests.get(url, headers=headers).json()
    return response["result"][0]["id"], response["result"][0]["content"]

def update_record(record_id, new_ip):
    url = f"https://api.cloudflare.com/client/v4/zones/{ZONE_ID}/dns_records/{record_id}"
    data = {
        "type": "A",
        "name": RECORD_NAME,
        "content": new_ip,
        "ttl": 120
    }
    headers = {
        "Authorization": f"Bearer {API_TOKEN}",
        "Content-Type": "application/json"
    }
    response = requests.put(url, headers=headers, json=data)
    return response.json()

if __name__ == "__main__":
    ip = get_public_ip()
    record_id, old_ip = get_record_id()
    if ip != old_ip:
        print(f"IP changed: {old_ip} → {ip}")
        update_record(record_id, ip)
    else:
        print("No IP change.")

> 關(guān)鍵詞擴展：Python 自動化 DNS 管理、Cloudflare Python API 示例、動態(tài) DNS 實現(xiàn)方式

六、CI/CD 集成：用 GitHub Actions 自動同步 DNS 記錄

結(jié)合 GitOps 與 Infrastructure as Code，我們可以在代碼變更時自動修改 DNS 配置：

name: Update Cloudflare DNS
on:
  push:
    branches:
      - main

jobs:
  update_dns:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v3

      - name: Update DNS record
        run: |
          curl -X PUT "https://api.cloudflare.com/client/v4/zones/${{ secrets.CF_ZONE_ID }}/dns_records/${{ secrets.CF_RECORD_ID }}" \
          -H "Authorization: Bearer ${{ secrets.CF_API_TOKEN }}" \
          -H "Content-Type: application/json" \
          --data '{"type":"A","name":"prod.example.com","content":"1.2.3.4","ttl":120}'

> 長尾關(guān)鍵詞：GitHub Actions 自動修改 DNS、Cloudflare CI 自動化、DNS 記錄 GitOps 管理

七、結(jié)合 Terraform 實現(xiàn)全面 DNS 自動化

Terraform 支持 Cloudflare Provider，推薦用于管理多個域名與環(huán)境的 DNS 配置：

provider "cloudflare" {
  api_token = var.cf_api_token
}

resource "cloudflare_record" "dev_a" {
  zone_id = var.zone_id
  name    = "dev"
  value   = var.ip
  type    = "A"
  ttl     = 120
}

執(zhí)行：

terraform init
terraform apply

> 擴展關(guān)鍵詞：Terraform Cloudflare DNS 配置、IaC 自動化 DNS 管理、Cloudflare DevOps 工具集成

八、常見問題與排查建議

九、進階應(yīng)用場景

• ?? 動態(tài)域名更新（DDNS）實現(xiàn)家庭訪問公網(wǎng)服務(wù)
• ?? 自動化測試環(huán)境綁定獨立子域
• ?? Let’s Encrypt 證書簽發(fā)時自動創(chuàng)建 TXT 記錄（DNS-01 驗證）
• ?? 批量創(chuàng)建多個域名的 A / CNAME / MX / TXT 記錄
• ??? 實現(xiàn)按環(huán)境（dev、stage、prod）動態(tài)切換 DNS 指向

十、總結(jié)與推薦實踐

通過本文你已掌握：

• ? 如何使用 Cloudflare DNS API 實現(xiàn)自動化域名管理
• ? 如何獲取 zone_id、record_id 并完成 A 記錄自動更新
• ? 使用 Bash/Python 實現(xiàn) DDNS 與 DNS 更新腳本
• ? 集成 GitHub Actions 與 Terraform 構(gòu)建完整 DevOps 流水線

?? 推薦實踐：

• 使用 API Token 代替全局 API Key，提升安全性
• 所有腳本建議加入異常處理與日志記錄
• 定期檢查 DNS 更新狀態(tài)，防止失效或丟包

原文引自YouTube視頻：

#你可能也喜歡這些API文章!

Twitter API Key 的 OAuth 認證與授權(quán)機制

全面掌握 OpenAPI 規(guī)范：定義、生成與集成指南

API 網(wǎng)關(guān)集成 SkyWalking 打造全方位日志處理

REST API：關(guān)鍵概念、最佳實踐和優(yōu)勢

如何使用 DeepSeek 構(gòu)建 AI Agent：終極指南

18種最佳 RAG 技術(shù)

FastAPI是什么？快速上手指南

API 設(shè)計原理：從理論到實踐

DeepSeek R1 × 飛書多維表格賦能教育領(lǐng)域