更新/刪除/新增/編輯網域API說明

/node_add_domain 新增/編輯網域

參數	類型	必填	說明
username	string	是	使用者帳號（登入驗證用，必須是已註冊帳號）
password	string	是	使用者密碼（登入驗證用，請妥善保管）
node	string	SRV 必填	節點名稱（必須是你自己擁有的節點，SRV 記錄的目標 IP 會自動從該節點取得，不能自訂）
srv_domain	string	SRV 必填	申請的子網域（如：kiwiidgood，系統自動補全完整 SRV 名稱）
srv_port	number	否	指定端口（Minecraft 伺服器的連接埠，預設 25565，可自訂）
srv_priority	number	否	SRV 優先權（數值越小優先度越高，通常填 0）
srv_weight	number	否	SRV 權重（多個 SRV 記錄時分流用，預設 5，數值越大分流機率越高）
nodeName	string	A/CNAME 必填	節點名稱（你要操作的伺服器節點，必須是你自己擁有的節點，例：台北中華電信）
connect_addr	string	A/CNAME 必填	目標 IP 或域名（A 記錄填 IP，CNAME 記錄填域名，指向你要綁定的主機）
custom_domain	string	A/CNAME 必填	申請的子網域（如：kiwiidgood，系統自動補全完整網域）

注意： SRV 記錄的目標（target）會自動使用你指定 node 節點的 IP，不能自訂。SRV 記錄會建立於 _minecraft._tcp.<srv_domain>.taiwanfrp.me。一個節點同時只能有一個網域（A/CNAME 或 SRV），新申請會自動覆蓋舊的。只有節點擁有者可操作該節點的網域。

SRV 範例：

curl -X POST https://taiwanfrp.ddns.net/node_add_domain \
  -H "Content-Type: application/json" \
  -d '{
    "username": "你的帳號",
    "password": "你的密碼",
    "node": "台北中華電信",
    "srv_domain": "你的子網域",
    "srv_port": 25566,
    "srv_priority": 0,
    "srv_weight": 5
  }'

A/CNAME 範例：

curl -X POST https://taiwanfrp.ddns.net/node_add_domain \
  -H "Content-Type: application/json" \
  -d '{
    "username": "你的帳號",
    "password": "你的密碼",
    "nodeName": "TaiwanFRP節點名稱",
    "connect_addr": "目標IP或域名",
    "custom_domain": "你的子網域"
  }'

成功回應：

網域已新增/更新並同步到 Cloudflare

/node_del_domain 刪除網域

參數	類型	必填	說明
node	string	SRV 必填	要刪除 SRV 的節點名稱
custom_domain	string	A/CNAME 必填	要刪除的子網域

SRV 範例：

curl -X POST https://taiwanfrp.ddns.net/node_del_domain \
  -H "Content-Type: application/json" \
  -d '{
    "username": "你的帳號",
    "password": "你的密碼",
    "node": "TaiwanFRP節點名稱",
  }'

A/CNAME 範例：

curl -X POST https://taiwanfrp.ddns.net/node_del_domain \
  -H "Content-Type: application/json" \
  -d '{
    "username": "你的帳號",
    "password": "你的密碼",
    "custom_domain": "你的子網域"
  }'

成功回應：

SRV 網域已刪除並同步到 Cloudflare

只能刪除自己擁有的節點下的網域。只會刪除 SRV 類型的網域（Minecraft 專用），若該節點沒有 SRV 網域會回傳錯誤。

/what_nodes_domain 查詢節點網域

curl -X POST https://taiwanfrp.ddns.net/what_nodes_domain \
  -H "Content-Type: application/json" \
  -d '{"username":"你的帳號","password":"你的密碼","nodeName":"美國洛杉磯Frontier"}'

回應範例：

{"domain":true,"domains":[{"domain_value":"fewfewfewf.taiwanfrp.me","ip":"1.2.3.4"}]}

{"domain":false}

/del_acc_all_srv 刪除帳號所有 SRV 網域

curl -X POST https://taiwanfrp.ddns.net/del_acc_all_srv \
  -H "Content-Type: application/json" \
  -d '{
    "username": "你的帳號",
    "password": "你的密碼"
  }'

回應範例：

{
  "success": true,
  "deleted": 2,
  "errors": [
    "Cloudflare 未找到: _minecraft._tcp.tw1.taiwanfrp.me"
  ]
}

此 API 只會刪除 SRV 類型的 DNS 記錄，不會影響 A 或 CNAME。

/what_all_srv_domain 查詢所有 SRV 網域

curl -X POST https://taiwanfrp.ddns.net/what_all_srv_domain \
  -H "Content-Type: application/json" \
  -d '{
    "username": "你的帳號",
    "password": "你的密碼"
  }'

回應範例：

{
  "domain": true,
  "srv_domains": [
    {
      "nodeName": "TaiwanFRP節點名稱",
      "domain": "_minecraft._tcp.想要的子網域.taiwanfrp.me",
      "name": "想要的子網域",
      "port": SRV指向端口,
      "target": "目標IP或域名"
    }
    // ...更多 SRV 紀錄
  ]
}

此 API 只會列出屬於該用戶的所有 SRV 類型 DNS 紀錄。

DDNS 更新 API（一般網域）

指定更新 IP：

curl "https://taiwanfrp.ddns.net/api/ddns_update?username=你的帳號&password=你的密碼&domain=你的網域&ip=想更新的IP"

直接將「你的網域」的 IP 更新為「想更新的IP」。

自動更新（更新成發送請求的電腦 IP）：

curl "https://taiwanfrp.ddns.net/api/ddns_update?username=你的帳號&password=你的密碼&domain=你的網域"

請將 你的網域、想更新的IP 替換成實際值。