Node.js v18.16.0 文档

单个可执行应用程序#

源代码: lib/internal/main/single_executable_application.js

此功能允许将 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 拷贝

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

   $ cp $(command -v node) hello 拷贝

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

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

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

   • 在 macOS 以外的系统上：

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

   • 在 macOS 上：

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

4. 运行二进制文件：

   $ ./hello world
   Hello, world! 拷贝

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