•
3 min de leitura
Como gerar um executável de uma aplicação Node.js com SEA

É 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.