Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
100
docs/测试环境配置.md
100
docs/测试环境配置.md
@@ -1,6 +1,6 @@
|
|||||||
# 考培练系统 - 环境配置与部署指南
|
# 考培练系统 - 环境配置与部署指南
|
||||||
|
|
||||||
> 最后更新:2026-01-28
|
> 最后更新:2026-02-03
|
||||||
|
|
||||||
## 一、环境总览
|
## 一、环境总览
|
||||||
|
|
||||||
@@ -156,7 +156,94 @@ npm run build
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 六、容器管理
|
## 六、对象存储(MinIO)
|
||||||
|
|
||||||
|
> 2026-02-03 新增,用于统一管理所有租户的文件存储
|
||||||
|
|
||||||
|
### 6.1 服务信息
|
||||||
|
|
||||||
|
| 项目 | 值 |
|
||||||
|
|------|-----|
|
||||||
|
| **容器名** | kaopeilian-minio |
|
||||||
|
| **API端口** | 9000 |
|
||||||
|
| **管理界面端口** | 9001 |
|
||||||
|
| **数据目录** | /data/minio/data |
|
||||||
|
| **网络** | prod-network |
|
||||||
|
|
||||||
|
### 6.2 访问方式
|
||||||
|
|
||||||
|
- **管理界面**: http://120.79.247.16:9001
|
||||||
|
- **API端点**: http://kaopeilian-minio:9000(容器内)
|
||||||
|
- **用户名**: `kaopeilian_admin`
|
||||||
|
- **密码**: `KplMinio2026!@#`
|
||||||
|
|
||||||
|
### 6.3 Bucket列表
|
||||||
|
|
||||||
|
| Bucket名称 | 租户 | 说明 |
|
||||||
|
|-----------|------|------|
|
||||||
|
| kpl-ex | 恩喜成都总院 | 生产环境 |
|
||||||
|
| kpl-hua | 华尔倍丽 | 生产环境 |
|
||||||
|
| kpl-yy | 杨扬宠物 | 生产环境 |
|
||||||
|
| kpl-hl | 武汉禾丽 | 生产环境 |
|
||||||
|
| kpl-xy | 芯颜定制 | 生产环境 |
|
||||||
|
| kpl-fw | 飞沃 | 生产环境 |
|
||||||
|
| kpl-cxw | 崔曦文 | 生产环境 |
|
||||||
|
| kpl-demo | 演示环境 | 预生产 |
|
||||||
|
| kpl-kpl | KPL测试 | 测试环境 |
|
||||||
|
| kpl-peilian | 陪练项目 | 其他项目 |
|
||||||
|
|
||||||
|
### 6.4 后端配置
|
||||||
|
|
||||||
|
在 `.env` 或环境变量中设置:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# MinIO配置
|
||||||
|
MINIO_ENABLED=true
|
||||||
|
MINIO_ENDPOINT=kaopeilian-minio:9000
|
||||||
|
MINIO_ACCESS_KEY=kaopeilian_admin
|
||||||
|
MINIO_SECRET_KEY=KplMinio2026!@#
|
||||||
|
MINIO_SECURE=false
|
||||||
|
```
|
||||||
|
|
||||||
|
### 6.5 常用命令
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# SSH登录服务器后
|
||||||
|
|
||||||
|
# 查看MinIO状态
|
||||||
|
docker ps | grep minio
|
||||||
|
|
||||||
|
# 查看MinIO日志
|
||||||
|
docker logs kaopeilian-minio --tail 50
|
||||||
|
|
||||||
|
# 使用mc客户端操作
|
||||||
|
mc ls kpl/ # 列出所有bucket
|
||||||
|
mc ls kpl/kpl-ex/ # 列出ex租户文件
|
||||||
|
mc cp file.pdf kpl/kpl-ex/ # 上传文件
|
||||||
|
mc rm kpl/kpl-ex/file.pdf # 删除文件
|
||||||
|
```
|
||||||
|
|
||||||
|
### 6.6 架构说明
|
||||||
|
|
||||||
|
```
|
||||||
|
用户上传文件
|
||||||
|
↓
|
||||||
|
后端 storage_service
|
||||||
|
↓
|
||||||
|
MinIO对象存储(持久化)+ 本地缓存(加速预览)
|
||||||
|
↓
|
||||||
|
Nginx代理 → 用户下载
|
||||||
|
```
|
||||||
|
|
||||||
|
**特性**:
|
||||||
|
- 自动降级:MinIO不可用时自动使用本地存储
|
||||||
|
- URL兼容:保持 `/static/uploads/` 格式,前端无需改动
|
||||||
|
- 智能缓存:文件自动下载到本地缓存用于预览/分析
|
||||||
|
- 多租户隔离:每个租户独立Bucket
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 七、容器管理
|
||||||
|
|
||||||
### 当前运行容器统计
|
### 当前运行容器统计
|
||||||
|
|
||||||
@@ -166,8 +253,9 @@ npm run build
|
|||||||
| 后端容器 | 11 |
|
| 后端容器 | 11 |
|
||||||
| Redis | 10 |
|
| Redis | 10 |
|
||||||
| MySQL | 4 |
|
| MySQL | 4 |
|
||||||
|
| MinIO | 1 |
|
||||||
| Nginx | 1 |
|
| Nginx | 1 |
|
||||||
| **总计** | **37** |
|
| **总计** | **38** |
|
||||||
|
|
||||||
### 查看所有容器
|
### 查看所有容器
|
||||||
|
|
||||||
@@ -177,7 +265,7 @@ docker ps --format 'table {{.Names}}\t{{.Status}}'
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 七、测试账户
|
## 八、测试账户
|
||||||
|
|
||||||
| 角色 | 用户名 | 密码 |
|
| 角色 | 用户名 | 密码 |
|
||||||
|------|--------|------|
|
|------|--------|------|
|
||||||
@@ -187,7 +275,7 @@ docker ps --format 'table {{.Names}}\t{{.Status}}'
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 八、注意事项
|
## 九、注意事项
|
||||||
|
|
||||||
1. **前端共享**:所有生产租户共享同一套前端代码,编译一次全部更新
|
1. **前端共享**:所有生产租户共享同一套前端代码,编译一次全部更新
|
||||||
2. **后端独立**:每个租户有独立的后端容器和数据库
|
2. **后端独立**:每个租户有独立的后端容器和数据库
|
||||||
@@ -198,7 +286,7 @@ docker ps --format 'table {{.Names}}\t{{.Status}}'
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 九、Git 仓库配置
|
## 十、Git 仓库配置
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# 查看远程仓库
|
# 查看远程仓库
|
||||||
|
|||||||
Reference in New Issue
Block a user