






# 一、ExcaliDash介绍






## 1.1 ExcaliDash简介
>ExcaliDash 是一个自托管的 Excalidraw 仪表盘与组织工具，支持实时协作、持久化存储和便捷管理您的所有绘图。

## 1.2 ExcaliDash主要特点
- **持久化存储**：自动保存所有绘图，确保数据不会丢失。  
- **实时协作**：多人可同时编辑同一幅绘图，体验类似 Google Docs 的协同操作。  
- **绘图搜索功能**：快速通过关键词查找您保存的任意绘图。  
- **集合管理**：通过拖放将绘图归类到不同集合，轻松整理内容。  
- **导入/导出支持**：支持一键备份或迁移您的绘图与数据库，便于数据管理。

## 1.3 注意事项
- **仅限测试使用**：当前版本未达到生产级安全标准，切勿公开暴露服务端口。  
- **安全防护有限**：虽已实施基础防护（如 XSS 过滤、CORS、速率限制等），但缺少 CSRF 防护，存在潜在风险。  
- **需定期手动备份**：建议通过 cron 等工具定期备份数据，防止意外丢失。















# 二、本次实践规划
## 2.1 本地环境规划
>本次实践为个人测试环境，操作系统版本为 Ubuntu 24.04.2 LTS。


|hostname| IP地址  | 操作系统版本   |Docker版本   |部署项目|备注
|--|--| --|  --|--|--|
|jeven |192.168.3.88  | Ubuntu 24.04.2 LTS| 28.5.0   |ExcaliDash  |  ——


## 2.2 本次实践介绍
>1.本次实践部署环境为个人测试环境，生产环境请谨慎；
>2.在Docker环境下部署ExcaliDash个人仪表盘工具。





# 三、本地环境检查

## 3.1 检查Docker服务状态
>检查Docker服务是否正常运行，确保Docker正常运行。



```bash
root@jeven:~# systemctl status docker
● docker.service - Docker Application Container Engine
     Loaded: loaded (/usr/lib/systemd/system/docker.service; enabled; preset: enabled)
     Active: active (running) since Tue 2025-12-02 00:51:31 CST; 1min 11s ago
TriggeredBy: ● docker.socket
       Docs: https://docs.docker.com
   Main PID: 75393 (dockerd)
      Tasks: 32
     Memory: 34.1M (peak: 34.8M)
        CPU: 1.248s
     CGroup: /system.slice/docker.service
```
![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/abb255efc952dabcb17c36c31c1cd133.png)




## 3.2  检查Docker版本
>检查Docker版本

```bash
root@jeven:~# docker -v
Docker version 28.5.0, build 887030f
```


## 3.3 检查docker compose 版本
>检查Docker compose版本，确保2.0以上版本。


```bash
root@jeven:~# docker compose version
Docker Compose version v2.39.4

```


# 四、拉取ExcaliDash镜像



>下载ExcaliDash镜像，镜像名称为：`zimengxiong/excalidash-backend:latest`、`zimengxiong/excalidash-frontend:latest`。



```bash
docker pull zimengxiong/excalidash-backend:latest
```

```bash
docker pull zimengxiong/excalidash-frontend:latest
```







![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/efed2e9e660c537dd61c146e47c7fbdc.png)











# 五、部署ExcaliDash服务

## 5.1 创建部署目录
- 创建部署目录

```bash
mkdir -p /data/excalidash/data && cd  /data/excalidash
```



## 5.2 docker compose方式部署






>新建及编辑docker-compose.yaml文件，宿主机映射端口可自行设置，注意防止端口冲突。

```bash
vim docker-compose.yaml
```

```yaml
services:
  backend:
    image: zimengxiong/excalidash-backend:latest
    container_name: excalidash-backend
    restart: always
    volumes:
      - ./data:/app/prisma
    environment:
      - DATABASE_URL=file:/app/prisma/dev.db
      - PORT=8000
      - NODE_ENV=production
    healthcheck:
      test:
        [
          "CMD",
          "node",
          "-e",
          "require('http').get('http://localhost:8000/health', (r) => process.exit(r.statusCode === 200 ? 0 : 1))",
        ]
      interval: 30s
      timeout: 10s
      retries: 3

  frontend:
    image: zimengxiong/excalidash-frontend:latest
    container_name: excalidash-frontend
    restart: always
    ports:
      - "5600:80"
    environment:
      - VITE_API_URL=/api
    depends_on:
      - backend
    healthcheck:
      test:
        [
          "CMD",
          "wget",
          "--quiet",
          "--tries=1",
          "--spider",
          "http://localhost:80",
        ]
      interval: 30s
      timeout: 10s
      retries: 3


```



## 5.3 创建ExcaliDash容器

>执行以下命令，创建ExcaliDash容器。


```bash
docker compose up -d
```




![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/1f3b470c31c9a31370398e4026a8c88f.png)












## 5.4 查看ExcaliDash容器状态
>检查ExcaliDash容器运行状态，确保ExcaliDash容器正常启动。

```bash
root@jeven:/data/excalidash# docker compose ps
NAME                  IMAGE                                    COMMAND                   SERVICE    CREATED          STATUS        PORTS
excalidash-backend    zimengxiong/excalidash-backend:latest    "./docker-entrypoint…"   backend    31 seconds ago   Up 31 seconds (healthy)       8000/tcp
excalidash-frontend   zimengxiong/excalidash-frontend:latest   "/docker-entrypoint.…"   frontend   31 seconds ago   Up 31 seconds (health: starting)   0.0.0.0:5600->80/tcp, [::]:5600->80/tcp
```









## 5.5 检查ExcaliDash容器日志

>检查容器运行日志，确保ExcaliDash服务正常运行。




```bash
docker compose logs
```




![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/a621a8150b7be26064973b95db5a04f5.png)




# 六、访问ExcaliDash服务
## 6.1 访问ExcaliDash首页





>浏览器地址： `http://<个人的服务器IP>:5600`，访问ExcaliDash初始页。如果无法访问，请确保宿主机的防火墙已关闭或已放行相关端口，对于云服务器还需配置相应的安全组规则。



![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/71e200faf4a00e8c419843434fc1d981.png)
## 6.2 新建画板


- 点击“新建画板”即可开始自由绘图

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/4b02312bfafb210c2b777a26b9e309d0.png)

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/82a8c951c54574397f86896b1ce4b75f.png)



# 七、总结

>本次实践成功通过 Docker 部署了 ExcaliDash 绘图工具，验证了其基于容器化部署的便捷性与高效性。通过 docker compose 编排服务，快速完成了环境搭建与服务启动。ExcaliDash 提供了直观的绘图界面和基础协作功能，适合个人或小团队本地使用。需要注意的是，当前版本仍处于测试阶段，应避免在生产环境中公开暴露，并定期做好数据备份。

ExcaliDash 是一个自托管的 Excalidraw 仪表盘与组织工具，支持实时协作、持久化存储和便捷管理您的所有绘图。

ExcaliDash本地部署指南：Docker Compose配置与全功能实战

开发工具

运维

后端

ExcaliDash是一款自托管的Excalidraw仪表盘工具，支持实时协作、持久化存储和绘图管理。通过Docker快速部署，提供绘图搜索、集合管理、导入导出功能。当前版本仅限测试使用，需注意安全防护和定期备份。适合个人或小团队本地协作绘图，操作简单高效。

云服务器

数据备份

数据管理

代码解释

数据库

服务器

防火墙

容器

Docker

2026上云采购 | AI焕新·智启新局

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

ExcaliDash本地部署指南：Docker Compose配置与全功能实战-腾讯云开发者社区-腾讯云

ExcaliDash本地部署指南：Docker Compose配置与全功能实战

ExcaliDash本地部署指南：Docker Compose配置与全功能实战

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐