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

2.1 將域名接入 Cloudflare

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

2.2 創建 API Token

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

3. 設置權限：

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

長尾關鍵詞：Cloudflare API Token 最小權限、Cloudflare DNS 權限配置

三、獲取 Zone ID 與 DNS Record ID

在 Cloudflare 的 API 調用中，管理 DNS 記錄需要兩個重要參數：

• 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"

相關關鍵詞：Cloudflare DNS record ID 獲取、zone id 查詢方式

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

以下 Bash 腳本支持自動檢測公網 IP 并更新 DNS A 記錄，適合用于 DDNS 或開發測試環境的動態綁定。

#!/bin/bash

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

# 獲取當前公網 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

長尾關鍵詞：Cloudflare DDNS 腳本、動態 A 記錄更新、Shell 自動同步 DNS

五、Python 實現：更適合復雜業務邏輯

如果需要更好的結構與異常處理，可以使用 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.")

關鍵詞擴展：Python 自動化 DNS 管理、Cloudflare Python API 示例、動態 DNS 實現方式

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

結合 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}'

長尾關鍵詞：GitHub Actions 自動修改 DNS、Cloudflare CI 自動化、DNS 記錄 GitOps 管理

七、結合 Terraform 實現全面 DNS 自動化

Terraform 支持 Cloudflare Provider，推薦用于管理多個域名與環境的 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
}

執行：

terraform init
terraform apply

擴展關鍵詞：Terraform Cloudflare DNS 配置、IaC 自動化 DNS 管理、Cloudflare DevOps 工具集成

八、常見問題與排查建議

九、進階應用場景

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

十、總結與推薦實踐

通過本文你已掌握：

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

?? 推薦實踐：

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

原文引自YouTube視頻：

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

18種最佳 RAG 技術

一步步教你進行 Python REST API 身份驗證

REST API 基礎：定義、示例及使用方法