stelcheck/electron

Docker Electron 镜像文档

镜像概述

该Docker镜像专为运行和构建Electron应用设计，集成了运行Electron应用所需的全部依赖、轻量级桌面环境以及Wine组件。Wine组件支持通过electron-builder为Windows平台进行交叉编译构建。镜像未定义默认的EXEC或ENTRYPOINT，允许用户根据实际需求进行自定义配置。

核心功能和特性

• 完整依赖支持：包含运行Electron应用所需的所有依赖项
• 轻量级桌面环境：内置轻量级桌面环境，支持图形界面操作
• Wine集成：集成Wine组件，支持通过electron-builder为Windows平台生成交叉编译构建产物

使用场景

• Electron应用的开发与测试环境搭建
• Electron应用的跨平台构建（特别是Windows平台）
• 需要图形界面支持的Electron应用自动化测试

使用方法和配置说明

基本使用说明

由于镜像未定义默认的EXEC或ENTRYPOINT，用户需根据需求自定义启动命令。若需运行桌面环境，至少需执行以下步骤：

启动桌面环境示例

bash
# 启动视频帧缓冲
Xvfb :9.0 \
  +extension RANDR \
  -screen scrn 1024x768x24 \
  &
echo ">>>> Xvfb已启动，进程ID: ${!}"

# 启动openbox窗口管理器
sudo -u user -H bash -c "openbox-session" &> /dev/null &
echo ">>>> openbox-session已启动，进程ID: ${!}"

# 启动x11vnc（用于远程访问桌面）
x11vnc \
  -forever \
  &> /dev/null &
echo ">>>> x11vnc已启动，进程ID: ${!}"

# 启动wineserver
sudo -u user -H bash -c "wineserver -f -p" &> /dev/null &
echo ">>>> wineserver已启动，进程ID: ${!}"

# 启动Wine的services.exe
sudo -u user -H bash -c "wine 'C:\windows\system32\services.exe'" &> /dev/null &
echo ">>>> services.exe已启动，进程ID: ${!}"

自定义配置建议

• 根据应用需求调整Xvfb的屏幕分辨率（如修改1024x768x24为其他分辨率）
• 可通过VNC客户端连接x11vnc服务（默认端口5900）访问桌面环境
• 结合electron-builder时，需确保Wine环境正确配置，可通过wine --version验证Wine是否正常工作