Cloudflare 트래픽을 Worker로 라우팅하는 세 가지 방법

2번 방법으로 해결

 

Cloudflare Workers에는 트래픽을 Worker로 라우팅하는 세 가지 방법이 있습니다:

1. Custom Domains (커스텀 도메인)

도메인이나 서브도메인을 Worker에 직접 연결합니다. DNS 레코드나 인증서 관리가 필요 없으며, Cloudflare가 자동으로 DNS 레코드를 생성하고 SSL 인증서를 발급합니다. Worker가 오리진(origin) 역할을 하므로 별도의 애플리케이션 서버가 필요 없는 경우에 적합합니다.

설정 방법:

• 대시보드: Worker 서비스 → Domains & Routes 탭에서 Custom Domain 추가
• Wrangler 설정:

{
  "routes": [
    { "pattern": "shop.example.com", "custom_domain": true }
  ]
}

 

2. Routes (라우트)

URL 패턴을 Worker에 매핑합니다. 기존 프로xied 호스트네임 앞에 Worker를 배치하여 프록시 역할을 하며, fetch()로 원래 애플리케이션 서버에 요청을 전달할 수 있습니다.

설정 방법:

• 대시보드: Worker 서비스 → Domains & Routes 탭
• Wrangler 설정:

{
  "routes": [
    { "pattern": "example.com/api/*", "zone_name": "example.com" }
  ]
}

 

3. workers.dev

기본 제공되는 <worker-name>.<subdomain>.workers.dev URL입니다. route나 routes가 없으면 자동 활성화되며, 별도 설정 없이 Worker를 테스트할 수 있습니다.

{ "workers_dev": true }

 

Routes vs Custom Domains 핵심 차이점

Custom DomainsRoutes

Worker 역할	오리진 (origin)	프록시 (proxy)
경로 매칭	도메인 전체 (/*)	URL 패턴 지정 가능
fetch() 대상	같은 zone 내에서 가능	같은 zone 내 fetch() 불가
DNS/인증서	자동 관리	기존 DNS 레코드 사용
적합한 용도	Worker가 최종 응답	Worker가 앞단에서 전처리

우선순위: 같은 호스트네임에 Routes와 Custom Domains가 모두 설정된 경우, Routes가 먼저 실행되며 fetch(request)로 Custom Domain Worker를 호출할 수 있습니다.

관련 문서

• Custom Domains
• Routes
• workers.dev
• Wrangler 설정 - Types of routes

특정 Worker의 Domains & Routes를 설정하거나 확인하고 싶으시면, Worker 이름을 알려주세요. 대시보드 페이지로 바로 안내해 드릴 수 있습니다.