É possível transformar uma aplicação Node.js em um executável. O arquivo gerado contém o runtime do Node.js e o código da aplicação, então a máquina de destino não precisa ter o Node.js instalado.
A solução oficial para isso é o Node.js SEA. Se o objetivo é distribuir a aplicação para clientes, ele é um bom ponto de partida.
Este exemplo usa Node.js 25.5 ou superior.
1. Criar a aplicação
Para testar o fluxo, use uma aplicação simples:
// app.js
console.log("Minha aplicação Node.js");
2. Criar o sea-config.json
Salve esta configuração em um arquivo chamado sea-config.json:
{
"main": "app.js",
"output": "app.exe"
}
3. Gerar o executável
Este comando gera o executável a partir da configuração:
node --build-sea sea-config.json
4. Executar
Agora execute o arquivo gerado:
./app.exe
No Linux, o executável não terá a extensão .exe.
Um executável para cada plataforma
Não existe um único executável universal para todos os sistemas. Cada executável deve ser produzido para a plataforma de destino.
Por exemplo, para atender estas quatro plataformas, você precisa de quatro binários:
Linux x64
Windows x64
macOS ARM64
macOS x64
O que ainda exige cuidado
Ter um executável não elimina todas as dependências. Bibliotecas nativas, arquivos externos e a compatibilidade com o sistema operacional ainda podem exigir cuidados.
Este exemplo tem um único arquivo, sem dependências npm nem arquivos externos. Se a sua aplicação usa esses recursos, avalie como tratá-los antes de distribuir. A referência do recurso é a documentação oficial do Node.js SEA.
Outras ferramentas
O SEA não é a única opção. O pkg e o nexe também empacotam aplicações Node.js em executáveis. O Bun possui um recurso que compila aplicações JavaScript e TypeScript em executáveis standalone.
Resumo
app.js + sea-config.json → node --build-sea → executável
Gere um executável para cada plataforma de destino e confira as bibliotecas nativas, os arquivos externos e a compatibilidade com o sistema operacional antes de distribuir.