在Ubuntu服务器上部署Excalidraw项目的完整指南

Excalidraw是一款开源的虚拟白板工具，允许用户创建手绘风格的图表。本文将详细介绍如何在Ubuntu服务器上部署和运行Excalidraw项目。

环境准备

在开始之前，请确保你的Ubuntu服务器已安装以下必备组件：

1. Node.js (建议版本16.x或更高)
2. Yarn包管理器
3. Git版本控制系统

部署步骤

1. 克隆项目代码

首先需要将Excalidraw项目代码克隆到本地服务器：

git clone https://github.com/excalidraw/excalidraw.git
cd excalidraw

2. 安装项目依赖

使用Yarn安装项目所需的所有依赖包：

yarn install

这一步会根据项目中的package.json文件自动下载并安装所有必要的JavaScript库和工具。

3. 构建项目

在开发或生产环境中运行前，需要先构建项目：

yarn build

构建过程会将源代码编译、优化并打包成浏览器可执行的格式。构建完成后，会在项目目录中生成dist等输出文件夹。

4. 启动服务

构建完成后，可以通过以下命令启动Excalidraw服务：

yarn start

默认情况下，服务会启动在3000端口。你可以通过服务器的IP地址和端口号在浏览器中访问应用。

高级配置

自定义端口

如果需要修改默认端口，可以在启动命令中添加PORT环境变量：

PORT=8080 yarn start

生产环境部署

对于生产环境，建议：

1. 使用PM2等进程管理器保持服务稳定运行
2. 配置Nginx或Apache作为反向代理
3. 设置HTTPS加密连接
4. 配置适当的防火墙规则

系统服务配置

可以将Excalidraw配置为系统服务，实现开机自启：

sudo nano /etc/systemd/system/excalidraw.service

添加以下内容：

[Unit]
Description=Excalidraw Service
After=network.target

[Service]
User=your_user
WorkingDirectory=/path/to/excalidraw
ExecStart=/usr/bin/yarn start
Restart=always

[Install]
WantedBy=multi-user.target

然后启用并启动服务：

sudo systemctl enable excalidraw
sudo systemctl start excalidraw

常见问题解决

1. 依赖安装失败：检查Node.js和Yarn版本是否符合要求，尝试清除缓存后重新安装
2. 端口冲突：确认3000端口未被占用，或修改启动端口
3. 构建错误：检查系统内存是否充足，Node.js版本是否兼容

通过以上步骤，你应该能够在Ubuntu服务器上成功部署Excalidraw项目，并根据需要调整配置以满足不同环境的需求。