1. 课程导学
1.1 为什么需要对象存储？
在微服务与云原生架构中，传统文件系统（如本地磁盘、NFS）难以应对海量非结构化数据的存储与分发。对象存储（Object Storage）以“桶-对象”扁平模型替代目录树，提供高扩展、高可用、低成本的存储方案。MinIO 是业界领先的开源对象存储系统，兼容 Amazon S3 API，适合私有云与边缘场景。
核心概念速览：对象存储中的“对象”包含数据本身、元数据（Metadata）和唯一标识符（Key）；“桶”是对象的容器，类似命名空间。
1.2 MinIO 对象存储概述
MinIO 使用 Go 语言开发，单二进制文件即可运行，支持纠删码（Erasure Code）与 Bitrot 保护。下表对比了 MinIO 与传统文件系统及云对象存储的关键差异：
| 特性 | 传统文件系统 | 云对象存储（S3） | MinIO |
|---|---|---|---|
| 数据模型 | 目录树 + 文件 | 桶 + 对象 | 桶 + 对象（S3 兼容） |
| 扩展性 | 受限于单机 | 无限水平扩展 | 分布式集群扩展 |
| 访问协议 | POSIX | HTTP REST (S3 API) | HTTP REST (S3 API) |
| 数据保护 | RAID / 备份 | 多副本 / 纠删码 | 纠删码 + Bitrot 检测 |
| 部署方式 | 本地挂载 | 公有云托管 | 私有化 / 边缘部署 |
MinIO 的典型应用场景包括：
- 应用文件存储：用户头像、商品图片、日志归档。
- 数据湖与备份：作为 Hadoop/Spark 的底层存储。
- AI/ML 数据集：存储训练图片、视频、模型文件。
- 边缘计算：在 IoT 网关本地运行 MinIO，缓存数据后同步至中心。
1.3 NestJS 中间件概念
NestJS 中间件（Middleware）是在路由处理器之前执行的函数，可以访问请求对象（Request）、响应对象（Response）以及应用程序的请求-响应周期中的 next() 函数。中间件常用于：
- 日志记录与请求追踪
- 身份验证与权限校验
- 请求体解析与数据转换
- 跨域处理（CORS）
- 限流与防重放
在 NestJS 中，中间件可以通过类（实现 NestMiddleware 接口）或函数方式定义。本课程将重点使用函数式中间件，因为它更轻量、易于测试。
关键区别：NestJS 中间件与 Express 中间件本质相同，但 NestJS 提供了依赖注入、模块化组织以及更丰富的装饰器支持。
1.4 课程目标
完成本课程后，你将能够：
- 独立部署 MinIO 服务并创建访问凭证。
- 在 NestJS 项目中集成
@aws-sdk/client-s3或minio官方 SDK。 - 使用 NestJS 中间件实现请求级别的 MinIO 操作（上传、下载、删除、列表）。
- 设计可复用的中间件链，处理文件类型校验、大小限制、桶隔离等业务逻辑。
- 编写单元测试与 e2e 测试，保障存储接口的稳定性。
1.5 前置知识要求
为了顺利学习本课程，建议你具备以下基础：
| 知识领域 | 具体要求 | 推荐资源 |
|---|---|---|
| TypeScript | 熟悉类型系统、装饰器、异步/await | TypeScript 官方文档 |
| Node.js | 理解事件循环、Stream、Buffer | Node.js 官方指南 |
| NestJS 基础 | 模块、控制器、服务、依赖注入 | NestJS 官方入门教程 |
| HTTP/REST | 熟悉请求方法、状态码、Multipart 上传 | MDN HTTP 文档 |
| Docker（可选） | 用于本地启动 MinIO 实例 | Docker 快速入门 |
注意：如果你对 NestJS 中间件完全陌生，建议先阅读 NestJS 官方文档中关于“Middleware”的章节，了解
NestMiddleware 接口与 @Injectable() 装饰器的基本用法。
1.6 课程章节概览
本课程共 30 章，分为 5 个阶段：
- 阶段一（第 1-5 章）：环境搭建与 MinIO 基础操作。
- 阶段二（第 6-12 章）：NestJS 中间件核心机制与自定义中间件实现。
- 阶段三（第 13-20 章）：基于中间件的 MinIO 接口设计（上传、下载、删除、列表、分片）。
- 阶段四（第 21-26 章）：高级主题——中间件链、异常过滤、速率限制、日志追踪。
- 阶段五（第 27-30 章）：测试策略、性能优化与生产部署。
现在，让我们开始第一阶段的旅程——搭建 MinIO 开发环境并创建第一个 NestJS 项目。