Cloudflare Pages 미들웨어로 서브도메인 라우팅하기

(dev.to)

Dev.to DevOps2026년 10월 2일개발자 도구

Cloudflare Pages의 에지 미들웨어를 활용해 단일 코드베이스 내에서 서브도메인 라우팅을 구현함으로써, 관리 비용을 최소화하면서도 SEO 최적화와 효율적인 멀티 앱 운영을 동시에 달성하는 기술적 방법을 제시합니다.

이 글의 핵심 포인트

1Cloudflare Pages 미들웨어를 이용해 단일 프로젝트 내에서 서브도메인별 라우팅 구현 가능
2Host 헤더를 검사하여 특정 서브도메인(예: timer.example.com) 요청을 식별
3정적 자산(assets, favicon 등)과 로봇 파일은 미들웨어를 통과시켜 서비스 중단 방지
4서브도메인의 루트(/) 요청을 내부의 특정 디렉토리(/timer/)로 내부 재작성(Rewrite)
5연관 없는 경로는 메인 도메인으로 301 영구 리다이렉트를 수행하여 SEO 중복 콘텐츠 페널티 방지

이 글에 대한 공공지능 분석

왜 중요한가?

개발 리소스가 부족한 초기 스타트업이 단일 레포지토리(Monorepo)로 여러 서비스를 운영하면서도, 각 서비스에 독립적인 도메인을 부여해 브랜드 전문성을 높일 수 있는 비용 효율적인 아키텍처를 제안하기 때문입니다.

어떤 배경과 맥락이 있나?

최근 프론트엔드 생태계는 복잡한 마이크로 프론트엔드 구조 대신, 관리 효율성을 위해 단일 프로젝트 내에서 여러 기능을 분리해 운영하려는 수요가 늘고 있으며, Cloudflare Workers와 같은 에지 컴퓨팅 기술이 이를 뒷받침하고 있습니다.

업계에 어떤 영향을 주나?

인프라 관리 비용(CI/CD 파이프라인, 빌드 시간, 도메인 관리)을 획기적으로 줄이면서도 사용자에게는 깔끔한 브랜드 경험을 제공할 수 있어, 1인 개발자나 소규모 엔지니어링 팀의 운영 효율성을 극대화할 수 있습니다.

한국 시장에 어떤 시사점이 있나?

빠른 제품 출시(Time-to-Market)가 생존과 직결되는 한국 스타트업 환경에서, 최소한의 인프라 운영 공수로 다수의 마이크로 서비스나 도구(Tools)를 확장해 나가는 'Lean'한 개발 전략의 실질적인 구현 방안을 제시합니다.

이 글에 대한 큐레이터 의견

이 방식은 인프라 운영 비용과 개발 복잡도 사이의 트레이드오프를 매우 영리하게 해결한 사례입니다. 별도의 레포지토리를 관리하지 않음으로써 코드 재사용성을 높이고 배포 파이프라인을 단순화할 수 있다는 점은, 제품의 빠른 실험이 필요한 스타트업에게 엄청난 기회입니다. 특히 에지 미들웨어를 통한 라우팅은 사용자에게 지연 시간(Latency)을 거의 느끼지 못하게 하면서도 SEO 권위(Authority)를 단일 도메인으로 집중시키려는 전략적 의도를 담고 있습니다.

다만, 주의해야 할 리스크도 분명합니다. 모든 서브도메인 로직이 하나의 미들웨어 스크립트에 집중되므로, 라우팅 규칙이 복잡해질수록 미들웨어의 유지보수 난이도가 상승하고 실수로 인해 전체 서비스의 정적 자산(CSS/JS)이 깨질 위험이 있습니다. 따라서 서비스 규모가 커져 각 서브도메인의 비즈니스 로직이 독립적인 생명주기를 가져야 하는 시점에는, 미들웨어 기반의 통합 구조를 탈피하여 물리적인 프로젝트 분리를 검토하는 균형 잡힌 접근이 필요합니다.

원문 보기 →