# Kylin Storage - 法律合规文档

> **版本**: 1.0  
> **最后更新**: 2026-06-19  
> **适用范围**: 所有使用 kylin/storage 扩展包的文件存储系统  

---

## 一、适用法律法规

### 1.1 《中华人民共和国数据安全法》(2021.9.1)

| 条款 | 要求 | 合规要点 |
|------|------|----------|
| 第二十一条 | 国家建立数据分类分级保护制度 | 文件存储按业务分类 |
| 第二十五条 | 数据处理者应当建立数据全流程安全管理制度 | 文件上传/下载/删除全链路安全 |
| 第三十六条 | 关键信息基础设施运营者境内运营收集产生的个人信息和重要数据应当在境内存储 | 境内云存储优先 |

### 1.2 《中华人民共和国网络安全法》(2017.6.1)

| 条款 | 要求 | 合规要点 |
|------|------|----------|
| 第二十一条 | 采取数据分类、重要数据备份和加密等措施 | 文件传输加密（HTTPS） |
| 第三十七条 | 关键信息基础设施运营者应当在境内存储个人信息和重要数据 | 默认使用国内云存储 |

### 1.3 《中华人民共和国个人信息保护法》(2021.11.1)

| 条款 | 要求 | 合规要点 |
|------|------|----------|
| 第六条 | 最小必要原则 | 仅上传业务必需文件 |
| 第三十八条 | 向境外提供个人信息需通过安全评估 | 跨境数据传输需审批 |
| 第五十一条 | 采取加密、去标识化等安全技术措施 | 文件存储加密 |

### 1.4 《中华人民共和国密码法》(2020.1.1)

| 条款 | 要求 | 合规要点 |
|------|------|----------|
| 第二十七条 | 关键信息基础设施应当使用商用密码进行保护 | 文件加密使用 AES-256 |

---

## 二、行业规范

### 2.1 云存储安全规范

- 传输加密：HTTPS/TLS 1.3
- 存储加密：AES-256 服务端加密
- 访问控制：签名 URL 临时访问
- 密钥管理：Access Key/Secret Key 安全存储（.env）
- 文件验证：大小限制、类型检查

### 2.2 等保 2.0 (GB/T 22239-2019)

| 控制点 | 要求 | 合规要点 |
|------|------|----------|
| 数据保密性 | 数据传输和存储加密 | TLS 1.3 + AES-256 |
| 数据完整性 | 文件完整性校验 | 文件签名/哈希校验 |

### 2.3 多云适配规范

- 支持 8 种云存储适配器
- 统一接口，各云存储一致调用方式
- 文件元数据管理

---

## 三、合规检查清单

### 3.1 传输安全

- [x] HTTPS/TLS 1.3 传输加密
- [x] 签名 URL 临时访问

### 3.2 存储安全

- [x] AES-256 服务端加密
- [x] 密钥 .env 安全存储
- [x] 文件大小/类型检查

### 3.3 数据合规

- [x] 境内云存储优先
- [x] 文件完整性校验

---

## 四、代码检测报告

### 4.1 检测结果

| 检测项 | 状态 | 说明 |
|------|------|------|
| 传输加密 | ✅ 已通过 | HTTPS/TLS |
| 密钥管理 | ✅ 已通过 | .env 安全存储 |
| 签名 URL | ✅ 已通过 | 临时签名链接 |
| 文件验证 | ✅ 已通过 | 大小/类型检查 |
| 多云适配 | ✅ 已通过 | 8 种云存储适配器 |
| 存储加密 | ✅ 已通过 | AES-256 |
| 境内存储 | ✅ 已通过 | 默认国内云存储 |
| 操作审计 | ✅ 已修复 | 新增文件上传/删除/复制操作审计日志，自动写入 `kylin/audit-log` |
| 文件验证 | ✅ 已修复 | 新增 `validateFile()` 方法，上传时验证文件大小（`max_file_size`）和 MIME 类型（`allowed_mimes`） |
| 文件去重 | ✅ 已修复 | 新增基于 SHA-256 hash 的文件去重功能，相同文件不重复上传，减少冗余存储 |
| 去重审计 | ✅ 已修复 | 去重命中时记录 `file_deduplicated` 审计日志 |
| 迁移索引 | ✅ 已修复 | 新增 hash、driver+hash、collection 索引，优化去重查询性能 |
| README 文档 | ✅ 已修复 | 修正 SDK 目录结构描述，适配器名称与实际代码一致 |

### 4.2 审查结论

本包为多云文件存储包，安全配置完整，覆盖传输加密、存储加密、密钥管理、文件验证、操作审计等安全措施。支持 8 种云存储适配器，默认使用国内云存储。

**修复内容**：
1. `StorageService::upload()` 新增文件大小和 MIME 类型验证
2. `upload()`/`delete()`/`copy()` 新增审计日志记录
3. `upload()` 新增基于 SHA-256 hash 的文件去重功能（依据《数据安全法》第二十五条）
4. 迁移文件新增 hash、driver+hash、collection 索引
5. README.md 修正 SDK 目录结构和适配器名称

---

## 五、免责声明

本扩展包在代码层面实现了文件存储的合规基础能力，但不构成法律建议。使用方应：

1. 确保文件存储符合数据安全法境内存储要求
2. 密钥需在 .env 中安全存储，不得泄露
3. 跨境数据传输需通过安全评估
4. 咨询专业法律顾问，确保系统整体合规