Do Obsidian ao site: a Cloudflare

O site gerado pelo template é só um conjunto de arquivos: HTML, imagens e estilos, na pasta .site/dist/. A Cloudflare guarda esses arquivos e os entrega a quem visita o site. Ela faz isso por um Worker, o serviço dela que roda perto do visitante; aqui, o Worker não tem código nenhum e só serve os arquivos. Pedidos a arquivos estáticos não são cobrados nem limitados, então o plano gratuito basta.

Nesta página você publica o site uma vez, à mão, a partir do computador. Depois, a automação repete o mesmo comando a cada envio do vault.

1. Criar a conta

Crie uma conta gratuita em dash.cloudflare.com/sign-up. Não é preciso ter um domínio.

2. Publicar pela primeira vez

O Wrangler é a ferramenta de linha de comando da Cloudflare. Ela não vem no template, e o npx a baixa na hora. Na pasta .site, conecte o Wrangler à sua conta:

npx wrangler@4 login

O comando abre o navegador para você autorizar o acesso. Depois, gere o site e publique:

npm run build
npx wrangler@4 deploy --assets ./dist --name meu-blog --compatibility-date 2026-10-15

O que cada opção faz:

Opção	O que é
--assets ./dist	A pasta com os arquivos do site, gerada pelo npm run build
--name meu-blog	O nome do Worker. Ele vira parte do endereço do site
--compatibility-date 2026-10-15	A data de referência do comportamento do Worker. Use a data do dia em que você publica pela primeira vez e mantenha a mesma depois

Com essas opções na linha de comando, o template não precisa de nenhum arquivo de configuração da Cloudflare.

Ao final, o Wrangler mostra o endereço do site, no formato https://meu-blog.<seu-subdominio>.workers.dev. O <seu-subdominio> é o subdomínio workers.dev da sua conta, que você pode ver e trocar em Workers & Pages, no painel da Cloudflare.

Volte ao .site/astro.config.mjs e ponha esse endereço em site, como na página do template do Astro. Depois, rode de novo npm run build e o wrangler deploy, e envie o vault: até lá, o feed RSS e o mapa do site continuam com o endereço de exemplo.

3. Ligar um domínio próprio (opcional)

O endereço workers.dev funciona e é gratuito. A própria Cloudflare recomenda um domínio próprio para sites que não sejam projetos pessoais. Para usar um domínio seu:

1. O domínio precisa estar na Cloudflare, comprado nela ou transferido para ela.
2. No painel, vá a Workers & Pages e escolha o Worker meu-blog.
3. Em Settings → Domains & Routes → Add → Custom Domain, digite o domínio (por exemplo, blog.seudominio.com) e confirme com Add Custom Domain.

A Cloudflare cria o registro de DNS e o certificado sozinha. Depois, troque o site do astro.config.mjs pelo domínio novo, gere, publique e envie o vault de novo.

4. Preparar as chaves da automação

No computador, o wrangler login usou a sua sessão no navegador. A automação não tem navegador: ela se identifica com duas informações, que você guarda agora para a próxima página.

O token de API. No painel da Cloudflare:

1. Abra Account API tokens e clique em Create Token.
2. Em Permission policies, escolha o modelo Edit Cloudflare Workers.
3. Limite o token à conta do site e crie.
4. Copie o token. Ele só aparece uma vez.

O id da conta. Em qualquer página do painel, abra a busca (Cmd+K no macOS, Ctrl+K no Windows e no Linux), digite Copy account ID e escolha o resultado. O id vai para a área de transferência.

Guarde os dois num gerenciador de senhas. Na automação, eles se chamam CLOUDFLARE_API_TOKEN e CLOUDFLARE_ACCOUNT_ID.

O que fica igual daqui em diante

Toda publicação é o mesmo par de comandos: npm run build e npx wrangler@4 deploy com as mesmas opções. Nas próximas páginas, a automação os roda por você a cada envio do vault: com GitHub Actions ou com Azure Pipelines.