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 |
|
||||
| Redis | 10 |
|
||||
| MySQL | 4 |
|
||||
| MinIO | 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. **前端共享**:所有生产租户共享同一套前端代码,编译一次全部更新
|
||||
2. **后端独立**:每个租户有独立的后端容器和数据库
|
||||
@@ -198,7 +286,7 @@ docker ps --format 'table {{.Names}}\t{{.Status}}'
|
||||
|
||||
---
|
||||
|
||||
## 九、Git 仓库配置
|
||||
## 十、Git 仓库配置
|
||||
|
||||
```bash
|
||||
# 查看远程仓库
|
||||
|
||||
Reference in New Issue
Block a user