거래 추적기 터널 배포 가이드

✓ 한 일 5줄 요약

1 터널 배포 절차 (재현용)

app 컨테이너가 이미 내부망에 떠 있다는 전제. 호스트 포트는 절대 열지 않는다.

1. 터널 생성 (원격관리형)

   # grinda 계정 ID 와 인증은 STEP 4(인증정보) 참고
   curl -X POST "https://api.cloudflare.com/client/v4/accounts/$ACCT/cfd_tunnel" \
     -H "X-Auth-Email: $EMAIL" -H "X-Auth-Key: $KEY" \
     -H "Content-Type: application/json" \
     --data '{"name":"deal-tracker","config_src":"cloudflare"}'
   # → 응답의 result.id 가 TUNNEL_ID

2. 연결 토큰 발급

   curl "https://api.cloudflare.com/client/v4/accounts/$ACCT/cfd_tunnel/$TID/token" \
     -H "X-Auth-Email: $EMAIL" -H "X-Auth-Key: $KEY"
   # → result(문자열)가 cloudflared 가 쓸 TUNNEL_TOKEN

3. ingress 설정 — 어떤 호스트를 어느 내부 서비스로

   curl -X PUT ".../cfd_tunnel/$TID/configurations" \
     -H "X-Auth-Email: $EMAIL" -H "X-Auth-Key: $KEY" \
     --data '{"config":{"ingress":[
       {"hostname":"deals.rinda.ai","service":"http://deal-tracker-app:3001"},
       {"service":"http_status:404"}
     ]}}'

   왜 컨테이너명? cloudflared 가 같은 도커 네트워크(deal-tracker-net) 안에 있어 deal-tracker-app 이라는 컨테이너명으로 DNS 해석된다. 그래서 호스트 포트가 필요 없다.
4. DNS CNAME 생성 (proxied)

   curl -X POST ".../zones/$ZONE/dns_records" \
     -H "X-Auth-Email: $EMAIL" -H "X-Auth-Key: $KEY" \
     --data '{"type":"CNAME","name":"deals",
       "content":"<TUNNEL_ID>.cfargotunnel.com","proxied":true}'

5. 토큰 주입 + 기동

   # 알파 서버 ~/deal-tracker/.env
   TUNNEL_TOKEN=<발급받은 토큰>
   
   # 컨테이너 기동 (app 은 그대로, cloudflared 만 새로)
   cd ~/deal-tracker && docker compose up -d cloudflared

6. 검증 — 브라우저로

   # 터널 상태: healthy / conns=4 확인
   docker logs deal-tracker-cloudflared | grep "Registered tunnel"
   
   # curl 은 403 나도 정상(Bot Fight). 실제 브라우저로 접속 확인.

2 Cloudflare 스킬 사용법

Claude Code 의 /cloudflare 스킬 — DNS·Workers·Pages·R2·터널 등 자연어로 관리.

Pages 배포 (wrangler) — 이 문서 배포에 쓴 방법

# personal 자격증명 로드
CREDS=$(cat ~/.claude/credentials/cloudflare.json)
export CLOUDFLARE_EMAIL=$(echo "$CREDS" | python3 -c "import sys,json;print(json.load(sys.stdin)['personal']['email'])")
export CLOUDFLARE_API_KEY=$(echo "$CREDS" | python3 -c "import sys,json;print(json.load(sys.stdin)['personal']['global_api_key'])")
export CLOUDFLARE_ACCOUNT_ID=$(echo "$CREDS" | python3 -c "import sys,json;print(json.load(sys.stdin)['personal']['account_id'])")

wrangler pages project create <name> --production-branch=main
wrangler pages deploy <dir> --project-name=<name> --branch=main --commit-dirty=true
# → https://<name>.pages.dev/

3 인증정보 발급 방법

스킬·스크립트가 읽는 자격증명 파일과, Cloudflare 쪽에서 키를 어떻게 얻는지.

① 자격증명 파일 구조

경로: ~/.claude/credentials/cloudflare.json — 계정별 블록으로 분리.

{
  "personal": {
    "email": "wks0968@gmail.com",
    "global_api_key": "<Global API Key>",
    "account_id": "<Account ID>"
  },
  "grinda": {
    "email": "admin@grinda.ai",
    "global_api_key": "<Global API Key>"
  }
}

② Global API Key 발급 (대시보드)

③ Account ID 확인

대시보드에서 도메인 선택 → 우측 사이드바 API 섹션에 Account ID·Zone ID 표시. 또는 API 로:

curl "https://api.cloudflare.com/client/v4/zones/$ZONE" \
  -H "X-Auth-Email: $EMAIL" -H "X-Auth-Key: $KEY" \
  | python3 -c "import sys,json;print(json.load(sys.stdin)['result']['account']['id'])"

④ (권장) Scoped API Token

4 빠른 참조