domain

Domain (docker_compose_domains) 操作速查

reconcile 更新分支 B 用。心智模型见 ../references/urls-vs-docker-compose-domains.md 和 ../references/service-fqdn-trap.md。

Application + dockercompose build_pack 形态下, 改域名走 docker_compose_domains 字段 (旧 Service 形态走的 urls 字段 0.8 不再使用)。

tranfu 域名规范

• 形式：https://<sub-app-name>.tranfu.com:<container-port>
• <sub-app-name> = compose services.<name>（命名约束：烤肉串 + 全小写）
• :<container-port> = 容器内部端口（Coolify 翻译成 traefik label，公网仍走 443）
• 不带 path（不写 /api、/v2 之类——多个 path 走多个 sub-application）

Check：当前域名 vs 期望（reconcile 更新分支 B）

EXPECTED_NAME="<sub-app-name>"
EXPECTED_DOMAIN="https://${EXPECTED_NAME}.tranfu.com:<port>"

curl -sS -H "Authorization: Bearer $COOLIFY_API_TOKEN" \
  "$BASE/api/v1/applications/$APP_UUID" \
  | jq --arg name "$EXPECTED_NAME" --arg url "$EXPECTED_DOMAIN" '
    .applications[] | select(.name == $name) |
    if .fqdn == $url then "✓ 已是期望域名"
    elif (.fqdn // "") | contains("sslip.io") then "✗ 还是 sslip.io fallback"
    else "✗ 不一致: 当前=" + (.fqdn // "null") + " 期望=" + $url
    end'

输出 ✓ → check 通过，跳过 act。✗ → 进 act。

Act：写域名（单 sub-application）

JSON_BODY=$(jq -nc \
  --arg name "$EXPECTED_NAME" \
  --arg domain "$EXPECTED_DOMAIN" \
  '{docker_compose_domains: [{name: $name, domain: $domain}]}')

curl -sS -X PATCH \
  -w "\nHTTP=%{http_code}\n" \
  -H "Authorization: Bearer $COOLIFY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d "$JSON_BODY" \
  "$BASE/api/v1/applications/$APP_UUID"

返回 200 + {uuid}。立刻 GET 一次校验 sub-application.fqdn 真变了：

curl -sS -H "Authorization: Bearer $COOLIFY_API_TOKEN" "$BASE/api/v1/applications/$APP_UUID" \
  | jq '.applications[] | {name, fqdn}'

Act：多 sub-application 一次写

JSON_BODY=$(jq -nc '{
  docker_compose_domains: [
    {name: "web",   domain: "https://app.tranfu.com:3000"},
    {name: "api",   domain: "https://api.tranfu.com:4000"},
    {name: "admin", domain: "https://admin.tranfu.com:5000"}
  ]
}')

curl -sS -X PATCH \
  -H "Authorization: Bearer $COOLIFY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d "$JSON_BODY" \
  "$BASE/api/v1/applications/$APP_UUID"