跳到主要内容

Jar包部署指南

本文档提供详细的Jar包部署步骤，帮助您快速部署和运行微语系统。相比源码部署，Jar包部署更加简便，适合快速上线和测试使用。

系统要求
  • 操作系统：Ubuntu 24.04 LTS
  • 硬件配置：推荐4核8G内存
  • 软件环境：JDK 17+、MySQL 8.0+、Redis Stack Server

1. 环境准备​

1.1 安装JDK 17​

微语系统基于Spring Boot 3开发，必须使用JDK 17或更高版本：

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

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

1.2 安装项目依赖​

您可以选择以下两种方式之一安装项目依赖：

方式一：使用Docker安装（推荐 ⭐）​

Docker方式可以快速启动所有依赖服务，非常适合开发和测试环境：部署Docker

# 1. 确保Docker服务已启动
sudo systemctl status docker  # 检查Docker状态
sudo systemctl start docker   # 如需启动Docker服务

# 2. 需要提前Clone或下载项目：https://gitee.com/270580156/weiyu，在项目根目录下进入配置目录
cd starter/src/main/resources

# 3. 一键启动所有依赖服务
docker compose -p bytedesk -f compose.yaml up -d

# 查看容器运行状态
docker ps | grep bytedesk

# 如需停止服务
# docker compose -p bytedesk -f compose.yaml down

或者

# 1 打开 https://gitee.com/270580156/weiyu/blob/main/deploy/docker/docker-compose-middleware.yaml 

# 2 复制内容到本地，保存为 docker-compose.yaml

# 3 直接运行下面命令启动
docker compose -p bytedesk -f docker-compose.yaml up -d

💡 提示：使用Docker方式，无需手动安装每个依赖，容器会自动配置好网络和初始设置。

方式二：手动安装各个依赖​

如果您需要更精细地控制每个组件，可以选择手动安装：

  1. MySQL 8.0：数据库服务
  2. Redis：缓存服务
  3. Ollama：AI大模型服务
  4. Elasticsearch：全文检索和向量存储检索
  5. Artemis：消息队列服务

⚠️ 注意：有的同学会找数据库.sql文件，这里不需要，只需要修改配置文件连接上数据库，系统会自动生成表。

2. 下载与解压​

2.1 下载服务端文件​

从官方网站下载最新版微语系统服务端软件包：

# 使用wget下载
wget https://www.weiyuai.cn/download/weiyu-server.zip

# 或直接在浏览器中访问下载链接
# https://www.weiyuai.cn/download/weiyu-server.zip

💡 提示：访问下载中心获取最新版本。

2.2 解压文件​

# 解压下载的zip文件
unzip weiyu-server.zip

# 进入解压后的目录
cd weiyu-server

# 查看目录结构
ls -la

3. 配置系统​

3.1 修改配置文件​

编辑config/application.properties文件，配置数据库和Redis连接信息：请参考应用配置说明

# 编辑配置文件
nano config/application.properties

3.2 检查文件权限​

确保启动脚本有执行权限：

# 赋予启动脚本执行权限
chmod +x start.sh
chmod +x stop.sh

4. 启动与停止​

4.1 启动系统​

# 在Linux/macOS上启动
./start.sh

# 在Windows上启动
start.bat

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

4.2 验证启动状态​

# 检查9003端口是否正常监听
netstat -ntlp | grep 9003

# 查看运行日志
tail -f logs/bytedeskim.log

4.3 停止系统​

# 在Linux/macOS上停止
./stop.sh

# 在Windows上停止
stop.bat

5. 系统访问​

5.1 本地访问​

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

5.2 端口说明​

系统使用的端口：

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

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

6. 域名配置（生产环境）​

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

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

常见问题​

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

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

编辑此页

这页文档对您有帮助吗？