Node.js/Express项目打包EXE及Nexe证书错误解决咨询

一、Node.js项目打包为单EXE（嵌入所有文件+源码保护）的高效方案 #

以下是针对Express+Node.js项目的靠谱打包方案，均满足源码保护、嵌入全量文件的需求：

1. Nexe（适配Express项目的首选工具） #

Nexe支持将项目打包为单EXE，源码会被编译为V8字节码，无法直接读取；可自动嵌入项目依赖与文件。

• 核心操作：
  • 确保项目依赖已完整安装（执行npm install）
  • 基础打包命令：nexe -i src/index.js -o ./api-test.exe
  • 指定Node.js版本：nexe -i src/index.js -o ./api-test.exe -t 18.17.0
  • 若遇下载问题，可本地编译二进制：nexe -i src/index.js -o ./api-test.exe --build

2. pkg（快速稳定的跨平台打包工具） #

成熟的打包工具，自动处理依赖与文件嵌入，源码同样会被转为字节码，无需复杂配置。

• 核心操作：
  • 全局安装：npm install -g pkg
  • 在package.json中配置入口与需要嵌入的文件：

    "main": "src/index.js",
    "pkg": {
      "scripts": "src/**/*.js",
      "assets": "src/**/*.json" // 按需添加其他静态文件类型
    }
    

  • 打包命令：pkg . --targets node18-win-x64 --output api-test.exe

3. EncloseJS（高源码保护需求首选） #

专注于Node.js项目的加密打包工具，支持源码加密，适合对代码保密性要求高的场景。

• 核心操作：
  • 全局安装：npm install -g enclose
  • 打包命令：enclose --output api-test.exe src/index.js

二、Nexe下载预构建二进制错误的原因与解决方法 #

错误原因 #

Error downloading prebuilt binary: RequestError: unable to get local issuer certificate 本质是HTTPS请求的SSL证书验证失败，常见触发场景：

• 网络处于企业代理/内网环境，代理的SSL证书未被本地系统信任
• Node.js环境的根证书库缺失或未更新
• Nexe预构建包的CDN地址被拦截，导致证书无法正常校验

解决方法 #

方法1：临时跳过证书验证（应急用，不建议生产环境）

通过环境变量禁用Node.js的证书验证：

NODE_TLS_REJECT_UNAUTHORIZED=0 nexe -i src/index.js -o api-test.exe

方法2：本地编译Node.js二进制（推荐，彻底解决下载问题）

使用--build参数让Nexe本地编译Node.js，无需依赖预构建包：

nexe -i src/index.js -o api-test.exe --build

• 注意：Windows需提前安装Visual Studio Build Tools（勾选"C++桌面开发"组件）；Linux需安装gcc、make等编译工具。

方法3：信任代理证书（企业内网场景）

将代理的根证书保存为proxy-cert.pem，执行打包时指定证书：

NODE_EXTRA_CA_CERTS=./proxy-cert.pem nexe -i src/index.js -o api-test.exe

也可将证书导入系统信任证书库，实现全局信任。

方法4：手动下载预构建包

到Nexe的GitHub Releases页面找到对应Node.js版本、平台的预构建包，下载后放到Nexe缓存目录（Windows默认路径：%USERPROFILE%/.nexe），再重新执行打包命令。

内容的提问来源于stack exchange，提问作者Sanchit