Урок 092 минуты чтения
Что такое Single Executable Applications в Node.js?
На этой странице
Кратко
Single Executable Applications, или SEA, позволяют упаковать Node.js-приложение в один исполняемый файл. Это удобно для CLI и internal tools, но для backend-сервисов чаще используют Docker image.
Вопрос
Что такое Single Executable Applications в Node.js?
Зачем SEA?
SEA нужен, чтобы:
- распространять CLI без установки Node.js;
- отдавать один executable пользователю;
- упростить internal tooling;
- зафиксировать runtime;
- уменьшить setup для оператора.
Базовая идея
app.js + node binary + sea config -> executableПример config:
{
"main": "./dist/cli.js",
"output": "./dist/my-cli",
"assets": {
"help.txt": "./assets/help.txt"
}
}Сборка:
node --build-sea sea-config.jsonДетальный процесс зависит от OS: на macOS/Windows может понадобиться подпись бинарника.
Как читать assets?
import { getAsset, getAssetKeys } from 'node:sea';
console.log(getAssetKeys());
const help = getAsset('help.txt', 'utf8');
console.log(help);Когда SEA хороший выбор?
- CLI;
- миграционный tool;
- internal admin utility;
- self-contained dev tool;
- agent/daemon для controlled environment.
Когда лучше Docker?
Для server backend обычно лучше Docker:
- проще runtime config;
- проще networking;
- проще observability;
- привычнее orchestration;
- легче обновлять зависимости ОС;
- не нужно думать о binary signing.
Что важно помнить
- SEA упаковывает скрипт и бинарник Node.js в один исполняемый файл.
- Удобно для CLI-утилит без установки Node.js у пользователя.
- Код нужно собрать в один файл заранее (бандлером), нативные модули поддерживаются ограниченно.
- Файл получается большим — в нем весь runtime Node.js.
Мини-шпаргалка
- SEA упаковывает Node-приложение в executable.
- Хорошо для CLI/tools.
node:seaчитает bundled assets.- Для web backend чаще Docker.
- API находится в active development, проверяй версию Node.js.
Документация
Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.