내 Cloudflare 계정에서 앱 실행하기

Q: 토큰에 어떤 권한이 필요한가요?

Cloudflare의 Edit Cloudflare Workers 템플릿으로 시작하고 D1: Edit를 추가하세요. 추가 서비스마다 권한을 더하세요. 예를 들어 R2에는 Workers R2 Storage: Edit가 필요합니다.

Q: 내 도메인을 쓸 수 있나요?

네, 그 도메인이 내 Cloudflare 계정에 있다면 가능합니다. Cloudflare 카드에서 내 도메인 사용을 클릭하고 도메인을 고른 뒤 주소를 입력하고 다시 게시하세요.

Q: MonstarX가 내 Cloudflare 계정에서 무언가를 삭제하나요?

게시를 취소하거나 앱을 계정에서 옮길 때 앱의 Worker만 삭제합니다. 사용 중지를 눌러도 데이터베이스와 서비스는 절대 삭제되지 않습니다.

Q: MonstarX 호스팅으로 돌아갈 수 있나요?

네. 내 Cloudflare에서 이 앱 실행을 끄고 다시 게시하세요. 앱이 MonstarX로 옮겨지면 내 계정의 Worker는 삭제됩니다.

핵심 요약백엔드 → 클라우드에서 Cloudflare API 토큰을 연결하면, 앱이 MonstarX가 아닌 내 Cloudflare 계정에서 실행됩니다. Worker, D1 데이터베이스, 도메인, 요금 모두 내 계정 소유입니다. 앱 코드에서 KV, R2, Queues, Vectorize, Workers AI 같은 Cloudflare 서비스도 쓸 수 있으며, 이 서비스는 MonstarX가 내 계정에 만들어 줍니다.

MonstarX는 모든 앱을 자체 클라우드에 게시하므로 따로 관리할 것이 없습니다. 하지만 이미 회사에서 Cloudflare를 쓰고 있거나, 앱과 데이터와 요금을 내 이름으로 두고 싶다면 Cloudflare 계정을 연결하세요. 두 가지가 달라집니다.

호스팅. 게시하면 앱이 내 Cloudflare 계정으로 갑니다. 앱을 제공하는 프로그램인 Worker, Cloudflare의 SQL 데이터베이스인 D1, 도메인, 요금이 모두 내 계정에 속합니다.
Cloudflare 서비스. 앱 코드에서 저장소, 큐, AI 같은 Cloudflare의 다른 서비스도 쓸 수 있습니다. 필요한 서비스는 MonstarX가 내 계정에 알아서 설정합니다.

시작하기 전에

Cloudflare API 토큰이 필요합니다. Cloudflare에서 Manage Account → API Tokens로 이동해 Edit Cloudflare Workers 템플릿으로 토큰을 만들고 D1: Edit를 추가하세요. 앱에서 쓸 추가 서비스가 있다면 서비스마다 권한을 더하세요.

서비스	용도	추가할 권한
KV	설정, 캐시, 기능 플래그, 짧게 쓰는 토큰을 위한 빠른 키-값 저장소	Workers KV Storage: Edit
R2	다운로드 요금이 없는 파일 저장소. 업로드, 이미지, 내보내기, 백업	Workers R2 Storage: Edit
Queues	백그라운드 작업. 요청 중에 작업을 넘겨 두고 나중에 재시도와 함께 처리	Queues: Edit
Vectorize	의미로 검색하기 위한 벡터 인덱스	Vectorize: Edit
Workers AI	텍스트, 임베딩, 이미지용 오픈 모델. 요금은 내 계정에 청구	Workers AI: Edit
Browser Rendering	스크린샷, PDF, 페이지의 읽을 수 있는 텍스트를 얻는 실제 브라우저	Browser Rendering: Edit
Images	이미지 저장과 크기 조정. 변형과 제공 주소 지원	Cloudflare Images: Edit
Analytics Engine	원하는 만큼 자체 이벤트를 기록하고 SQL로 조회	Account Analytics: Read

Cloudflare 계정은 어떻게 연결하나요?

프로젝트를 열고 상단 바에서 백엔드를 클릭한 다음 클라우드를 클릭하세요.
커넥터에서 Cloudflare 옆의 연결을 클릭하세요. 아직 토큰이 없다면 토큰 만들기를 클릭해 Cloudflare 토큰 페이지를 여세요.
API 토큰에 토큰을 붙여 넣고 Cloudflare 연결을 클릭하세요.
토큰으로 여러 계정에 접근할 수 있다면 앱을 실행할 계정을 고르고 이 계정 사용을 클릭하세요. MonstarX가 토큰으로 계정 목록을 불러오지 못하면 계정 ID를 묻습니다. 계정 ID는 Cloudflare 대시보드에 표시되는 32자 값입니다.

그다음 MonstarX가 토큰에 어떤 권한이 있는지 확인합니다. Workers와 D1 권한이 없으면 연결하지 않고, 어떤 권한을 추가해야 하는지 정확히 알려 줍니다. 추가 서비스 권한이 빠져 있으면 “이 토큰으로 …에 접근할 수 없습니다”라고 알려 주며, 나머지는 그대로 작동합니다.

내 계정에 어떻게 게시하나요?

연결이 끝나면 백엔드클라우드의 Cloudflare 카드에 내 계정과 내 Cloudflare에서 이 앱 실행 스위치가 표시됩니다. 스위치를 켜면 게시 메뉴에 앱을 내 Cloudflare 계정에 배포한다는 안내가 계정 이름, 주소와 함께 나타납니다.

게시하면 이렇게 진행됩니다.

MonstarX가 내 계정에 프로젝트 이름을 딴 D1 데이터베이스를 만들고(같은 이름이 있으면 그것을 다시 씁니다), 앱에 필요한 테이블을 모두 설정합니다.
앱을 빌드해서 앱 이름을 딴 Worker로 업로드합니다.
앱은 your-app.your-subdomain.workers.dev나 내 도메인에서 열립니다.

내 도메인을 쓰려면 Cloudflare 카드에서 내 도메인 사용을 클릭하세요. MonstarX가 내 Cloudflare 계정에 있는 도메인을 보여 줍니다. 도메인을 고르고 주소(도메인 자체 또는 그 아래의 하위 도메인)를 입력한 뒤 이 주소 사용을 클릭하세요. DNS 레코드와 HTTPS 인증서는 Cloudflare가 추가합니다. 변경 사항은 다음에 게시할 때 적용됩니다. workers.dev 사용을 클릭하면 다시 원래 주소로 돌아갑니다.

앱에서 Cloudflare 서비스는 어떻게 쓰나요?

원하는 것을 요청하세요. “업로드한 사진을 R2에 저장해 주세요”, “메뉴를 KV에 캐시해 주세요”, “Workers AI로 리뷰를 요약해 주세요”처럼요. MonstarX가 내 계정에 서비스를 만들고(프로젝트 이름을 따거나, 같은 이름이 있으면 다시 씁니다) 앱에 연결한 뒤 코드를 작성합니다. 미리보기에서도 바로 작동합니다.

Cloudflare 카드의 Cloudflare 서비스 목록에서 직접 관리할 수도 있습니다. 추가로 서비스를 더하고, uploads나 sessions처럼 짧은 이름을 붙인 뒤 만들기를 클릭하세요. 사용 중지를 클릭하면 서비스와 앱의 연결이 끊깁니다. Cloudflare에서는 아무것도 삭제되지 않고, 데이터는 내 계정에 그대로 남습니다.

알아 두면 좋은 점

한도도 요금도 내 계정 기준입니다. 앱이 쓴 만큼 Cloudflare가 내 계정에 요금을 청구합니다. Cloudflare의 요청 한도는 계정별로 적용되므로, 내 계정의 앱이 바빠도 다른 사람의 앱이 느려지지 않고 그 반대도 마찬가지입니다.
게시 취소를 하면 내 계정에서 Worker가 삭제됩니다. D1 데이터베이스와 다른 서비스는 남습니다.
앱이 그 계정에 게시되어 있는 동안에는 계정을 바꾸거나 연결을 해제할 수 없습니다. 먼저 게시를 취소하거나, 내 Cloudflare에서 이 앱 실행을 끄고 다시 게시하세요. 앱을 내 계정으로 옮기거나 내 계정에서 빼면, 원래 있던 곳의 Worker는 삭제됩니다.
데이터가 Supabase나 Railway에 있나요? 앱은 그 데이터베이스를 계속 쓰고, D1 데이터베이스는 만들어지지 않습니다.
가져온 앱은 자체 빌드로 만든 정적 파일 형태로 내 계정에 게시됩니다. 데이터베이스가 없고, Cloudflare 서비스 도우미도 쓸 수 없습니다.
내보내기에도 같은 Cloudflare 설정이 들어 있습니다. 다운로드한 코드에서 wrangler deploy를 실행하면 같은 서비스가 연결됩니다. 코드 내보내기를 참고하세요.

자주 묻는 질문

토큰에 어떤 권한이 필요한가요?

Cloudflare의 Edit Cloudflare Workers 템플릿으로 시작하고 D1: Edit를 추가하세요. 추가 서비스마다 권한을 더하세요. 예를 들어 R2에는 Workers R2 Storage: Edit가 필요합니다.

게시된 앱의 데이터가 미리보기와 다른 이유는 무엇인가요?

내 Cloudflare 계정에 게시된 앱은 별도의 D1 데이터베이스를 쓰며, 이 데이터베이스는 비어 있는 상태로 시작합니다. 미리보기는 MonstarX의 연습용 데이터를 계속 쓰므로, 실제 고객 기록을 건드리지 않고 테스트할 수 있습니다.

내 도메인을 쓸 수 있나요?

네, 그 도메인이 내 Cloudflare 계정에 있다면 가능합니다. Cloudflare 카드에서 내 도메인 사용을 클릭하고 도메인을 고른 뒤 주소를 입력하고 다시 게시하세요.

MonstarX가 내 Cloudflare 계정에서 무언가를 삭제하나요?

게시를 취소하거나 앱을 계정에서 옮길 때 앱의 Worker만 삭제합니다. 사용 중지를 눌러도 데이터베이스와 서비스는 절대 삭제되지 않습니다.

MonstarX 호스팅으로 돌아갈 수 있나요?

네. 내 Cloudflare에서 이 앱 실행을 끄고 다시 게시하세요. 앱이 MonstarX로 옮겨지면 내 계정의 Worker는 삭제됩니다.