Publicar Next.js na Zenifra

O Next.js roda na Zenifra como um servidor Node.js completo: renderização no servidor, rotas de API, Server Actions, middleware e otimização de imagens funcionam sem adaptadores.

Pré-requisitos

• Repositório no GitHub com o projeto Next.js
• package.json e package-lock.json versionados na raiz do repositório
• Conta GitHub conectada à Zenifra
• Projeto rodando localmente com npm ci && npm run build && npm start

Configuração no console

Variáveis de ambiente no Next.js

O Next.js trata dois tipos de variável de forma diferente:

Na Zenifra, as variáveis do projeto ficam disponíveis durante a build, então NEXT_PUBLIC_* funciona normalmente.

Nunca coloque segredos em variáveis NEXT_PUBLIC_*: elas ficam visíveis para qualquer visitante.

Health check

Crie uma rota leve para o health check:

export const dynamic = 'force-dynamic';

export function GET() {
  return Response.json({ status: 'ok' });
}

Configure o caminho /api/health no projeto. Se usar middleware.ts com autenticação, libere essa rota no matcher para que a verificação não receba redirecionamento.

Banco de dados com Prisma ou Drizzle

1. Crie um banco gerenciado e copie a URL de conexão.
2. Adicione DATABASE_URL nas variáveis do projeto.
3. Garanta que o cliente do ORM seja gerado na build. Com Prisma, o comando prisma generate costuma estar no postinstall; se não estiver, use build = npx prisma generate && npm run build.
4. Aplique migrations no início da execução, quando a aplicação já tem acesso à rede do projeto:

start: npx prisma migrate deploy && npx next start -H 0.0.0.0 -p 3000

Arquivos enviados por usuários

O sistema de arquivos da instância é efêmero. Uploads gravados em public/ ou em disco somem a cada publicação. Use armazenamento persistente com um diretório fora do código, como /app/uploads, ou um serviço de armazenamento de objetos.

Cache do Next.js e várias instâncias

O cache de dados e o ISR do Next.js ficam no disco de cada instância por padrão. Com mais de uma instância, cada uma mantém seu próprio cache, e revalidatePath afeta só a instância que recebeu a chamada. Se isso importa para você, use uma instância ou configure um cacheHandler compartilhado com o cache gerenciado.

Saída standalone (opcional)

output: 'standalone' reduz o tamanho da aplicação em execução. Se ativar, ajuste o start:

build: npm run build && cp -r public .next/standalone/ && cp -r .next/static .next/standalone/.next/
start: node .next/standalone/server.js

E defina as variáveis HOSTNAME=0.0.0.0 e PORT=3000 no projeto, que o server.js usa para escutar.

Problemas comuns

Próximos passos

• Domínio personalizado
• Ambientes de Preview por pull request
• Checklist de produção
• Guias por framework