Base de Conhecimento

Next.js na VPS: como publicar seu site com Nginx

  • next.js, vps, nginx, node.js, systemd, pm2
  • Usuários acharam útil: 0

Passo a passo para publicar um site Next.js em uma VPS: versões, build, serviço no systemd ou PM2, proxy do Nginx e HTTPS com Certbot, com exemplos para conferir.

Por Redação Eleven Host · @robson.direitodigital · 5 de novembro de 2026 · 10 min de leitura

Arte da Eleven Host: janela de terminal com o título: Next.js na VPS: como publicar seu site com Nginx

Capa da Redação Eleven Host para o guia: Next.js na VPS: como publicar seu site com Nginx Arte: Eleven Host

Next.js na VPS: veja como publicar um site Next.js em um servidor próprio, com o Nginx na frente, um serviço que reinicia em caso de falha e HTTPS, até a conferência final no navegador.

Se você está começando com servidores, o guia O que é servidor VPS explica o básico da máquina onde o site vai ficar. Aqui, os exemplos usam o domínio fictício www.exemplo.com.br, o usuário deploy e a pasta /home/deploy/site. Confira cada caminho no seu servidor antes de copiar.

Pode hospedar o Next.js no seu servidor?

Pode. Segundo a documentação do Next.js, ele pode ser publicado em provedores que ofereçam Node.js, e os deploys com Node.js aceitam os recursos do framework.

Versões na data da publicação

Retrato de 05/11/2026

Em 05/11/2026, a versão atual do pacote next no npm é a 16.4.5, lançada como correção de segurança em 03/11/2026. A documentação pede Node.js 20.9 como mínimo. Só que o Node.js 20 já chegou ao fim do suporte: o site do Node.js diz que aplicações em produção devem usar apenas versões LTS (suporte de longo prazo) ativas ou em manutenção. Na mesma data, as séries 22, 24 e 26 eram LTS, e a 26.13.0 aparecia como a LTS mais recente. Por isso, recomendamos instalar uma versão LTS atual, e não a 20.

Para instalar o Node.js e o Nginx, siga as instruções dos sites oficiais de cada um, que mostram o caminho para a sua distribuição. Depois, confira o resultado:

node --version

nginx -v

As versões mudam com o tempo. A documentação manda manter o Next.js atualizado, e o blog do projeto publicou várias correções de segurança nos últimos meses. Se o projeto já existe, atualize o pacote antes de publicar. Um exemplo de comando (confira no seu servidor):

npm install next@16.4.5

Servidor virtual entra na sua lista de opções? VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver as VPS

Build e start do projeto

A documentação mostra estes scripts no package.json:

"dev": "next dev",

"build": "next build",

"start": "next start"

Para publicar, rode npm run build e depois npm run start, que sobe o servidor Node.js. O next start exige que o projeto já tenha sido compilado com next build.

A porta padrão é a 3000 (troque com -p). O endereço padrão do next start é 0.0.0.0, ou seja, ele escuta em todos os endereços da máquina. Como a documentação recomenda colocar um proxy reverso (como o Nginx) na frente do servidor Next.js, em vez de expô-lo diretamente à internet, recomendamos passar -H 127.0.0.1: assim o Next.js só aceita conexões da própria máquina, e quem fala com a internet é o Nginx. Um exemplo de comando de teste:

npx next start -H 127.0.0.1 -p 3000

Segundo a documentação, o proxy reverso pode lidar com requisições malformadas, ataques de conexão lenta, limites de tamanho e outras questões de segurança. Isso não faz do proxy uma garantia de segurança total.

Variáveis de ambiente

Por padrão, as variáveis de ambiente ficam disponíveis só no servidor. Para expor uma ao navegador, o nome precisa começar com NEXT_PUBLIC_, e nesse caso o valor é gravado no JavaScript durante o next build. Depois do build, o app não responde mais a mudanças nessas variáveis: trocou um valor NEXT_PUBLIC_, rode o build de novo.

O Next.js procura as variáveis nesta ordem: process.env, .env.$(NODE_ENV).local, .env.local, .env.$(NODE_ENV) e .env. A documentação desaconselha enviar esses arquivos ao repositório. A porta PORT não pode ser definida no .env, porque o servidor HTTP sobe antes de qualquer outro código.

Sem o -H 127.0.0.1, o Next.js escuta em todos os endereços da máquina, o que vai contra a recomendação de não deixar o servidor direto na internet.

Opção: output standalone

A documentação oferece o output: 'standalone', que gera a pasta .next/standalone com um server.js mínimo no lugar do next start, sem precisar do node_modules no destino. É só uma opção: o restante do texto usa o next start.

module.exports = {

output: 'standalone',

}

Ele não copia as pastas public e .next/static; copie-as à mão depois de cada build. Comandos da documentação:

cp -r public .next/standalone/ && cp -r .next/static .next/standalone/.next/

node .next/standalone/server.js

Porta e endereço vêm de PORT e HOSTNAME. Um exemplo atrás do Nginx (confira no seu servidor):

PORT=3000 HOSTNAME=127.0.0.1 node server.js

Como os arquivos .env podem não acompanhar essa pasta, entregue as variáveis ao serviço com EnvironmentFile=, como na próxima seção.

Manter o site no ar com o systemd

Para o Next.js continuar rodando depois de fechar o terminal e voltar sozinho após uma falha, vamos usar um serviço do systemd. Segundo a documentação do systemd, Restart=on-failure reinicia o serviço quando o processo sai com código diferente de zero, Type=exec considera o serviço iniciado depois de executado o binário principal, e EnvironmentFile= lê as variáveis de um arquivo de texto, com caminho absoluto. Crie o arquivo indicado em EnvironmentFile= antes de ativar o serviço, com uma variável por linha no formato NOME=valor; sem ele o serviço não inicia.

Um exemplo de unidade, em /etc/systemd/system/site.service. Descubra o caminho do Node no seu servidor com which node e ajuste o ExecStart. O TimeoutStopSec=30 é um valor de exemplo, dentro da janela de 10 a 30 segundos que a documentação do Next.js cita para encerrar o servidor com calma, e você pode ajustá-lo.

[Unit]

Description=Site Next.js

After=network.target

[Service]

Type=exec

User=deploy

WorkingDirectory=/home/deploy/site

EnvironmentFile=/etc/site/ambiente

ExecStart=/usr/bin/node node_modules/next/dist/bin/next start -H 127.0.0.1 -p 3000

Restart=on-failure

TimeoutStopSec=30

[Install]

WantedBy=multi-user.target

Se escolheu o caminho standalone, um exemplo das linhas que mudam:

WorkingDirectory=/home/deploy/site/.next/standalone

Environment=PORT=3000

Environment=HOSTNAME=127.0.0.1

ExecStart=/usr/bin/node server.js

Um exemplo de comandos para ativar o serviço:

sudo systemctl daemon-reload

sudo systemctl enable --now site

Alternativa: PM2

O PM2 também mantém o processo no ar; use um caminho ou o outro, não os dois. Segundo a documentação do PM2, ele se instala com npm install pm2@latest -g e inicia por um arquivo ecosystem.config.js. Um exemplo com uma única instância em modo fork:

module.exports = {

apps: [{

name: "site",

cwd: "/home/deploy/site",

script: "node_modules/next/dist/bin/next",

args: "start -H 127.0.0.1 -p 3000",

instances: 1,

exec_mode: "fork",

env: { NODE_ENV: "production" }

}]

}

Depois, pm2 start ecosystem.config.js inicia o app. Para subir com o servidor, o PM2 tem o pm2 startup, que imprime um comando para você rodar com sudo, e o pm2 save. Não use várias instâncias sem ler a seção de cache abaixo.

O Nginx na frente do Next.js

Este é um exemplo de bloco do Nginx, montado a partir da documentação do próprio Nginx. Os cabeçalhos X-Forwarded avisam o Next.js sobre o endereço e o protocolo originais. A linha proxy_http_version 1.1 fica explícita porque, segundo a documentação do Nginx, a versão 1.1 só é o padrão a partir da 1.29.7, e a sua pode ser mais antiga. Confira no seu servidor:

server {

listen 80;

server_name www.exemplo.com.br;

location / {

proxy_pass http://127.0.0.1:3000;

proxy_http_version 1.1;

proxy_set_header Host $host;

proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

proxy_set_header X-Forwarded-Proto $scheme;

}

}

Para testar a sintaxe e aplicar, use nginx -t, que verifica a configuração e tenta abrir os arquivos citados nela, e depois nginx -s reload.

Para publicar vários sites na mesma VPS, veja também Nginx Proxy Manager: vários sites numa VPS só. Outro projeto publicado com Nginx está em Laravel na VPS.

Streaming: desligar o buffer

Só mexa nisto se o seu site usa streaming. Segundo a documentação do Next.js, com Nginx ou proxy parecido é preciso desativar o buffering, enviando o cabeçalho X-Accel-Buffering: no, que o Nginx entende. Exemplo da documentação, no next.config.js:

module.exports = {

async headers() {

return [

{

source: '/:path*{/}?',

headers: [

{

key: 'X-Accel-Buffering',

value: 'no',

},

],

},

]

},

}

Depois da mudança, rode o build de novo e reinicie o serviço.

HTTPS com Certbot

Para o certificado, o site do Certbot pede que o endereço esteja acessível ao resto da internet na porta 80. Siga as instruções do próprio site do Certbot para o seu sistema com Nginx, que passam pelo snap. Com o Certbot instalado, o comando abaixo obtém o certificado e edita a configuração do Nginx sozinho; para só obter o certificado, a documentação usa certonly no lugar:

sudo certbot --nginx

O pacote do Certbot traz um agendador (cron ou timer do systemd) que renova antes de vencer. Para testar a renovação:

sudo certbot renew --dry-run

Imagens, cache e mais de um servidor

Segundo a documentação, a otimização de imagens do next/image funciona na auto-hospedagem, sem configuração, com next start.

O cache e o ISR ficam, por padrão, no disco local de cada instância. Isso funciona sozinho para uma única instância de next start com disco persistente. Com mais de uma instância, todas precisam usar a mesma chave de criptografia, e o revalidateTag() só invalida o cache da instância em que foi chamado. Por isso o exemplo usa uma única instância.

Sequência completa, do zero ao ar

Um exemplo de ordem; os comandos aparecem nas seções acima. Confira cada passo no seu servidor:

  1. aponte o domínio para o IP da sua VPS;
  2. instale uma LTS do Node.js e o Nginx pelos sites oficiais e confira com node --version;
  3. envie o projeto e confirme que o next está atualizado;
  4. defina as variáveis de ambiente, com as NEXT_PUBLIC_ antes do build;
  5. rode npm ci (ou npm install) e npm run build;
  6. teste com npx next start -H 127.0.0.1 -p 3000;
  7. crie o serviço do systemd (ou o arquivo do PM2) e ative-o;
  8. crie o bloco do Nginx, rode nginx -t e nginx -s reload;
  9. rode o Certbot e teste a renovação;
  10. se houver streaming, aplique o cabeçalho X-Accel-Buffering, refaça o build e reinicie.

Para conferir, abra o site em HTTPS, navegue pelas páginas, veja se as imagens do next/image aparecem, confira o valor das variáveis NEXT_PUBLIC_ e reinicie a VPS para ver se o serviço volta sozinho.

Atualizar o site depois de publicado

Para uma nova versão, atualize o código, rode npm run build e reinicie o serviço. No caminho standalone, repita os comandos cp antes de reiniciar. Escolha um horário de pouco movimento: o site pode ficar indisponível durante a troca.

Depois de publicar

Publicado o site, o próximo passo é manter o servidor e o código em dia.

Os preços de VPS já entraram no seu planejamento? VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver os planos

Perguntas frequentes

O Nginx é obrigatório para publicar o Next.js?

Não. A documentação do Next.js recomenda usar um proxy reverso, como o Nginx, na frente do servidor em vez de expô-lo direto à internet, mas isso é uma recomendação.

Posso usar o Node.js 20?

O mínimo declarado pelo Next.js é o 20.9, mas o Node.js 20 está sem suporte. Recomendamos uma versão LTS atual, conferida com node --version.

Por que usar -H 127.0.0.1?

Porque o endereço padrão do next start é 0.0.0.0. Com -H 127.0.0.1, só o Nginx, na mesma máquina, consegue falar com o Next.js.

Esta resposta lhe foi útil?

Artigos Relacionados