Cloudflare Workers 기초, 서버 없이 코드 실행하기

서버 코드를 하나 배포하려면 보통 서버를 빌리고, 배포 파이프라인을 만들고, 관리해야 할 게 많습니다. 간단한 리다이렉트나 API 응답 하나 처리하는 데도 이 모든 과정이 필요하다면 배보다 배꼽이 큽니다. Cloudflare Workers는 이런 작은 로직을 서버 없이 실행할 수 있게 해줍니다.

안녕하세요, 코딩하는 안다형입니다. 이 글에서는 Workers가 뭐고, 어떤 상황에 쓰면 좋은지 기본 개념을 정리했습니다.

3줄 요약

1. Workers는 Cloudflare 엣지에서 직접 실행되는 서버리스 코드입니다.
2. 무료 플랜에서도 하루 요청 한도 내에서 사용할 수 있습니다.
3. 간단한 리다이렉트, API 응답 가공, A/B 테스트 같은 가벼운 로직에 적합합니다.

서버리스가 뭔가

서버를 직접 켜 두고 관리하는 대신, 요청이 올 때만 코드가 실행되고 끝나면 사라지는 방식입니다. 서버 운영 부담이 없고, 트래픽에 따라 자동으로 확장됩니다. Workers는 이 코드가 Cloudflare의 전 세계 엣지 네트워크에서 실행되기 때문에 방문자와 가까운 곳에서 바로 처리된다는 장점도 있습니다.

어떤 걸 만들 수 있나

• 조건부 리다이렉트: 국가나 기기에 따라 다른 페이지로 보내기
• API 응답 가공: 원본 서버 응답을 받아 필요한 형태로 변형해서 전달
• 간단한 API 서버: 별도 백엔드 없이 Workers만으로 작은 API 만들기
• A/B 테스트: 방문자를 무작위로 나눠 다른 버전을 보여주기

시작하는 순서

대시보드 Workers & Pages에서 새 Worker를 만들면 기본 템플릿 코드가 제공됩니다. JavaScript로 요청을 받아 응답을 만드는 간단한 함수 형태입니다. 코드를 수정하고 배포하면 바로 내워커이름.내계정.workers.dev 같은 주소로 접속해 테스트할 수 있습니다. 이후 내 도메인의 특정 경로에 연결(라우트 설정)하면 실제 서비스에 붙일 수 있습니다.

Workers와 일반 서버 방식 비교표

일반 서버는 항상 켜져 있어야 하고 트래픽이 없어도 비용이 발생할 수 있는 반면, Workers는 요청이 있을 때만 실행되고 무료 한도 안에서는 비용이 들지 않습니다. 다만 실행 시간이나 메모리에 제한이 있어 무거운 연산에는 적합하지 않습니다.

이건 하지 마세요

• 무거운 연산을 Workers에서 처리: 실행 시간 제한이 있어 오래 걸리는 작업에는 부적합합니다.
• 민감한 키를 코드에 하드코딩: 환경 변수(Secrets) 기능을 이용해 따로 관리하세요.
• 테스트 없이 실서비스 라우트에 바로 연결: workers.dev 주소로 먼저 충분히 테스트한 뒤 연결하세요.

자주 묻는 질문

무료 한도는 어느 정도인가요?

하루 요청 수 기준으로 무료 한도가 제공되며, 구체적인 수치는 정책에 따라 바뀔 수 있으니 대시보드에서 현재 한도를 확인하는 것이 정확합니다.

어떤 언어로 코드를 짜나요?

주로 JavaScript/TypeScript를 사용하며, 다른 언어를 WebAssembly로 컴파일해 쓰는 방법도 있습니다.

기존 서버를 완전히 대체할 수 있나요?

가벼운 로직은 대체할 수 있지만, 복잡한 데이터베이스 처리나 무거운 연산이 필요한 서비스는 기존 서버와 함께 쓰는 것이 현실적입니다.

마무리

서버를 새로 띄우기엔 아까운 작은 로직이 있다면 Workers로 가볍게 시작해 볼 수 있습니다. 리다이렉트나 API 응답 가공처럼 간단한 작업부터 연습해 보세요.

함께 보면 좋은 글

• 클라우드플레어 프록시 켜고 끄기
• 실전 복붙용 차단 룰 10개
• 클라우드플레어 보안 설정 기본편