클로드스킬마트스킬 둘러보기스킬이 뭐예요?
 
← 목록으로

Cloudflare 문제 해결

Cloudflare API로 실제 설정을 조회해 리다이렉트 루프·SSL·DNS 장애의 원인을 근거 기반으로 찾아내는 스킬입니다.

웹·API 연동중급★ 1,323⑂ 212AI 점수 8/10마지막 업데이트: 2026. 8. 8.

무엇을 해주나

  • Cloudflare API를 호출해 추측이 아닌 실제 설정값을 확인하고 원인을 찾아냅니다.
  • 도메인 이름으로 zone ID를 얻고, SSL/TLS 모드·Always Use HTTPS·Page Rules·DNS 레코드·방화벽 규칙·인증서 팩 등을 순서대로 점검합니다.
  • 대표적인 장애 유형별 조사 절차를 제공합니다: ERR_TOO_MANY_REDIRECTS, SSL 오류(525/526), DNS 미해석, 오리진 오류(502/503/504).
  • 원인을 특정하면 PATCH 요청으로 설정을 수정하고, 캐시 퍼지 및 전파 대기 시간까지 안내합니다.
  • 문서에 없는 사례는 Cloudflare API 레퍼런스를 탐색하는 방법(GET으로 먼저 구조 파악 → 변경)까지 알려줍니다.

이런 분께 추천

  • 개인 블로그·회사 사이트를 Cloudflare에 올려두고 갑자기 접속이 안 될 때 스스로 원인을 찾고 싶은 분
  • GitHub Pages / Netlify / Vercel + Cloudflare 조합에서 무한 리다이렉트를 겪은 분
  • 대시보드 클릭 대신 API로 재현 가능하게 설정을 점검하고 싶은 개발자·인프라 담당자
  • 여러 도메인을 관리하며 반복적인 SSL/DNS 트러블슈팅을 표준화하고 싶은 분

활용 예시

  1. 무한 리다이렉트: "example.com이 ERR_TOO_MANY_REDIRECTS를 냅니다" → SSL 모드가 flexible인지 확인 → 오리진이 HTTPS를 강제하는 상황이면 full로 변경 → 캐시 퍼지 → 60초 후 재확인.
  2. SSL 오류 526: 인증서 팩 상태와 오리진 인증서를 openssl s_client로 검증하고, Full(strict) 모드와 오리진 인증서 불일치를 짚어냄.
  3. DNS가 안 풀림: Cloudflare DNS 레코드 목록과 dig @8.8.8.8 결과를 비교해 누락된 A 레코드나 잘못된 프록시(주황 구름) 상태를 찾아냄.

· · · 설치 가이드 · · ·

Claude 앱에 설치 (터미널 필요 없음)
  1. 아래 버튼으로 ZIP 파일을 받으세요.
  2. Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
  3. Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
↓ ZIP 내려받기
Claude Code에 설치

Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 daymade/claude-code-skills 의 cloudflare-troubleshooting 폴더를 내 ~/.claude/skills/cloudflare-troubleshooting/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.

직접 명령으로 설치하기

git clone https://github.com/daymade/claude-code-skills.git && mkdir -p ~/.claude/skills && cp -r claude-code-skills/cloudflare-troubleshooting ~/.claude/skills/

⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

  1. 터미널을 엽니다.
  2. 저장소를 내려받습니다: git clone https://github.com/daymade/claude-code-skills.git
  3. 스킬 폴더를 만듭니다: mkdir -p ~/.claude/skills
  4. 이 스킬만 복사합니다: cp -r claude-code-skills/cloudflare-troubleshooting ~/.claude/skills/
  5. jq가 없으면 설치합니다(macOS: brew install jq, Ubuntu: sudo apt install jq).
  6. Cloudflare 대시보드에서 My Profile → API Tokens로 이동해, Global API Key 대신 해당 zone에만 권한을 준 API Token을 발급하는 것을 권장합니다.
  7. Claude Code를 재시작한 뒤 "Cloudflare에서 리다이렉트 루프가 생겼어, 설정 확인해줘"처럼 요청하면 스킬이 실행됩니다.
  8. 설정을 변경(PATCH)하거나 캐시를 퍼지하는 명령은 실행 전에 내용을 꼭 직접 확인하세요.
GitHub에서 원본 보기 ↗라이선스: MIT