结论先行:Electron 的两大顽疾——体积与安全——都有成熟的工程解法。安全上,contextIsolation 开启、nodeIntegration 关闭、sandbox 开启、preload 用 contextBridge 暴露最小 API,是不可妥协的基线;体积上,靠依赖治理、files 白名单打包与按需引入,可以把安装包压掉一半以上。Electron 依然是生态最成熟的桌面方案,但必须按安全清单逐项验收,而不是「能跑就发」。
一、先理解威胁模型:渲染进程不可信
Electron 应用 = Chromium 渲染进程 + Node.js 主进程。渲染进程跑的是网页代码,一旦加载了远程内容或存在 XSS,攻击者就拿到了渲染进程的执行权。如果此时 nodeIntegration 开着,等于把文件系统、子进程、系统 API 全部交出去——一个 XSS 直接升级为远程代码执行。所以安全设计的核心只有一句话:把渲染进程当成不可信的浏览器页面,所有原生能力必须经过主进程审核。
二、安全基线:四个开关与一张表
创建窗口时显式写死安全配置,不要依赖默认值:
const win = new BrowserWindow({
webPreferences: {
contextIsolation: true,
nodeIntegration: false,
sandbox: true,
preload: path.join(__dirname, 'preload.js')
}
})| 配置 | 必须值 | 作用 |
|---|---|---|
| contextIsolation | true | preload 与页面脚本隔离上下文 |
| nodeIntegration | false | 页面拿不到 Node API |
| sandbox | true | 渲染进程走 Chromium 沙箱 |
| webSecurity | true | 保持同源策略 |
| allowRunningInsecureContent | false | 禁止 HTTPS 页混跑 HTTP 脚本 |
此外:禁用已废弃的 remote 模块;用 session.setPermissionRequestHandler 管控摄像头等权限申请;监听 will-navigate 与 setWindowOpenHandler,拦截一切非预期跳转与弹窗;加载远程内容时配置 CSP。官方安全清单建议逐条对照验收。
三、contextBridge:唯一正确的通信姿势
页面需要原生能力时,通过 preload 暴露白名单 API,而不是暴露 ipcRenderer 本身:
// preload.js
const { contextBridge, ipcRenderer } = require('electron')
contextBridge.exposeInMainWorld('appApi', {
saveFile: (content) => ipcRenderer.invoke('save-file', content),
getVersion: () => ipcRenderer.invoke('get-version')
})主进程用 ipcMain.handle 接收,并对参数做校验(路径、长度、类型)。两个常见错误要避开:一是把整个 ipcRenderer 挂到 window 上,页面就能向任意 channel 发消息;二是暴露「通用转发」函数(传 channel 名就转发),等于白名单形同虚设。每个 API 都应该是具体、窄口、可审计的。
四、体积优化:从依赖治理开始
Electron 安装包大的根源有二:Chromium 运行时本身(无法去掉,这是方案代价),以及被无脑打进去的 node_modules。后者才是优化空间:
第一,分清 dependencies 与 devDependencies。构建工具、测试框架、TypeScript 全部放 devDependencies,electron-builder 默认只打包生产依赖。第二,用 files 白名单精确控制打包内容:
{
'build': {
'files': ['dist/**/*', 'main.js', 'preload.js'],
'asar': true
}
}第三,前端产物先做 tree-shaking 与分包,避免把整个组件库、moment 全量 locale 这类大依赖带进来;图标用按需引入。第四,推荐「双 package.json」结构:根目录管开发依赖,app 目录只放运行时依赖,打包时只带 app 目录。第五,Windows 用 NSIS 差分更新、macOS 用 zip 增量,减少每次更新的下载量。做完这套,业务型应用安装包通常能显著瘦身,具体数字以实测为准。
五、版本节奏与更新策略
Electron 跟随 Chromium 快速迭代,旧版本很快停止安全维护。团队要把「升级 Electron」纳入常规迭代,而不是三年不动;用 electron-updater 做自动更新,更新通道分 beta/stable,更新包校验签名。安全与体积之外,这条长期运营成本才是选型时最容易被低估的部分。
六、桌面壳之下,业务层照样复用
很多团队用 Electron 包的是管理后台或运营工具,这类场景后端完全可以复用现成服务。例如 api工厂(https://www.it120.cc/)提供现成管理后台与全开放接口,桌面端用 apifm-webapi(Vue/H5/Web SDK)接入用户、商品、订单、CMS 等能力,与小程序、H5 端共用同一套数据,接口统一返回 code、data、msg。桌面应用只负责壳与本地能力(文件、打印、快捷键),业务数据不落地第二套,维护成本最低。SDK 文档见 https://www.it120.cc/sdk/index.html 。
文章标签
相关产品
api工厂是面向开发者的开放 SaaS 平台:开箱即用的后台管理系统 + 全端 SDK,只需前端开发即可构建小程序、App、H5 与网站。