pmoscode/excalidraw Docker 镜像 - 轩辕镜像

Excalidraw Docker 镜像文档

镜像概述和主要用途

本Docker镜像用于在容器环境中运行Excalidraw——一款开源手绘风格图表和草图工具。其核心价值在于允许自定义工具中原先硬编码的协作服务器URL（默认值为[***]），提供即用型容器配置，简化部署流程，适用于协作工作流、开发测试及自托管场景。

核心功能和特性

• 自定义协作服务器URL：通过环境变量替换硬编码的协作服务器地址，无需修改源码即可适配私有或第三方协作服务。
• 容器化便捷部署：支持在各类容器环境（如Docker、Kubernetes）中快速启动，降低部署复杂度。
• 完整功能保留：继承Excalidraw全部原生功能，包括手绘风格绘图、实时协作（需正确配置协作服务器）、多格式文件导出等。

使用场景和适用范围

• 协作工作流：团队需使用指定协作服务器进行图表共同编辑时，通过自定义URL实现服务对接。
• 开发测试：开发人员测试不同协作服务器配置或验证私有协作服务兼容性。
• 自托管部署：企业或个人将Excalidraw部署在私有环境时，对接内部协作服务器以保障数据隐私。

使用方法和配置说明

基本运行

无需自定义协作服务器时，直接启动容器即可（实际镜像名称需替换为具体标签）：

bash
docker run -d -p 80:80 excalidraw-image

访问http://localhost即可使用Excalidraw，默认连接官方协作服务器。

自定义协作服务器URL

通过设置环境变量APP_WS_NEW_SERVER_URL指定自定义协作服务器地址：

bash
docker run -d -p 80:80 -e APP_WS_NEW_SERVER_URL="[***]" excalidraw-image

此时工具将连接至[***]进行协作。

环境变量说明