Cloudflare Workers에서 Hello World 응답 만들기

Cloudflare Workers에서 간단한 HTTP 응답을 만들려면 fetch 핸들러에서 Response를 반환하면 됩니다. 프로젝트 생성부터 로컬 실행과 배포까지 CLI로 확인해 보겠습니다.

준비물은 Cloudflare 계정과 Node.js, npm입니다. Node.js 지원 버전과 설치 방법은 Wrangler 설치 문서에서 확인하세요.

프로젝트 만들기

터미널에서 다음 명령을 실행합니다.

npm create cloudflare@latest -- my-first-worker

프로젝트 생성 과정에서 Hello World example을 선택합니다. 언어는 JavaScript를 선택하고, 바로 배포할지 묻는 단계에서는 우선 No를 선택합니다. 선택 항목은 도구 업데이트에 따라 달라질 수 있습니다.

생성이 끝나면 프로젝트 폴더로 이동합니다.

cd my-first-worker

응답 코드 확인하기

생성된 src/index.js의 fetch 핸들러는 다음처럼 간단한 응답을 반환할 수 있습니다.

export default {
async fetch(request, env, ctx) {
return new Response("Hello World!", {
headers: {
"Content-Type": "text/plain; charset=utf-8",
},
});
},
};

Worker에 HTTP 요청이 들어오면 fetch 핸들러가 실행됩니다. 여기서는 요청 경로에 관계없이 Hello World!라는 텍스트를 응답합니다. 요청 객체와 환경 변수 등을 받는 방법은 Cloudflare Fetch Handler 문서에서 확인할 수 있습니다.

로컬에서 실행하기

프로젝트 폴더에서 Wrangler 개발 서버를 실행합니다.

npx wrangler dev

터미널에 표시되는 로컬 주소를 브라우저에서 열면 Hello World! 응답을 확인할 수 있습니다. 개발 서버는 터미널에서 Ctrl+C로 종료합니다.

Cloudflare에 배포하기

로컬 확인을 마쳤다면 다음 명령으로 배포합니다.

npx wrangler deploy

처음 사용하는 경우 Cloudflare 계정 인증과 필요한 설정을 안내받을 수 있습니다. 배포가 끝나면 출력된 workers.dev 주소를 브라우저에서 열어 같은 응답이 나오는지 확인합니다.

이 예제는 새 프로젝트를 만드는 방법입니다. 이미 운영 중인 Worker에 예제 코드를 덮어쓰면 기존 기능이 바뀌므로, 연습할 때는 별도 Worker를 사용하세요.

로컬 실행과 배포 과정의 최신 안내는 Cloudflare Workers 시작 가이드를 참고하세요.