---
title: "Como publicar um site Astro no painel WordPane | WordPane Cloud"
url: "https://wordpane.cloud/blog/astro-deploy-painel-wordpane/"
description: "Do build ao domínio: publique um site Astro na WordPane, configure a pasta pública e prepare atualizações por Git sem confundir estático com SSR."
language: "pt-BR"
publishedAt: "2026-10-08"
modifiedAt: "2026-10-30"
generatedAt: "2026-10-31T14:05:07.042Z"
contentType: "public-page"
pricingSource: "https://app.wordpane.cloud/api/public/plan-catalog"
---

Deploy e desenvolvimento

# Como publicar um site Astro no painel WordPane

Do build ao domínio: publique um site Astro na WordPane, configure a pasta pública e prepare atualizações por Git sem confundir estático com SSR.

Equipe WordPane8 de outubro de 20268 min de leituraRevisado em 30 de outubro de 2026

![Capa do artigo: Como publicar um site Astro no painel WordPane — WordPane Cloud](https://wordpane.cloud/assets/performance-20261027/blog-astro-deploy-painel-wordpane-4a8294976d-960.webp)

**Compartilhe este guia**

[WhatsApp (abre em nova aba)](https://wa.me/?text=Como%20publicar%20um%20site%20Astro%20no%20painel%20WordPane%0Ahttps%3A%2F%2Fwordpane.cloud%2Fblog%2Fastro-deploy-painel-wordpane%2F)[LinkedIn (abre em nova aba)](https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fwordpane.cloud%2Fblog%2Fastro-deploy-painel-wordpane%2F)[Facebook (abre em nova aba)](https://www.facebook.com/sharer/sharer.php?u=https%3A%2F%2Fwordpane.cloud%2Fblog%2Fastro-deploy-painel-wordpane%2F)Copiar linkOutras opções

## Resposta direta

Um site Astro pré-renderizado pode ser publicado como arquivos estáticos: gere o build e envie o conteúdo de dist ao webroot. Se o projeto renderiza páginas sob demanda, é necessário um adapter, um runtime compatível e um processo de produção. A escolha depende das funcionalidades usadas, não apenas do framework.

Astro é uma opção para sites institucionais, blogs, documentação e páginas de produto. Ele também combina bem com um fluxo em que a IA ajuda a escrever componentes e conteúdo. Mas terminar a interface no computador não conclui a publicação: você precisa transformar o projeto em arquivos de produção, colocá-los no diretório correto e testar o endereço real. Este guia apresenta um caminho estático verificável no painel WordPane e explica o que muda quando existe processamento no servidor.

Visão do processo

- Código e conteúdo

- Build reproduzível

- Arquivos no webroot

- Domínio e testes

## Antes de começar: identifique a saída do projeto

Abra o repositório e confira o package.json, o arquivo de configuração do Astro e as integrações usadas. O caso mais simples é um site totalmente pré-renderizado. Nesse cenário, o build produz arquivos que um servidor web pode entregar, sem manter o processo de desenvolvimento do Astro funcionando. A documentação oficial de deploy indica dist como diretório padrão de saída.

Se o projeto usa endpoints dinâmicos, sessões ou renderização sob demanda, ele pode exigir um adapter e um runtime. Não tente publicar apenas a interface e esperar que a autenticação ou a API apareçam automaticamente. Anote também serviços externos, variáveis, domínio, formulários e o destino dos dados enviados. Essa lista define o ambiente e as tarefas de validação.

## Gere e confira a versão de produção

Execute os comandos a seguir na pasta do projeto. O exemplo pressupõe npm e package-lock.json versionado; se você usa outro gerenciador, mantenha o gerenciador e o lockfile do projeto. Confira a versão Node exigida pela sua versão do Astro. Pare se a instalação ou o build falhar e corrija o erro antes de enviar arquivos.

Use a prévia local para verificar as páginas e o resultado do build. A prévia serve para conferência, não como serviço permanente de produção. Abra uma página interna diretamente, examine as imagens e teste o formulário. Confira se a URL pública e a canônica apontam para seu domínio, em vez do endereço localhost.

No computador de desenvolvimento ou no ambiente de build

```
npm ci
npm run build
npm run preview
```

## Prepare a aplicação no painel

Na área do cliente, escolha a infraestrutura compatível e aguarde a conclusão da configuração do servidor. Para um site estático, avalie um ambiente web que permita servir os arquivos do projeto. Você não precisa contratar um runtime Node apenas porque o Astro usa Node durante o build. A geração pode acontecer no seu computador ou em uma automação de CI.

O caminho observado no painel é Applications → Create an Application → Custom. Os campos de versão PHP desse formulário pertencem à aplicação personalizada PHP; eles não transformam o Astro em PHP. O uso relevante para o site estático é preparar domínio, usuário e diretório público que servirá os arquivos. Confira esse comportamento na stack escolhida.

- Informe Application Name e selecione Primary Domain ou Test Domain.

- Para domínio próprio, informe o endereço e revise a opção de SSL; o DNS precisa apontar para o destino correto.

- Escolha Custom e revise System User em Show Advance Options.

- Confira Custom Webroot. O destino deve corresponder à pasta que receberá o conteúdo gerado, não ao diretório de código-fonte.

- Crie a aplicação e confira o caminho no File Manager antes de enviar o build.

## Envie o conteúdo de dist para o webroot

No File Manager da aplicação, confirme o breadcrumb e o caminho. O webroot observado em nossa documentação é public_html; um projeto com Custom Webroot pode usar outro destino. Envie o conteúdo interno de dist para essa pasta, preservando subpastas e nomes. Se você colocar a pasta dist inteira dentro de public_html, o index.html pode ficar um nível abaixo do que o servidor procura.

Use File Manager ou SFTP com o usuário correto. Mantenha uma cópia do site anterior antes de substituir arquivos. Não envie .env, .git, arquivos de credenciais ou dependências do ambiente de desenvolvimento para a pasta pública. Para futuras atualizações, publique o build completo de forma consistente: HTML novo com assets antigos, ou o contrário, pode quebrar a página.

## Integre o Git sem pular a etapa de build

A integração Git permite vincular conta, repositório e branch à aplicação que disponibiliza esse recurso. Ela não significa, por si só, que todo projeto terá dependências instaladas e build executado. Na documentação WordPane, a aplicação criada pelo método Git oferece opções próprias de atualização; não há um campo de build universal confirmado para todas as stacks.

Você pode gerar os arquivos em uma rotina externa e publicar os artefatos, ou executar um procedimento de build no ambiente que tenha runtime, permissões e recursos necessários. Documente qual método sua equipe adotou. Só habilite atualização automática depois de provar que um commit produz os arquivos finais no webroot e que existe uma forma de recuperar a versão anterior.

## O que muda com Astro e SSR

Para renderização no servidor, consulte o adapter Node oficial e a documentação correspondente à versão do projeto. Essa arquitetura precisa de um processo de produção, configuração de execução e proxy. O ambiente Node.js da WordPane está em beta; confira versão, comando, porta, variáveis e controles disponíveis antes da contratação.

Não copie o formulário PHP como se fosse o formulário Node. Se a aplicação depende de um runtime de edge ou de um serviço específico de outro provedor, prepare a adaptação. A hospedagem do código na VPS não reproduz automaticamente serviços de Vercel ou Cloudflare. Para esse caso, envie os requisitos e o comando de produção à equipe antes de seguir.

## Valide o domínio e resolva as falhas mais comuns

- Página inicial funciona, mas uma rota retorna 404: confira a saída do build, as regras de URL e a estrutura de pastas.

- CSS ou imagens falham: confira o caminho base e se os assets gerados foram publicados junto do HTML.

- Formulário não envia: verifique o endpoint real e o backend responsável; HTML estático não processa mensagens sozinho.

- Uma alteração não aparece: confirme branch, build, diretório de destino e cache do navegador.

- SSL não conclui: confira o DNS e a configuração do domínio antes de repetir a emissão.

- Antes de divulgar, teste menu, páginas internas, metadados sociais e o cadastro que seu projeto oferece.

## Um exemplo: blog estático com formulário externo

Considere um blog em que as páginas são geradas no build e o formulário envia dados a uma API separada. O servidor do blog precisa entregar HTML, CSS, JavaScript e imagens; a API precisa validar os campos, limitar abuso e tratar o envio. Publicar o blog corretamente não demonstra que o formulário está funcionando.

Nesse desenho, uma atualização editorial exige gerar e publicar um novo build. Se o conteúdo vier de um CMS, defina quem dispara essa geração e como reconhecer uma falha. O site continuará mostrando a versão anterior até que o novo artefato seja publicado; isso é parte do fluxo editorial escolhido, não um defeito do DNS.

## Faça a publicação como um release, não como uma cópia improvisada

Guarde o commit de origem, a versão Node, o lockfile e o resultado do build. Prepare todos os arquivos antes de substituir a versão pública. Uma atualização parcial pode deixar o HTML apontando para arquivos com hash que ainda não chegaram ao servidor.

Quando a infraestrutura permitir uma troca de diretório ou de release de forma controlada, use esse mecanismo. Caso a publicação seja por envio de arquivos, planeje a ordem, preserve assets ainda usados e mantenha uma cópia recuperável. Não remova arquivos antigos por nome ou data sem verificar se continuam referenciados.

- Abra diretamente uma URL interna, sem navegar antes pela home.

- Confira canonical, sitemap, robots e a URL da imagem social.

- Teste um endereço inexistente e verifique se a resposta HTTP é realmente 404.

- Envie uma mensagem de teste e confirme seu recebimento no destino.

- Simule a restauração do release anterior antes de automatizar atualizações.

## Como analisar velocidade sem atribuir tudo ao framework

A saída estática elimina processamento de renderização a cada visita, mas não impede imagens grandes, scripts de terceiros ou fontes que atrasam a página. Meça a página publicada em condições comparáveis e observe o elemento que determina o LCP, o peso transferido e a estabilidade visual.

Em uma home com uma ilustração importante, dimensões explícitas e uma imagem bem dimensionada podem valer mais que alterar o servidor. Já uma API lenta exige investigar seu próprio processamento. Separe a medição da página estática da medição dos serviços que ela consome.

## Onde a WordPane agrega à rotina

A plataforma reúne a criação ou conexão do servidor, acompanhamento de operações e consumo na área do cliente. No painel de controle, você encontra ferramentas para domínio, arquivos, integração Git, logs e backup conforme o ambiente configurado. Isso organiza tarefas que continuariam existindo mesmo quando a IA produz boa parte do código.

A cobrança por hora permite acompanhar o consumo do ambiente no saldo. O custo da infraestrutura é separado de modelos de IA, APIs e serviços externos usados pelo projeto. Comece com uma publicação de teste, registre os passos que funcionaram e escolha os recursos com base no comportamento observado. O primeiro resultado útil é um site acessível, atualizável e recuperável.

## Escolha o ambiente do projeto

Compare os planos ou envie os requisitos da aplicação para a equipe WordPane.

[Configurar meu projeto na WordPane](https://app.wordpane.cloud/server/create?application=custom)[Consultar a documentação do painel](https://wordpane.cloud/documentacao/)

## Referências para aprofundar

- [Astro: deploy](https://docs.astro.build/en/guides/deploy/)

- [Astro: adapter Node](https://docs.astro.build/en/guides/integrations-guide/node/)

- [WordPane: Git e deploy](https://wordpane.cloud/documentacao/integracoes/#git-deploy)

- [WordPane: publicação de arquivos](https://wordpane.cloud/documentacao/aplicacoes/#arquivos)

**Precisa escolher o ambiente?**

Conte o que pretende publicar e os requisitos que já conhece.

[Conversar sobre meu projeto](https://wordpane.cloud/sob-medida/)

## Continue explorando

Deploy e desenvolvimento

### [React e Vite: leve sua aplicação criada com IA para produção](https://wordpane.cloud/blog/react-vite-aplicacao-ia-producao/)

Publique uma interface React com Vite, separe frontend e backend e revise autenticação, variáveis e rotas antes de receber clientes.

[Ler artigo](https://wordpane.cloud/blog/react-vite-aplicacao-ia-producao/)

Operação

### [Git e deploy: organize a publicação dos projetos criados com IA](https://wordpane.cloud/blog/git-deploy-projetos-ia/)

Crie um fluxo de revisão, build, publicação e recuperação para projetos desenvolvidos com IA e use a integração Git do painel WordPane com clareza.

[Ler artigo](https://wordpane.cloud/blog/git-deploy-projetos-ia/)

[Ver todos os artigos](https://wordpane.cloud/blog/)

---
Fonte oficial: https://wordpane.cloud/blog/astro-deploy-painel-wordpane/
Esta é uma representação da página pública. A data de geração não indica alteração editorial.
