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

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

2025-04-29 13:09:33作者:龚格成

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项目,并根据需要调整配置以满足不同环境的需求。

登录后查看全文
热门项目推荐
相关项目推荐