百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
E

electron-asar-encrypt-demo

> 编程语言
开源

在 Electron 应用程序中隐藏 JavaScript 代码。

345 stars0 点赞2 次浏览
访问官网GitHub

工具介绍

在 Electron 应用程序中隐藏 JavaScript 代码。

给 Electron 应用加密源码

The solution described in this demo repositry has been integrated into asarmor, if you would like to encrypt your electron project JavaScript source code like this demo, give it a try!

Translations

Great thanks to those who translated this README to other languages.

  • English - sleeyax/electron-asar-encrypt-demo
  • Portuguese - maxwellcc/electron-asar-encrypt-demo

为什么会有这个仓库?

众所周知,Electron 官方没有提供保护源码的方法。打包一个 Electron 应用,说白了就是把源码拷到固定的一个地方,比如在 Windows / Linux 下是 resources/app 这个目录。运行 Electron 应用时,Electron 就把这个目录当作一个 Node.js 项目去跑里面的 JS 代码。虽然 Electron 认识 ASAR 格式的代码包,即可以把所有的源码打包成一个 app.asar 文件放到 resources 目录,Electron 把 app.asar 当成一个文件夹,跑里面的代码,但是 ASAR 包中的文件是没有加密的,仅仅是把所有的文件拼接成了一个文件再加上了文件头信息,使用官方提供的 asar 库很容易把所有的源码从 ASAR 包提取出来,所以起不到加密的效果,只是对于初心者来说想接触到源码多了一点小门槛,稍微懂行一点的完全无压力。

所以我就在思考如何对 ASAR 包进行加密,防止商业源码被一些有心人士轻易篡改或注入一些恶意的代码后再分发。这里提供了一种不需要重新编译 Electron 即可完成加密的思路。

跑起来

bash
git clone https://github.com/toyobayashi/electron-asar-encrypt-demo.git
cd ./electron-asar-encrypt-demo
npm install # 复制 electron release 到 test 目录
npm start # 编译然后启动应用
npm test # 编译然后跑测试

加密

以 AES-256-CBC 为例,先生成密钥保存在本地的文件中,方便 JS 打包脚本导入和 C++ include 内联。

javascript
// 这个脚本不会被打包进客户端,本地开发用
const fs = require('fs')
const path = require('path')
const crypto = require('crypto')

fs.writeFileSync(path.join(__dirname, 'src/key.txt'), Array.prototype.map.call(crypto.randomBytes(32), (v => ('0x' + ('0' + v.toString(16)).slice(-2)))))

这样就会在 src 生成一个 key.txt 文件,里面的内容是这样的:

0x87,0xdb,0x34,0xc6,0x73,0xab,0xae,0xad,0x4b,0xbe,0x38,0x4b,0xf5,0xd4,0xb5,0x43,0xfe,0x65,0x1c,0xf5,0x35,0xbb,0x4a,0x78,0x0a,0x78,0x61,0x65,0x99,0x2a,0xf1,0xbb

打包时做加密,利用 asar 库的 asar.createPackageWithOptions() 这个 API:

typescript
/// 

declare namespace asar {
  // ...
  export function createPackageWithOptions(
    src: string,
    dest: string,
    options: {
      // ...
      transform?: (filePath: string) => NodeJS.ReadWriteStream | void;
    }
  ): Promise
}

export = asar;

在第三个参数中传入 transform 选项,它是一个函数,返回一个 ReadWriteStream 可读写流去处理文件,返回 undefined 则不对文件做处理。这一步对所有的 JS 文件加密后打进 ASAR 包中。

…

主进程解密

解密在客户端运行时做,因为 V8 引擎没法运行加密后的 JS,所以必须先解密后再丢给 V8 跑。这里就有讲究了,客户端代码是可以被任何人蹂躏的,所以密钥不能明着写,也不能放配置文件,所以只能下沉到 C++ 里。用 C++ 写一个原生模块实现解密,而且这个模块不能导出解密方法,否则没有意义。另外在 C++ 源码中密钥也不能写死成字符串,因为字符串在编译后的二进制文件中是可以直接找到的。

什么?不导出不是没法用吗?很简单,Hack 掉 Node.js 的 API,保证外部拿不到就 OK,然后直接把这个原生模块当作入口模块,在原生模块里面再 require 一下真正的入口 JS。以下是等价的 JS 逻辑:

…

node-addon-api v3 以上可以直接使用:

cpp
Napi::Value Napi::Env::RunScript(const char* utf8script);
Napi::Value Napi::Env::RunScript(const std::string& utf8script);
Napi::Value Napi::Env::RunScript(Napi::String script);

然后就可以愉快地 JS in C++ 了。

…
…

看到这里可能会问了搞了大半天为什么还要用 C++ 来写 JS 啊,不是明明可以 RunScript() 吗? 前面也已经提到过,直接 runScript 需要把 JS 写死成字符串,在编译后的二进制文件中是原样存在的,密钥会被泄露,用 C++ 来写这些逻辑可以增加反向的难度。

总结下就是这样的:

  1. main.node (已编译) 里面 require main.js (已加密)
  2. main.js (已加密)里面再 require 其它加密的 JS,创建窗口等等

特别注意,入口必须是 main.node,如果不是,则很有可能被攻击者在加载 main.node 之前的 JS 中 hack 掉 Node API 导致密钥泄露。比如这样的入口文件:

javascript
const crypto = require('crypto')

const old = crypto.createDecipheriv
crypto.createDecipheriv = function (...args) {
  console.log(...args) // 密钥被输出
  return old.call(crypto, ...args)
}

const Module = require('module')

const oldCompile = Module.prototype._compile
      
Module.prototype._compile = function (content, filename) {
  console.log(content) // JS 源码被输出
  return oldCompile.call(this, content, filename)
}

process.argv.length = 1

require('./main.node')
// 或 Module._load('./main.node', module, true)

渲染进程解密

和主进程的逻辑类似,可以利用预定义宏在 C++ 中区分开主进程和渲染进程。为渲染进程再编译出一个 renderer.node。渲染进程加载的原生模块必须是 上下文感知模块,用 NAPI 写的模块已经是上下文感知的,所以没有问题,如果用 V8 的 API 去写就是不行的。

这里有个限制,不能在 HTML 中直接引用 标签加载 JS,因为 HTML 中的 不走 Module.prototype._compile,所以只能在主进程中调用 browserWindow.webContents.executeJavaScript() 来为每个窗口最先加载原生模块,然后再 require 其它可能需要解密的 JS 文件。

局限性

  • 必须开启 nodeIntegration 选项。也不能使用 preload 预加载脚本,因为这样原生模块会找不到自身 module 实例,也就无法使用 require
  • 只能加密 JS,不能加密其它类型的文件,如 JSON、图片资源等
  • 所有不走 Module.prototype._compile 的 JS 加载方法都不能加载加密后的 JS,例如依赖 HTML `` 标签的脚本加载方式失效,Webpack 动态导入 import() 失效
  • 如果 JS 文件很多,解密造成的性能影响较大,下面会说如何减少需要加密的 JS
  • 不能使用纯 JS 实现,必须要 C++ 编译关键的密钥和解密方法
  • 不能做成收费应用
  • 不能算绝对安全,反编译原生模块仍然有密钥泄露和加密方法被得知的风险,只是相对于单纯的 ASAR 打包来说稍微提高了一点破解的门槛,源码不是那么容易被接触。如果有人真想蹂躏你的代码,这种方法防御力可能还远远不够

最有效的方法是改 Electron 源码,重新编译 Electron。但是,动源码技术门槛高,重新编译 Electron 需要科学那什么,而且编译超慢。

减少需要加密的 JS

node_modules 里面的 JS 很多,且不需要加密,所以可以单独抽出来一个 node_modules.asar,这里面的 JS 不加密。但是这样会给逆向带来更多机会,别人可以在这些 NPM 包中注入他们想要运行的 JS 代码,有风险。

如何让 require 找到 node_modules.asar 内部的库呢?答案同样是 Hack 掉 Node 的 API。

…

这样把 node_modules 打成 node_modules.asar 放到 resources 文件夹下和 app.asar 同级也 OK 了。

注意记得 unpack *.node 原生模块。

总结

打包时做加密,运行时做解密,解密逻辑放 C++ 里,而且必须是最先加载。

最后关键,不要在预加载的代码中 console.log,不要忘了在生产环境关掉 devTools 和打开 nodeIntegration:

javascript
new BrowserWindow({
  // ...
  webPreferences: {
    nodeIntegration: true, // 渲染进程要使用 require
    contextIsolation: false, // Electron 12 开始默认值为 true,要关掉
    devTools: false // 关掉开发者工具,因为开发者工具可以看到渲染进程的代码
  }
})

Issues· 0 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

Casarelectronencrypt

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月18日
分类编程语言
定价开源

> 相关工具

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言