Workers on plzhans blog

Cloudflare Workers 정적 사이트 가이드 - 배포부터 SEO까지

Fri, 11 Sep 2026 13:01:00 +0000

React 나 Vue 로 만든 SPA, Hugo 로 뽑은 정적 사이트를 그냥 CDN 에 올려 두고 쓰는 경우가 많다. 배포가 단순하고 서버가 없으니 운영할 것도 없다.

그런데 조금 지나면 “응답을 손대고 싶은데 서버가 없네” 하는 순간이 온다. 페이지마다 다른 메타 태그를 넣고 싶거나, 크롤러에게 본문을 보여주고 싶거나, 응답 헤더를 하나 붙이고 싶을 때다.

Cloudflare 를 쓰고 있다면 서버를 새로 세우지 않고 그 일을 할 수 있다. 정적 자산 앞에 코드를 한 겹 얹는 것이다. 이 시리즈는 그 과정을 네 편으로 나눠 정리한 것이다.

Fri, 11 Sep 2026 13:01:00 +0000

이 글은 Cloudflare Workers 정적 사이트 가이드 - 배포부터 SEO까지 시리즈의 일부다.

정적 사이트를 Cloudflare 에 올리는 방법으로 Workers Static Assets 가 있다. 빌드 산출물(dist/)을 올리면 전 세계 엣지에서 서빙되고 필요하면 그 앞에 코드를 한 겹 얹을 수 있다.

정적 호스팅으로 쓰다가 “응답을 조금 고치고 싶다"는 요구가 생겼을 때 서버를 새로 세우지 않고 해결할 수 있는 길이다.

Fri, 11 Sep 2026 13:01:00 +0000

이 글은 Cloudflare Workers 정적 사이트 가이드 - 배포부터 SEO까지 시리즈의 일부다.

워커가 외부 API 를 부르기 시작하면 곧 캐시가 필요해진다. 안 걸면 원본 부하가 페이지뷰만큼 늘어난다.

거는 것 자체는 한 줄이면 되는데, 그 뒤에 모르면 반드시 밟는 함정이 몇 개 있다. 특히 엣지 캐시가 전 세계에 공유되지 않는다는 점은 알고 나면 당연하지만 모르면 “왜 캐시가 안 맞지” 로 한참 헤맨다.

Fri, 11 Sep 2026 13:01:00 +0000

이 글은 Cloudflare Workers 정적 사이트 가이드 - 배포부터 SEO까지 시리즈의 일부다.

React 로 만든 SPA 를 정적 호스팅에 올려 두고 쓰는 경우가 많다. 배포가 단순하고 서버가 없으니 운영할 것도 없다. 비용도 거의 안 든다.

그런데 검색을 신경 쓰기 시작하면 곧 벽을 만난다. 서버가 내보내는 원본 HTML 에 검색엔진이 읽을 것이 하나도 없기 때문이다.

이 글은 그 문제를 백엔드 서버를 새로 세우지 않고 Cloudflare Workers 만으로 풀어 간 기록이다. 세 단계로 나눠 다룬다. 뒤로 갈수록 얻는 것이 크고 손이 많이 간다.

Fri, 11 Sep 2026 13:01:00 +0000

이 글은 Cloudflare Workers 정적 사이트 가이드 - 배포부터 SEO까지 시리즈의 일부다.

Cloudflare Workers 를 다루는 일은 사실상 wrangler 를 다루는 일이다. 로컬에서 띄우는 것도, 배포하는 것도 같은 CLI 다.

그런데 이름 때문에 오해가 하나 생긴다. wrangler dev 는 프론트 개발 서버가 아니다. 필자도 처음에 여기서 한참 헤맸다.