LabelingSystem/DEPLOYMENT.md

部署指南

快速开始

Windows 开发环境（构建）

build.bat

执行后会：

1. 构建前端项目
2. 打包为 lq_label_dist.tar.gz
3. 提交到 Git

Linux 服务器（部署）

chmod +x deploy.sh
./deploy.sh

执行后会：

1. 拉取最新代码
2. Docker 部署后端
3. 解压前端到 Nginx 目录
4. 重载 Nginx

部署流程

┌─────────────────┐     ┌─────────────────┐
│  Windows 开发机  │     │   Linux 服务器   │
├─────────────────┤     ├─────────────────┤
│  1. build.bat   │     │  1. git pull    │
│  2. git push    │ ──► │  2. deploy.sh   │
└─────────────────┘     └─────────────────┘

配置说明

1. 修改部署目录

编辑 deploy.sh 顶部的配置：

FRONTEND_DEPLOY_DIR="/var/www/lq_label"  # 前端目录
GIT_BRANCH="main"                         # Git 分支

2. 后端配置

首次部署前，编辑 backend/config.yaml：

jwt:
  secret_key: "生成一个安全的密钥"

database:
  type: "mysql"
  mysql:
    host: "数据库地址"
    port: 3306
    user: "用户名"
    password: "密码"
    database: "数据库名"

3. Nginx 配置

将 web/apps/lq_label/nginx.conf 复制到 Nginx 配置目录：

sudo cp web/apps/lq_label/nginx.conf /etc/nginx/sites-available/lq_label
sudo ln -s /etc/nginx/sites-available/lq_label /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

常用命令

操作	命令
查看后端日志	cd backend && docker compose logs -f
重启后端	cd backend && docker compose restart
停止后端	cd backend && docker compose down
重新部署	./deploy.sh

故障排查

后端启动失败

cd backend
docker compose logs

前端 404

检查 Nginx 配置中的 root 路径是否正确。

数据库连接失败

检查 backend/config.yaml 中的数据库配置。