Node.js v18.18.2 文档

单个可执行应用程序#

源代码： src/node_sea.cc

此功能允许将 Node.js 应用程序方便地分发到未安装 Node.js 的系统。

Node.js通过允许将 JavaScript 文件注入到node二进制文件中来支持创建单个可执行应用程序。在启动过程中，程序会检查是否已注入任何内容。如果找到该脚本，它将执行其内容。否则 Node.js 会像平常一样运行。

单个可执行应用程序功能仅支持运行单个嵌入式CommonJS文件。

可以使用任何可以将资源注入node二进制文件的工具将捆绑的 JavaScript 文件转换为单个可执行应用程序。

以下是使用此类工具postject创建单个可执行应用程序的步骤：

1. 创建一个 JavaScript 文件：

   $ echo 'console.log(`Hello, ${process.argv[2]}!`);' > hello.js copy

2. 创建node可执行文件的副本并根据您的需要命名：

   $ cp $(command -v node) hello copy

3. 通过使用以下选项运行postject将 JavaScript 文件注入到复制的二进制文件中：

   • hello -步骤 2 中创建的node可执行文件的副本的名称。
   • NODE_JS_CODE - 二进制文件中将存储 JavaScript 文件内容的资源/注释/部分的名称。
   • hello.js - 第 1 步中创建的 JavaScript 文件的名称。
   • --sentinel-fuse NODE_JS_FUSE_fce680ab2cc467b6e072b8b5df1996b2 - Node.js 项目用来检测文件是否已注入的熔断器。
   • --macho-segment-name NODE_JS（仅在 macOS 上需要）- 二进制文件中将存储 JavaScript 文件内容的段的名称。

   总而言之，以下是每个平台所需的命令：

   • 在 macOS 以外的系统上：

     $ npx postject hello NODE_JS_CODE hello.js \
         --sentinel-fuse NODE_JS_FUSE_fce680ab2cc467b6e072b8b5df1996b2 copy

   • 在 macOS 上：

     $ npx postject hello NODE_JS_CODE hello.js \
         --sentinel-fuse NODE_JS_FUSE_fce680ab2cc467b6e072b8b5df1996b2 \
         --macho-segment-name NODE_JS copy

4. 运行二进制文件：

   $ ./hello world
   Hello, world! copy

const { createRequire } = require('node:module');
require = createRequire(__filename); copy