Rode o seu app na sua própria conta Cloudflare

O MonstarX publica todo app na própria nuvem dele, sem nada para você gerenciar. Se a sua empresa já usa o Cloudflare — ou você quer o app, os dados e a fatura no seu nome —, conecte a sua conta Cloudflare. Duas coisas mudam:

1. Hospedagem. Quando você publica, o app vai para a sua conta Cloudflare: o seu Worker (o programa que entrega o app), o seu banco de dados D1 (o banco de dados SQL do Cloudflare), o seu domínio e a sua fatura.
2. Serviços do Cloudflare. O código do app pode usar os outros serviços do Cloudflare — armazenamento, filas, IA e mais —, que o MonstarX configura na sua conta para você.

Antes de começar

Você precisa de um token de API do Cloudflare. No Cloudflare, vá em Manage Account → API Tokens, crie um token a partir do modelo Edit Cloudflare Workers e adicione D1: Edit. Acrescente a permissão de cada serviço extra que você quer que o app use:

Serviço	Para que serve	Permissão a adicionar
KV	Um armazenamento chave-valor rápido para configurações, caches, feature flags e tokens de curta duração	Workers KV Storage: Edit
R2	Armazenamento de arquivos sem taxa de download: uploads, imagens, exportações, backups	Workers R2 Storage: Edit
Queues	Tarefas em segundo plano: entregue um trabalho durante uma solicitação e termine depois, com novas tentativas	Queues: Edit
Vectorize	Um índice vetorial para busca por significado	Vectorize: Edit
Workers AI	Modelos de IA abertos para texto, embeddings e imagens, cobrados na sua conta	Workers AI: Edit
Browser Rendering	Um navegador de verdade para capturas de tela, PDFs e o texto legível de qualquer página	Browser Rendering: Edit
Images	Guarde e redimensione imagens, com variantes e um endereço de entrega	Cloudflare Images: Edit
Analytics Engine	Registre os seus próprios eventos em qualquer volume e consulte-os com SQL	Account Analytics: Read

Como conecto a minha conta Cloudflare?

1. Abra o seu projeto e clique em Backend na barra superior e depois em Nuvem.

2. Em Conectores, clique em Conectar ao lado do Cloudflare. (Criar um token abre a página de tokens do Cloudflare, se você ainda não tiver um.)

3. Cole o token em Token de API e clique em Conectar Cloudflare.

   

4. Se o token tiver acesso a mais de uma conta, escolha aquela em que o app deve rodar e clique em Usar esta conta. Se o MonstarX não conseguir listar as suas contas com o token, ele pede o ID da conta (32 caracteres, que aparece no painel do Cloudflare).

Em seguida, o MonstarX confere o que o token tem permissão para fazer. Ele não conecta sem Workers e D1 e diz exatamente qual permissão adicionar. Se faltar um serviço extra, ele avisa — “Este token não consegue acessar …” — e o resto continua funcionando.

Nota

O MonstarX guarda o token de forma criptografada, com nomes que ele mesmo gerencia. O token nunca aparece em Backend›Segredos, não pode ser alterado à mão e nunca vai para o código que roda no navegador.

Como publico na minha própria conta?

Depois de conectar, o cartão do Cloudflare em Backend›Nuvem mostra a sua conta e uma chave, Rodar este app no meu Cloudflare. Com ela ligada, Publicar avisa que vai publicar “na sua própria conta Cloudflare” e mostra a conta e o endereço.

Quando você publica:

1. O MonstarX cria na sua conta um banco de dados D1 com o nome do projeto (ou reaproveita um com esse nome) e monta todas as tabelas de que o app precisa.
2. Ele gera o app e o envia como um Worker com o nome do seu app.
3. O app responde em your-app.your-subdomain.workers.dev ou no seu próprio domínio.

Para usar um dos seus domínios, clique em Usar meu domínio no cartão do Cloudflare. O MonstarX lista os domínios da sua conta Cloudflare; escolha um, digite o Endereço (o próprio domínio ou qualquer subdomínio dele) e clique em Usar este endereço. O Cloudflare adiciona o registro DNS e o certificado HTTPS. A mudança vale a partir da próxima publicação. Usar workers.dev volta para o endereço workers.dev.

Cuidado

O app no ar no Cloudflare começa com um banco de dados vazio. A prévia continua usando a cópia do MonstarX com dados de prática. Pense assim: dados de teste na prévia, dados reais no app no ar.

Como o meu app usa os serviços do Cloudflare?

Peça o que você quer: “guarde as fotos enviadas no R2”, “coloque o cardápio em cache no KV”, “resuma as avaliações com o Workers AI”. O MonstarX cria o serviço na sua conta (com o nome do projeto, ou reaproveitando um com o mesmo nome), conecta ao app e escreve o código. Já funciona na prévia, na hora.

Você também pode gerenciar esses serviços na lista Serviços do Cloudflare, no cartão do Cloudflare: clique em Adicionar, dê um nome curto ao serviço (como uploads ou sessions) e clique em Criar. Parar de usar desconecta um serviço do app — nada é excluído no Cloudflare, e os dados continuam na sua conta.

É bom saber

• Seus limites, sua fatura. O Cloudflare cobra na sua conta o que o app usar. Os limites de solicitações do Cloudflare são por conta, então um app movimentado na sua conta nunca deixa o de outra pessoa lento — e o dos outros nunca deixa o seu lento.
• Tirar do ar exclui o Worker da sua conta. O banco de dados D1 e os outros serviços continuam lá.
• Trocar ou desconectar a conta é recusado enquanto o app estiver no ar nela. Antes, despublique ou desligue Rodar este app no meu Cloudflare e publique. Levar o app para a sua conta ou tirá-lo de lá remove o Worker do lugar onde ele estava.
• Dados no Supabase ou no Railway? O app continua usando esse banco, e nenhum banco D1 é criado para ele.
• Apps importados são publicados na sua conta como os arquivos estáticos gerados pela compilação do próprio app. Eles não ganham banco de dados e não podem usar o recurso de serviços do Cloudflare.
• As exportações trazem a mesma configuração do Cloudflare, então um wrangler deploy a partir do código baixado conecta os mesmos serviços. Veja Exporte o seu código.

Perguntas frequentes

De quais permissões o meu token precisa?

Comece pelo modelo Edit Cloudflare Workers do Cloudflare e adicione D1: Edit. Acrescente uma permissão para cada serviço extra, como Workers R2 Storage: Edit para o R2.

Por que os dados do app no ar são diferentes dos da prévia?

Na sua própria conta Cloudflare, o app no ar tem um banco de dados D1 próprio, que começa vazio. A prévia mantém os dados de prática do MonstarX, para você testar sem mexer nos registros de clientes reais.

Posso usar o meu próprio domínio?

Sim, se o domínio estiver na sua conta Cloudflare. Clique em Usar meu domínio no cartão do Cloudflare, escolha o domínio, digite o endereço e publique de novo.

O MonstarX exclui alguma coisa na minha conta Cloudflare?

Só o Worker do app, quando você tira o app do ar ou o remove da conta. Bancos de dados e serviços nunca são excluídos por Parar de usar.

Posso voltar para a hospedagem do MonstarX?

Sim. Desligue Rodar este app no meu Cloudflare e publique de novo. O Worker na sua conta é removido assim que o app passa a ficar no MonstarX.

Veja também

Publique seu appComo funciona a publicação no MonstarX.

Publique em outras hospedagensVercel, Google Cloud, AWS, Azure e Railway.

Conecte um domínio seuUse o seu próprio endereço na web.

ConectoresTodos os serviços a que o seu app pode se conectar.