---
id: S3-Protocol
title: "S3协议"
type: concept
tags: [storage, protocol, cloud]
sources: []
last_updated: 2026-04-15
---

## Definition
S3（Simple Storage Service）协议是 Amazon 发布的对象存储接口标准，通过 RESTful API 提供键值对形式的大规模对象存储。MinIO、Cloudflare R2、Backblaze B2 等均兼容 S3 协议。

## Core Operations
- PUT/GET/DELETE Object：上传、下载、删除对象
- ListBuckets/ListObjects：列举存储桶和对象
- HEAD Object：获取对象元数据

## MinIO Configuration Parameters
- S3_BUCKET：存储桶名称
- S3_ENDPOINT：S3 API 端点 URL
- S3_ACCESS_KEY：访问密钥（MINIO_ROOT_USER）
- S3_SECRET_KEY：秘密密钥（MINIO_ROOT_PASSWORD）
- S3_REGION：区域（MinIO 使用 us-east-1）
- S3_FORCE_PATH_STYLE：true（MinIO 必需，R2 等云服务可 false）

## Related Concepts
- [[MinIO]]：开源 S3 兼容对象存储
- [[Zipline]]：使用 S3 协议连接 MinIO 的应用
- [[向量数据库]]：与对象存储是完全不同的数据存储范式