源码部署指南

试用版License

本文档提供详细的源码部署步骤，帮助您快速部署和运行项目。

系统要求

操作系统：Ubuntu 22.04 LTS
硬件配置：标准部署：2核4G内存

1. 获取源代码

首先，从代码仓库克隆项目源代码到本地：

# 使用GitHub源
git clone https://github.com/bytedesk/bytedesk.git

# 进入项目目录
cd bytedesk

2. 环境准备

2.1 安装JDK 17

项目基于Spring Boot 3开发，必须使用JDK 17或更高版本：

# 检查Java版本
java --version
# 应显示: java 17.x.x 或更高版本

如果没有安装JDK 17，请参考：JDK 17安装指南

2.2 安装项目依赖

# 1. 进入项目资源目录
cd bytedesk/starter/src/main/resources

# 2. 使用docker-compose启动依赖服务
docker compose -p bytedesk -f compose.yaml up -d
# docker compose -p bytedesk -f compose.yaml down

或参考手动项目依赖

3. 编译与启动

3.1 安装开发工具

推荐的开发环境：

编辑器：Visual Studio Code
构建工具：Maven 3.6+
其他依赖：protobuf 编译工具（项目使用了protobuf）

# 检查Maven版本
mvn --version
# 应显示 Apache Maven 3.6+ 版本

# 检查protobuf版本（如果已安装）
protoc --version
# 建议使用 libprotoc 25.0+

3.2 编译项目

# 进入项目根目录
cd bytedesk

# 在项目根目录下执行编译（跳过测试以加快速度）
./mvnw install -Dmaven.test.skip=true

3.3 修改配置文件

编辑starter/src/main/resources/application-dev.properties文件，配置数据库和Redis连接信息：请参考应用配置说明。如果不使用ai，可以参考：application-noai.properties 配置

3.4 启动项目

# 进入启动模块目录
cd starter

# 启动应用
./mvnw spring-boot:run

🚀 启动成功标志：控制台输出"Started Application"且无异常信息。

4. 访问系统

4.1 本地访问

启动成功后，可通过以下方式访问系统：

访问地址：http://127.0.0.1:9003/
默认账号：admin@email.com
默认密码：admin

⚠️ 注意：如在服务器部署，请将127.0.0.1替换为服务器实际IP地址。

4.2 端口说明

系统使用的端口：

9003：Web管理后台和API接口
9885：WebSocket通信服务端口

请确保防火墙已开放这些端口。

5. 域名配置

对于生产环境，建议配置域名访问和HTTPS：

安装配置Nginx：参考Nginx配置指南
配置SSL证书：建议使用Let's Encrypt免费证书

常见问题

部署过程中遇到问题？请查看：常见问题解答

如需技术支持，请通过以下方式联系我们：

📧 邮箱：270580156@qq.com
💬 社区：技术社区

1. 获取源代码​

2. 环境准备​

2.1 安装JDK 17​

2.2 安装项目依赖​

3. 编译与启动​

3.1 安装开发工具​

3.2 编译项目​

3.3 修改配置文件​

3.4 启动项目​

4. 访问系统​

4.1 本地访问​

4.2 端口说明​

5. 域名配置​

常见问题​