Next.js na VPS: como publicar seu site com Nginx
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

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:
- aponte o domínio para o IP da sua VPS;
- instale uma LTS do Node.js e o Nginx pelos sites oficiais e confira com
node --version; - envie o projeto e confirme que o
nextestá atualizado; - defina as variáveis de ambiente, com as
NEXT_PUBLIC_antes do build; - rode
npm ci(ounpm install) enpm run build; - teste com
npx next start -H 127.0.0.1 -p 3000; - crie o serviço do systemd (ou o arquivo do PM2) e ative-o;
- crie o bloco do Nginx, rode
nginx -tenginx -s reload; - rode o Certbot e teste a renovação;
- 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.