# ETest-LIMS 阿里云部署完整教程

## 📋 部署前准备

### 1. 阿里云服务器要求

| 配置项 | 最低要求 | 推荐配置 |
|--------|----------|----------|
| CPU | 2核 | 4核 |
| 内存 | 4GB | 8GB |
| 磁盘 | 50GB | 100GB SSD |
| 带宽 | 1Mbps | 5Mbps |
| 系统 | CentOS 7/8 或 Ubuntu 20.04+ | Ubuntu 22.04 LTS |

### 2. 需要开放的端口

在阿里云控制台 → 安全组 → 配置规则，添加以下入方向规则：

| 端口 | 协议 | 授权对象 | 说明 |
|------|------|----------|------|
| 22 | TCP | 你的IP | SSH远程连接 |
| 80 | TCP | 0.0.0.0/0 | HTTP访问（前端） |
| 9099 | TCP | 0.0.0.0/0 | API接口（后端） |
| 443 | TCP | 0.0.0.0/0 | HTTPS（可选） |

> ⚠️ **注意**：3306(MySQL) 和 6379(Redis) 建议不对外开放，仅供内网访问

---

## 🚀 部署方式选择

| 方式 | 适用场景 | 特点 |
|------|----------|------|
| **方式一：Docker Compose** | 快速部署、测试环境 | 一键部署，所有服务容器化 |
| **方式二：手动部署** | 生产环境、性能要求高 | 前端用系统 Nginx，性能更好 |

---

## 🚀 方式一：Docker Compose 部署（推荐用于测试）

所有服务（前端、后端、MySQL、Redis）都运行在 Docker 容器中。

### 步骤 1：连接服务器

```bash
# Windows 使用 PowerShell 或 Git Bash
ssh root@<你的服务器IP>

# 示例
ssh root@123.57.81.127
```

### 步骤 2：安装 Docker 和 Docker Compose

```bash
# 一键安装脚本
curl -fsSL https://get.docker.com | bash

# 启动 Docker
systemctl start docker
systemctl enable docker

# 安装 Docker Compose
DOCKER_COMPOSE_VERSION=$(curl -s https://api.github.com/repos/docker/compose/releases/latest | grep 'tag_name' | cut -d\" -f4)
curl -L "https://github.com/docker/compose/releases/download/${DOCKER_COMPOSE_VERSION}/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose

# 验证安装
docker --version
docker-compose --version
```

### 步骤 3：上传项目代码

**方式 A：使用 scp 命令上传（推荐）**

```bash
# 在本地电脑执行（Windows PowerShell 或 Git Bash）
# 先进入项目目录
cd C:\PPRO\ETest-Vue-FastAPI

# 打包项目（排除 node_modules 和 venv）
tar -czvf etest-lims.tar.gz \
  --exclude='ruoyi-fastapi-frontend/node_modules' \
  --exclude='ruoyi-fastapi-backend/myenv' \
  --exclude='ruoyi-fastapi-backend/venv' \
  --exclude='.git' \
  .

# 上传到服务器
scp etest-lims.tar.gz root@<服务器IP>:/opt/

# 示例
scp etest-lims.tar.gz root@123.57.81.127:/opt/
```

**方式 B：使用 Git 克隆**

```bash
# 在服务器上执行
cd /opt
git clone <你的Git仓库地址> ETest-Vue-FastAPI
```

### 步骤 4：在服务器上解压并部署

```bash
# 连接服务器
ssh root@<服务器IP>

# 进入上传目录
cd /opt

# 解压项目
tar -xzvf etest-lims.tar.gz -C ETest-Vue-FastAPI/
cd ETest-Vue-FastAPI

# 查看文件确认
ls -la
```

### 步骤 5：修改前端 API 地址

```bash
# 编辑前端 Dockerfile，修改 API 地址为你的服务器IP
vim ruoyi-fastapi-frontend/Dockerfile
```

找到这行：
```dockerfile
ENV VITE_APP_BASE_API=http://localhost:9099/prod-api
```

改为你的服务器IP：
```dockerfile
ENV VITE_APP_BASE_API=http://123.57.81.127:9099/prod-api
```

> 💡 **提示**：如果你配置了域名，也可以写域名，如 `http://etest.yourdomain.com/prod-api`

### 步骤 6：执行部署

```bash
# 给脚本执行权限
chmod +x deploy-aliyun.sh

# 执行部署
./deploy-aliyun.sh
```

部署过程大约需要 5-10 分钟，取决于服务器配置和网络速度。

### 步骤 7：验证部署

```bash
# 查看所有容器状态
docker-compose -f docker-compose-aliyun.yml ps

# 查看日志
docker-compose -f docker-compose-aliyun.yml logs -f

# 只查看后端日志
docker-compose -f docker-compose-aliyun.yml logs -f backend
```

### 步骤 8：访问系统

在浏览器中访问：
- 前端页面：`http://<服务器IP>`
- API文档：`http://<服务器IP>:9099/docs`
- 后端接口：`http://<服务器IP>:9099/prod-api`

默认账号密码：
- 用户名：`admin`
- 密码：`admin123`

---

## 🔧 方式二：手动部署（更灵活）

如果你需要更多控制，可以手动执行每一步：

### 1. 安装 Docker

```bash
# Ubuntu/Debian
apt-get update
apt-get install -y docker.io docker-compose

# CentOS/RHEL
yum install -y docker docker-compose
systemctl start docker
systemctl enable docker
```

### 2. 创建项目目录

```bash
mkdir -p /opt/ETest-Vue-FastAPI
cd /opt/ETest-Vue-FastAPI
```

### 3. 上传代码

使用 WinSCP、FileZilla 或 scp 上传项目文件到 `/opt/ETest-Vue-FastAPI`

### 4. 构建并启动

```bash
cd /opt/ETest-Vue-FastAPI

# 构建镜像
docker-compose -f docker-compose-aliyun.yml build

# 启动服务
docker-compose -f docker-compose-aliyun.yml up -d

# 查看状态
docker-compose -f docker-compose-aliyun.yml ps
```

---

## 🚀 方式三：手动部署（推荐用于生产）

前端使用系统 Nginx 部署（性能更好），后端使用 Docker 部署。

### 架构差异

| 组件 | Docker Compose 方式 | 手动部署方式 |
|------|---------------------|--------------|
| 前端 | Docker Nginx 容器 | 系统 Nginx |
| 后端 | Docker 容器 | Docker 容器 |
| MySQL | Docker 容器 | Docker 容器 |
| Redis | Docker 容器 | Docker 容器 |

### 部署步骤

#### 步骤 1：连接服务器并安装依赖

```bash
ssh root@<服务器IP>

# 安装 Nginx、Docker、Node.js
apt-get update
apt-get install -y nginx docker.io docker-compose nodejs npm

# 启动 Nginx
systemctl start nginx
systemctl enable nginx
```

#### 步骤 2：上传并解压项目

```bash
cd /opt
tar -xzvf etest-lims.tar.gz -C ETest-Vue-FastAPI/
cd ETest-Vue-FastAPI
```

#### 步骤 3：构建前端

```bash
cd ruoyi-fastapi-frontend

# 安装依赖
npm install

# 构建生产包
npm run build

# 创建 Nginx 目录并复制文件
mkdir -p /var/www/etest-lims
cp -r dist/* /var/www/etest-lims/

cd /opt/ETest-Vue-FastAPI
```

#### 步骤 4：配置 Nginx

```bash
# 复制 Nginx 配置
cp nginx-manual.conf /etc/nginx/sites-available/etest-lims

# 启用配置
ln -sf /etc/nginx/sites-available/etest-lims /etc/nginx/sites-enabled/
rm -f /etc/nginx/sites-enabled/default

# 测试配置
nginx -t

# 重启 Nginx
systemctl restart nginx
```

#### 步骤 5：启动后端（Docker）

```bash
# 只启动 MySQL、Redis、后端（不启动前端容器）
docker-compose -f docker-compose-aliyun.yml up -d mysql redis backend
```

#### 步骤 6：验证

```bash
# 检查 Nginx
curl http://localhost

# 检查后端
curl http://localhost:9099/docs

# 查看状态
docker-compose -f docker-compose-aliyun.yml ps
systemctl status nginx
```

### 更新前端（后续更新）

```bash
cd /opt/ETest-Vue-FastAPI/ruoyi-fastapi-frontend

# 拉取最新代码
git pull

# 重新构建
npm install
npm run build

# 复制到 Nginx 目录
cp -r dist/* /var/www/etest-lims/

# 重启 Nginx（可选）
systemctl reload nginx
```

---

## 📁 项目结构说明

```
ETest-Vue-FastAPI/
├── docker-compose-aliyun.yml    # 阿里云部署配置
├── deploy-aliyun.sh             # 部署脚本
├── DEPLOY-ALIYUN.md             # 部署文档
├── ruoyi-fastapi-backend/       # 后端代码
│   ├── Dockerfile               # 后端镜像配置
│   └── ...
├── ruoyi-fastapi-frontend/      # 前端代码
│   ├── Dockerfile               # 前端镜像配置
│   └── ...
└── sql/                         # 数据库脚本
    └── init/                    # 初始化脚本（可选）
```

---

## ⚙️ 常用运维命令

### 查看服务状态

```bash
cd /opt/ETest-Vue-FastAPI

# 查看所有容器
docker-compose -f docker-compose-aliyun.yml ps

# 查看资源占用
docker stats
```

### 查看日志

```bash
# 查看所有日志
docker-compose -f docker-compose-aliyun.yml logs -f

# 只看后端日志
docker-compose -f docker-compose-aliyun.yml logs -f backend

# 只看前端日志
docker-compose -f docker-compose-aliyun.yml logs -f frontend

# 只看 MySQL 日志
docker-compose -f docker-compose-aliyun.yml logs -f mysql

# 查看最近100行日志
docker-compose -f docker-compose-aliyun.yml logs --tail=100 backend
```

### 重启服务

```bash
# 重启所有服务
docker-compose -f docker-compose-aliyun.yml restart

# 重启单个服务
docker-compose -f docker-compose-aliyun.yml restart backend
docker-compose -f docker-compose-aliyun.yml restart frontend
```

### 停止服务

```bash
# 停止（保留数据）
docker-compose -f docker-compose-aliyun.yml down

# 停止并删除数据卷（⚠️ 会清空数据库）
docker-compose -f docker-compose-aliyun.yml down -v
```

### 进入容器内部

```bash
# 进入后端容器
docker-compose -f docker-compose-aliyun.yml exec backend bash

# 进入 MySQL 容器
docker-compose -f docker-compose-aliyun.yml exec mysql mysql -u root -p

# 进入 Redis 容器
docker-compose -f docker-compose-aliyun.yml exec redis redis-cli
```

### 更新部署

```bash
cd /opt/ETest-Vue-FastAPI

# 1. 拉取最新代码（如果用Git）
git pull

# 2. 停止旧服务
docker-compose -f docker-compose-aliyun.yml down

# 3. 重新构建
docker-compose -f docker-compose-aliyun.yml build --no-cache

# 4. 启动新服务
docker-compose -f docker-compose-aliyun.yml up -d

# 5. 验证
docker-compose -f docker-compose-aliyun.yml ps
```

---

## 🔒 安全配置建议

### 1. 修改默认密码

部署完成后，立即修改以下默认密码：

```bash
# 进入 MySQL 容器修改密码
docker-compose -f docker-compose-aliyun.yml exec mysql mysql -u root -p

# 在 MySQL 中执行
ALTER USER 'root'@'%' IDENTIFIED BY '你的新密码';
ALTER USER 'cpy_admin'@'%' IDENTIFIED BY '你的新密码';
FLUSH PRIVILEGES;
```

同时修改 `docker-compose-aliyun.yml` 中的环境变量。

### 2. 配置 HTTPS（推荐）

使用 Nginx 反向代理 + SSL 证书：

```bash
# 安装 Nginx
apt-get install -y nginx

# 配置 Nginx
cat > /etc/nginx/sites-available/etest << 'EOF'
server {
    listen 80;
    server_name etest.yourdomain.com;
    return 301 https://$server_name$request_uri;
}

server {
    listen 443 ssl;
    server_name etest.yourdomain.com;

    ssl_certificate /path/to/your/cert.pem;
    ssl_certificate_key /path/to/your/key.pem;

    location / {
        proxy_pass http://localhost:80;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }

    location /prod-api/ {
        proxy_pass http://localhost:9099/prod-api/;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}
EOF

# 启用配置
ln -s /etc/nginx/sites-available/etest /etc/nginx/sites-enabled/
nginx -t
systemctl restart nginx
```

### 3. 配置防火墙

```bash
# 安装并启用防火墙
apt-get install -y ufw
ufw default deny incoming
ufw default allow outgoing

# 允许必要端口
ufw allow 22/tcp    # SSH
ufw allow 80/tcp    # HTTP
ufw allow 443/tcp   # HTTPS
ufw allow 9099/tcp  # API

# 启用防火墙
ufw enable

# 查看状态
ufw status
```

---

## ❓ 常见问题

### Q1: 部署后无法访问

**检查步骤：**

```bash
# 1. 检查容器是否运行
docker-compose -f docker-compose-aliyun.yml ps

# 2. 检查端口监听
netstat -tlnp | grep -E '80|9099'

# 3. 检查安全组规则（阿里云控制台）
# 确保 80 和 9099 端口已开放

# 4. 检查防火墙
ufw status

# 5. 查看日志定位问题
docker-compose -f docker-compose-aliyun.yml logs
```

### Q2: 数据库连接失败

```bash
# 检查 MySQL 容器日志
docker-compose -f docker-compose-aliyun.yml logs mysql

# 进入 MySQL 容器检查
docker-compose -f docker-compose-aliyun.yml exec mysql mysql -u root -p -e "SHOW DATABASES;"
```

### Q3: 如何备份数据库

```bash
# 备份数据库
docker-compose -f docker-compose-aliyun.yml exec mysql mysqldump -u root -p ruoyi-fastapi > backup_$(date +%Y%m%d).sql

# 恢复数据库
docker-compose -f docker-compose-aliyun.yml exec -T mysql mysql -u root -p ruoyi-fastapi < backup_20260324.sql
```

### Q4: 如何修改端口

编辑 `docker-compose-aliyun.yml`，修改 ports 部分：

```yaml
services:
  frontend:
    ports:
      - "8080:80"    # 改为 8080 端口
  
  backend:
    ports:
      - "8081:9099"  # 改为 8081 端口
```

然后重启：
```bash
docker-compose -f docker-compose-aliyun.yml down
docker-compose -f docker-compose-aliyun.yml up -d
```

---

## 📞 需要帮助？

如果遇到问题：

1. 先查看日志：`docker-compose -f docker-compose-aliyun.yml logs -f`
2. 检查服务状态：`docker-compose -f docker-compose-aliyun.yml ps`
3. 确认安全组规则已正确配置
4. 检查服务器防火墙设置

---

**部署完成！🎉**