一、结论
Cloudreve 接入 S3 存储源的核心思路是：先根据文件类型、文件大小、访问权限、下载分发规模和成本预算确定存储策略，再准备好 Bucket、Endpoint、Region、AccessKey、SecretKey，最后在 Cloudreve 后台新增 S3 兼容存储策略并完成上传与访问测试。验证通过后，再将其设置为默认存储源或分配给指定用户组使用。
二、准备工作
开始配置前，建议先准备以下内容：
- 一个支持 S3 协议的对象存储账号。
- 一个已创建的存储桶 Bucket，用于存放 Cloudreve 上传的文件。
- 对象存储服务提供的 Endpoint 访问地址。
- 一对用于访问 S3 服务的 AccessKey 和 SecretKey。
- Bucket 所在地域对应的 Region 信息。
- 已安装并可正常登录管理后台的 Cloudreve 站点。
- 一个用于测试的小文件，例如图片、文本文件或压缩包。
- 如业务需要通过固定域名访问文件，还应提前确认对象存储服务的访问域名、CDN 或自定义域名配置方式。
- 如果需要先验证密钥是否可用，也可以准备一个支持 S3 协议的客户端或第三方工具，但这不是必须步骤。
在正式配置前，还应先判断自身业务需求：
- 如果主要存放图片、网站附件、用户头像，建议关注访问稳定性、文件路径管理和外链访问能力。
- 如果主要存放大文件、安装包、视频或资源站文件，建议关注下载分发能力、流量成本和大文件上传稳定性。
- 如果文件包含私有资料、备份数据或内部文档，应优先使用私有 Bucket，并通过程序生成的授权链接访问。
- 如果多个项目或多个程序共用存储，建议通过 Bucket 隔离，或至少使用不同的路径前缀和独立密钥。
三、操作步骤
1. 根据业务需求确定存储策略
先明确 Cloudreve 主要承载哪类文件，例如个人网盘文件、图床图片、网站附件、视频文件或下载站资源。
同时判断文件是否需要公开访问、是否允许匿名下载、预计上传文件大小、下载分发频率以及是否需要长期归档。
结果： 形成清晰的存储使用策略，避免后续把公开文件和私有文件混放在同一个 Bucket 中。
2. 创建或准备存储桶
在对象存储服务控制台中创建一个 Bucket，或选择一个已有的 Bucket。
建议 Bucket 名称具有辨识度，例如按项目名称、站点名称或用途区分，但不要把名称设置得过于复杂。创建时应确认访问权限：公开图床可使用公共读配置，私有文件则应保持私有访问。
结果： 获得一个可用于 Cloudreve 文件存储的 Bucket，并记录 Bucket 名称。
3. 获取 S3 接入信息
在对象存储控制台中找到 S3 兼容接入信息，通常包括：
- Endpoint
- AccessKey
- SecretKey
- Bucket
- Region
AccessKey 和 SecretKey 相当于程序访问存储的身份凭证，建议为 Cloudreve 单独创建密钥，并只授予当前 Bucket 所需的最小权限，不要直接使用主账号密钥。
结果： 拿到 Cloudreve 接入 S3 所需的全部连接信息。
4. 进入 Cloudreve 后台的存储策略管理
使用管理员账号登录 Cloudreve 后台，找到存储策略、存储源或外部存储相关管理入口。
不同版本的界面名称可能略有差异，但通常会在后台管理中提供新增存储策略的功能。
结果： 进入新增存储源的配置页面。
5. 选择 S3 兼容存储类型
在新增存储策略时，选择 S3、S3 兼容或 Amazon S3 类似的存储类型。
Cloudreve 就是通过这一类配置对接支持标准 S3 协议的对象存储服务，而不是只能使用某一家固定厂商的存储。
结果： 打开 S3 存储源配置表单。
6. 填写 S3 配置信息
按对象存储服务商提供的信息填写：
- Endpoint：填写 S3 API 访问地址。
- AccessKey：填写访问密钥 ID。
- SecretKey：填写对应的访问密钥。
- Bucket：填写已创建的存储桶名称。
- Region：填写服务商要求的地域信息。
- 路径前缀或目录前缀：如 Cloudreve 支持，可填写一个独立目录，避免与其他程序文件混放。
- 访问域名或 CDN 域名：如业务需要固定外链，可按实际域名配置。
填写时应特别注意 Endpoint 不要带多余空格，Bucket 名称必须与服务端完全一致，Region 也应与 Bucket 所在地域匹配。
结果： 完成 S3 存储源的核心参数配置。
7. 保存并测试连接
保存配置后，先使用 Cloudreve 提供的测试功能检测连接是否正常。
如果程序没有明确的测试按钮，可以直接进入下一步上传测试文件。若保存时报错，应优先检查 Endpoint、密钥、Bucket 和 Region 是否正确。
结果： 确认 Cloudreve 能够正常连接对象存储服务。
8. 上传测试文件并验证访问
在 Cloudreve 中上传一个小文件，然后执行以下检查：
- 文件是否能正常上传。
- 上传后是否能在 Cloudreve 文件列表中看到。
- 文件详情或对象存储控制台中是否出现对应的 Object。
- 文件链接是否能正常打开或下载。
- 如果是图片，确认页面中是否能正常加载。
- 如果是私有文件，确认未授权访问是否会被拒绝。
结果： 验证上传、存储、读取和下载链路均正常。
9. 分配给业务场景正式使用
测试通过后，可以将该 S3 存储策略设置为默认存储策略，或分配给指定用户组、指定分类使用。
如果是已有 Cloudreve 站点，建议先让少量用户或新文件使用新存储源，观察一段时间后再扩大使用范围。旧文件迁移需要单独处理，不能只靠修改存储策略自动完成。
结果： Cloudreve 正式将文件写入 S3 对象存储，并按业务需求提供访问或下载服务。
四、常见错误
1. Endpoint 填写错误
常见情况是把控制台域名、文档地址或对象访问域名当成 S3 API Endpoint。应使用对象存储服务商明确提供的 S3 接入地址，并确认是否需要包含协议头。
2. AccessKey 或 SecretKey 填错
复制密钥时容易带入空格，或把 AccessKey 和 SecretKey 顺序填反。建议重新复制并核对，同时确认密钥没有被禁用或删除。
3. Bucket 名称不一致
Bucket 名称必须与对象存储控制台中的名称完全一致，大小写和符号都不能出错。如果程序要求单独填写 Bucket，就不要把路径前缀拼接到 Bucket 名称中。
4. Region 不匹配
如果 Bucket 创建在某一地域，但 Cloudreve 中填写了其他 Region，可能出现连接失败、上传失败或权限异常。应按服务商要求填写，不要随意猜测。
5. 权限不足导致上传失败
如果密钥只有读取权限，或没有当前 Bucket 的上传、删除、列举权限，Cloudreve 可能无法写入文件。应为程序使用的密钥授予对应 Bucket 的必要权限。
6. 上传成功但链接无法访问
这种情况通常与 Bucket 访问权限、文件 ACL、访问域名、CDN 配置或私有链接签名有关。公开文件应确认可匿名读取，私有文件则应通过 Cloudreve 生成的授权链接访问。
7. 文件路径或 Object Key 不规范
不建议在文件名和路径中使用大量特殊字符、中文空格或过长路径。多程序共用 Bucket 时，应使用独立前缀，避免文件相互覆盖。
五、示例说明
以下是一个通用 S3 配置示例，仅用于说明各字段应填写什么内容，不代表真实地址或密钥：
| 配置项 | 填写内容 |
|---|---|
| Endpoint | 填写对象存储服务提供的 S3 API 访问地址 |
| AccessKey | 填写为 Cloudreve 创建的访问密钥 ID |
| SecretKey | 填写与 AccessKey 对应的密钥 |
| Bucket | 填写已创建的存储桶名称 |
| Region | 填写 Bucket 所在地域，或按服务商要求填写 |
| 路径前缀 | 可选，例如填写独立目录用于隔离 Cloudreve 文件 |
| 访问域名 | 可选，填写文件访问域名或 CDN 域名 |
如果服务商文档说明某些字段可以留空，或客户端提供了路径格式、签名版本等高级选项，应优先按照服务商文档和 Cloudreve 的提示调整。
六、更简单的方案
如果不想自行搭建和维护 MinIO，也不想额外购买服务器、监控磁盘容量或处理存储节点故障，可以直接选择兼容 S3 协议的云对象存储服务。
这样 Cloudreve 只需要填写 S3 接入信息，文件上传、存储和下载分发由云服务承担，站长可以把更多精力放在站点运营和业务功能上。
如果你需要一个兼容 S3 协议、适合程序接入、图床、网盘系统存储源和下载分发的对象存储服务，可以了解 七彩云对象存储。它适合需要 S3 接入、文件直链和不限流量下载分发的项目场景。
七、FAQ
Cloudreve 应该选择本地存储还是 S3 存储？
如果文件量小、主要个人使用，本地存储部署最简单。如果需要多机部署、文件备份、下载分发、图床外链或减少服务器磁盘压力，S3 存储更合适。已有云服务器磁盘紧张时，也适合把附件和大文件迁移到对象存储。
配置 S3 后，原来的本地文件会自动迁移吗？
通常不会。新增 S3 存储策略只影响新上传的文件，旧文件仍保存在原位置。如需迁移，需要先通过 S3 客户端、API 或迁移工具把文件复制到对象存储，再根据 Cloudreve 的文件记录方式调整路径或策略。
为什么文件上传成功，但访问时出现 403 或 404？
403 通常是权限问题，例如 Bucket 为私有、文件没有公共读权限或访问签名不正确；404 则可能是访问域名、路径前缀或 Object Key 不正确。应先在对象存储控制台确认文件是否存在，再检查 Bucket 权限和 Cloudreve 中配置的访问域名。
多个程序可以共用同一个 Bucket 吗？
可以，但建议为 Cloudreve、Alist、PicGo、Halo、WordPress 等不同程序设置不同路径前缀，避免文件覆盖或管理混乱。权限要求差异较大时，更推荐使用不同 Bucket 和不同 AccessKey。
大文件上传失败应该检查什么？
应先确认 Cloudreve 和对象存储服务是否正常支持分片上传，再检查文件大小限制、请求超时、网关限制和密钥权限。如果是通过反向代理访问 Cloudreve，还需要确认代理层面对上传大小和超时时间的限制。
八、总结
Cloudreve 接入 S3 存储源的流程可以概括为：明确业务场景、准备 Bucket 和密钥、在 Cloudreve 中新增 S3 兼容存储策略、填写 Endpoint、AccessKey、SecretKey、Bucket、Region，最后上传文件并验证访问。
这种方式适合网盘系统、图床、网站附件、资源下载站、大文件分发和自建应用存储等场景。选择存储源时，不应只关注是否兼容 S3，还应结合文件公私属性、下载流量、维护成本和后续扩展能力综合判断。
想进一步了解这个项目？
访问官网查看产品能力、适用场景和最新服务信息。
访问官网