1. 项目背景与核心需求
最近在团队协作时遇到一个痛点:我们需要频繁使用Excalidraw这款在线白板工具进行头脑风暴和架构设计,但遇到两个现实问题:一是会议室网络不稳定经常断线,二是内网环境无法访问外网服务。这促使我研究如何实现Excalidraw的完全离线使用方案——不仅能在本机localhost运行,还要支持局域网内其他设备访问。
Excalidraw作为一款开源的虚拟手绘风格白板工具,其核心优势在于简洁的交互和可协作性。官方提供的在线服务(excalidraw.com)虽然方便,但企业环境下往往需要私有化部署。通过本文,你将掌握三种不同级别的离线部署方案,从单机版到团队共享版,满足不同场景需求。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 技术方案选型分析
2.1 官方提供的自托管方案
Excalidraw官方仓库明确支持自托管,其代码库包含完整的前端实现。核心文件是静态HTML+JavaScript构建的SPA应用,这意味着我们不需要后端服务即可运行。但官方文档对局域网访问的场景说明有限,需要额外配置。
关键技术点:
- 纯前端架构(React+TypeScript)
- 使用IndexedDB进行本地存储
- WebSocket实现实时协作(需额外服务端支持)
2.2 第三方打包方案
社区已有开发者制作了多种离线包,包括:
- 桌面应用版(Electron打包)
- Docker容器版
- 单HTML文件便携版
经过实测,推荐使用Docker方案,因其兼具易用性和跨平台特性。例如linuxserver/excalidraw镜像已预配置好所有依赖,支持一键部署。
3. 本地离线部署实战
3.1 基础单机版部署
方案一:直接克隆官方仓库
bash复制git clone https://github.com/excalidraw/excalidraw.git
cd excalidraw
npm install
npm run start
此时访问http://localhost:3000即可使用,但此方式:
- 需要Node.js环境
- 默认仅限localhost访问
- 修改配置需重新build
方案二:使用预构建的静态文件
- 从Release页面下载最新build.zip
- 解压后直接双击index.html运行
- 或通过python快速启动HTTP服务:
bash复制python -m http.server 8000
3.2 局域网共享配置关键
要使其他设备能访问,需解决两个问题:
1. 主机IP绑定
修改webpack配置(或使用nginx):
nginx复制server {
listen 0.0.0.0:80;
server_name localhost;
location / {
root /path/to/excalidraw;
index index.html;
}
}
2. 防火墙规则
- Windows:允许入站端口规则
- macOS:系统偏好设置→安全与隐私→防火墙选项
- Linux:
sudo ufw allow 8000/tcp
重要提示:局域网版请务必设置密码或限制IP访问,否则可能被恶意使用
4. 高级部署方案
4.1 Docker容器化部署
推荐使用官方兼容镜像:
bash复制docker run -d \
-p 8000:80 \
-v /path/to/storage:/app/data \
--name excalidraw \
excalidraw/excalidraw:latest
优势:
- 内置nginx配置
- 自动处理CORS等问题
- 支持持久化存储
4.2 浏览器插件方案
对于临时需求,可安装PWA版本:
- Chrome访问https://excalidraw.com
- 点击地址栏"安装"图标
- 离线时从启动器打开
虽然功能完整,但无法实现局域网共享。
5. 协作功能实现技巧
离线环境下实现多人协作需要额外服务端支持:
5.1 自建协作服务器
使用官方提供的excalidraw-room服务:
bash复制git clone https://github.com/excalidraw/excalidraw-room.git
cd excalidraw-room
npm install
EXCALIDRAW_ROOM_BACKEND_ORIGIN=http://your-ip:3002 npm start
5.2 替代方案:文件共享协作
- 主机创建绘图后导出.excalidraw文件
- 通过局域网共享文件(SMB/WebDAV)
- 其他成员导入继续编辑
- 最后合并版本
虽然效率较低,但完全无需额外服务。
6. 常见问题排查指南
|
