excalicloudstore 使用说明

Sat, 27 Sep 2025 22:55:35 +0800

由博主开发的docker镜像，现已发布在dokcer hub上 grayfalcon/excalicloudstore 通过 Docker 单机部署 和 Docker Compose 部署 两种方式，快速使用 grayfalcon/excalicloudstore 镜像（基于 Excalidraw 开发，支持 S3 兼容存储的云端绘图工具）。

一、前提条件

在开始部署前，请确保您的环境已满足以下要求：

安装 Docker Engine（参考：Docker 官方安装文档）
- Linux 系统：需确保 Docker 服务已启动（systemctl start docker）
- Windows/macOS 系统：安装 Docker Desktop 并启动
（可选）安装 Docker Compose（若使用 Compose 部署，参考：Docker Compose 安装文档）
准备好 S3 兼容存储配置（如 AWS S3、七牛云 Kodo、阿里云 OSS 等），需包含：
- 访问密钥（Access Key ID）
- 秘密密钥（Secret Access Key）
- 存储区域（Region）
- 终端节点（Endpoint）
- 存储桶名称（Bucket Name）

二、方式一：Docker 单机部署

适合快速启动单个容器，步骤简单，适合测试或小型场景。

1. 核心部署命令

将以下命令中的 占位符（如 your_access_key_here） 替换为您的实际配置，直接在终端执行：

bash

 1# Linux/macOS 系统（续行符为 \）
 2docker run -d \
 3  -p 8080:80 \  # 宿主机端口:容器内端口（容器内默认80，可修改宿主机端口如 80:80）
 4  --name excalicloudstore \  # 容器名称（可自定义）
 5  --restart unless-stopped \  # 容器意外退出时自动重启
 6  -e PORT=3001 \  # 后端服务端口（容器内固定，无需修改）
 7  -e NODE_ENV=production \  # 环境类型（production 生产环境，development 开发环境）
 8  -e AWS_ACCESS_KEY_ID=your_access_key_here \  # 替换为 S3 访问密钥
 9  -e AWS_SECRET_ACCESS_KEY=your_secret_key_here \  # 替换为 S3 秘密密钥
10  -e S3_REGION=your_s3_region_here \  # 替换为 S3 区域（如 cn-east-1、us-east-1）
11  -e S3_ENDPOINT=your_s3_endpoint_here \  # 替换为 S3 终端节点
12  -e S3_BUCKET=your_s3_bucket_name_here \  # 替换为 S3 存储桶名称
13  -e STORAGE_PATH_PREFIX=Excalidraw/web_canvas/ \  # S3 存储路径前缀（可自定义，如无需求保持默认）
14  -e S3_FORCE_PATH_STYLE=true \  # 强制使用路径风格访问 S3（兼容多数存储服务）
15  -e S3_TLS=false \  # 是否启用 TLS（true 为 HTTPS，false 为 HTTP，根据 S3 配置选择）
16  grayfalcon/excalicloudstore:latest  # 镜像名称（:latest 为最新版本，可指定具体版本如 :v1）

powershell

远程测试 on Jamaisvu's blog

excalicloudstore 使用说明

一、前提条件

二、方式一：Docker 单机部署

1. 核心部署命令