feat(storage): integrate Alibaba Cloud OSS for file persistence - Add OSSAdapter and LocalAdapter with StorageFactory pattern - Integrate PKB module with OSS upload - Rename difyDocumentId to storageKey - Create 4 OSS buckets and development specification
This commit is contained in:
165
docs/01-平台基础层/02-存储服务/OSS账号与配置信息.md
Normal file
165
docs/01-平台基础层/02-存储服务/OSS账号与配置信息.md
Normal file
@@ -0,0 +1,165 @@
|
||||
# OSS 账号与配置信息
|
||||
|
||||
> **创建日期：** 2026-01-22
|
||||
> **状态：** 已配置
|
||||
> **⚠️ 安全提醒：** 本文档不包含敏感密钥，AccessKey Secret 请从安全渠道获取
|
||||
|
||||
---
|
||||
|
||||
## 1. RAM 服务账号
|
||||
|
||||
| 配置项 | 值 |
|
||||
|--------|-----|
|
||||
| **显示名称** | AI临床研究OSS服务账号 |
|
||||
| **登录名称** | `aiclinical-oss@1991407246109125.onaliyun.com` |
|
||||
| **AccessKey ID** | `LTAI5tBHkL39GjdLfcr77Y3f` |
|
||||
| **AccessKey Secret** | `********` （见 .env 文件或联系管理员） |
|
||||
| **安全手机** | 86-18611348738 |
|
||||
| **安全邮箱** | gofeng117@163.com |
|
||||
| **授权策略** | AliyunOSSFullAccess |
|
||||
|
||||
---
|
||||
|
||||
## 2. Bucket 配置清单
|
||||
|
||||
### 2.1 生产环境
|
||||
|
||||
| Bucket 名称 | 区域 | ACL | 加密 | 用途 |
|
||||
|-------------|------|-----|------|------|
|
||||
| `ai-clinical-data` | 华北2（北京） | 私有 | SSE-OSS (AES256) | 核心数据（文献、病历、报告） |
|
||||
| `ai-clinical-static` | 华北2（北京） | 公共读 | 无 | 静态资源（头像、Logo、RAG图片） |
|
||||
|
||||
### 2.2 开发环境
|
||||
|
||||
| Bucket 名称 | 区域 | ACL | 加密 | 用途 |
|
||||
|-------------|------|-----|------|------|
|
||||
| `ai-clinical-data-dev` | 华北2（北京） | 私有 | 无 | 开发测试核心数据 |
|
||||
| `ai-clinical-static-dev` | 华北2（北京） | 公共读 | 无 | 开发测试静态资源 |
|
||||
|
||||
---
|
||||
|
||||
## 3. CORS 配置（所有 Bucket 相同）
|
||||
|
||||
| 配置项 | 值 |
|
||||
|--------|-----|
|
||||
| 来源 (AllowedOrigin) | `*` |
|
||||
| 允许 Methods | GET, HEAD |
|
||||
| 允许 Headers | `*` |
|
||||
| 暴露 Headers | `ETag, x-oss-request-id` |
|
||||
| 缓存时间 | 3600 秒 |
|
||||
|
||||
---
|
||||
|
||||
## 4. 生命周期规则
|
||||
|
||||
### 仅 Data Bucket 配置
|
||||
|
||||
| Bucket | 规则名称 | 前缀 | 策略 |
|
||||
|--------|---------|------|------|
|
||||
| `ai-clinical-data` | auto-delete-temp | `temp/` | 1 天后删除 |
|
||||
| `ai-clinical-data-dev` | auto-delete-temp | `temp/` | 1 天后删除 |
|
||||
|
||||
---
|
||||
|
||||
## 5. 环境变量配置
|
||||
|
||||
### 5.1 本地开发环境 (`.env.development`)
|
||||
|
||||
```bash
|
||||
# 存储类型
|
||||
STORAGE_TYPE=oss
|
||||
|
||||
# OSS 开发环境配置
|
||||
OSS_REGION=oss-cn-beijing
|
||||
OSS_BUCKET=ai-clinical-data-dev
|
||||
OSS_BUCKET_STATIC=ai-clinical-static-dev
|
||||
OSS_ACCESS_KEY_ID=LTAI5tBHkL39GjdLfcr77Y3f
|
||||
OSS_ACCESS_KEY_SECRET=<从安全渠道获取>
|
||||
OSS_INTERNAL=false
|
||||
```
|
||||
|
||||
### 5.2 SAE 生产环境
|
||||
|
||||
```bash
|
||||
# 存储类型
|
||||
STORAGE_TYPE=oss
|
||||
|
||||
# OSS 生产环境配置
|
||||
OSS_REGION=oss-cn-beijing
|
||||
OSS_BUCKET=ai-clinical-data
|
||||
OSS_BUCKET_STATIC=ai-clinical-static
|
||||
OSS_ACCESS_KEY_ID=LTAI5tBHkL39GjdLfcr77Y3f
|
||||
OSS_ACCESS_KEY_SECRET=<从安全渠道获取>
|
||||
OSS_INTERNAL=true # 🔴 生产必须用内网
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 6. Endpoint 地址
|
||||
|
||||
| 环境 | Endpoint | 说明 |
|
||||
|------|----------|------|
|
||||
| 公网（本地开发） | `oss-cn-beijing.aliyuncs.com` | 本地开发使用 |
|
||||
| 内网（SAE 生产） | `oss-cn-beijing-internal.aliyuncs.com` | 生产环境必须使用，免流量费 |
|
||||
|
||||
---
|
||||
|
||||
## 7. 成本预警设置
|
||||
|
||||
| 配置项 | 值 |
|
||||
|--------|-----|
|
||||
| 预算名称 | OSS成本监控 |
|
||||
| 月预算 | 100 元 |
|
||||
| 告警阈值 | 80%, 100% |
|
||||
| 通知方式 | 短信 + 邮件 |
|
||||
| 通知手机 | 18611348738 |
|
||||
| 通知邮箱 | gofeng117@163.com |
|
||||
|
||||
---
|
||||
|
||||
## 8. 安全注意事项
|
||||
|
||||
### 🔴 绝对不要做的事
|
||||
|
||||
1. **不要**将 AccessKey Secret 提交到 Git 仓库
|
||||
2. **不要**在前端代码中使用 AccessKey
|
||||
3. **不要**将 `ai-clinical-data` Bucket 设为公共读
|
||||
4. **不要**在生产环境使用公网 Endpoint
|
||||
|
||||
### ✅ 应该做的事
|
||||
|
||||
1. AccessKey Secret 存储在 `.env` 文件（已加入 .gitignore）
|
||||
2. 定期轮换 AccessKey（建议每 90 天）
|
||||
3. 监控成本告警邮件
|
||||
4. 生产环境使用内网 Endpoint
|
||||
|
||||
---
|
||||
|
||||
## 9. 快速参考
|
||||
|
||||
### 开发环境快速测试
|
||||
|
||||
```bash
|
||||
# 1. 配置环境变量
|
||||
export OSS_REGION=oss-cn-beijing
|
||||
export OSS_BUCKET=ai-clinical-data-dev
|
||||
export OSS_ACCESS_KEY_ID=LTAI5tBHkL39GjdLfcr77Y3f
|
||||
export OSS_ACCESS_KEY_SECRET=<你的密钥>
|
||||
export OSS_INTERNAL=false
|
||||
|
||||
# 2. 启动后端
|
||||
cd backend
|
||||
npm run dev
|
||||
```
|
||||
|
||||
### 阿里云控制台链接
|
||||
|
||||
- [OSS 控制台](https://oss.console.aliyun.com/)
|
||||
- [RAM 控制台](https://ram.console.aliyun.com/)
|
||||
- [费用中心](https://usercenter2.aliyun.com/)
|
||||
|
||||
---
|
||||
|
||||
*文档结束。如有问题请联系：gofeng117@163.com*
|
||||
|
||||
|
||||
Reference in New Issue
Block a user