From 879247c8e9c605ed66f49cac52add381c681285e Mon Sep 17 00:00:00 2001 From: yuliang_guo Date: Tue, 3 Feb 2026 14:11:09 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=B7=BB=E5=8A=A0MinIO=E5=AF=B9?= =?UTF-8?q?=E8=B1=A1=E5=AD=98=E5=82=A8=E9=85=8D=E7=BD=AE=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Cursor --- docs/测试环境配置.md | 100 ++++++++++++++++++++++++++++++++++++++++--- 1 file changed, 94 insertions(+), 6 deletions(-) diff --git a/docs/测试环境配置.md b/docs/测试环境配置.md index 753da08..864b5de 100644 --- a/docs/测试环境配置.md +++ b/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 # 查看远程仓库