Cloudreve怎么快速配置S3协议对象存储源

一、结论

Cloudreve快速配置S3协议对象存储源的核心思路是先准备好S3服务的Endpoint、AccessKey、SecretKey、Bucket、Region等接入凭证信息，然后在Cloudreve后台的存储策略板块选择S3兼容存储类型，填写对应参数后测试连通性即可完成配置，全程无需修改代码，普通站长10分钟左右即可完成全流程操作。

二、准备工作

操作前需要提前准备好以下内容：

• 已部署完成、可以正常访问的Cloudreve站点（开源版、Pro版均支持S3存储接入）
• 支持S3协议的对象存储服务账号
• 已创建完成、读写权限配置符合要求的存储桶Bucket
• 对应存储桶的公网Endpoint访问地址
• 拥有该存储桶读写权限的AccessKey和配对的SecretKey
• 存储桶所属的Region标识（部分服务商无强制要求可省略）
• 1个大小不超过10MB的测试文件，用于验证配置是否生效

三、操作步骤

1. 登录Cloudreve后台管理面板，进入左侧菜单栏的「存储策略」页面，点击右上角「新建存储策略」按钮，在弹出的存储类型列表中选择「S3 兼容存储」，进入配置表单页。结果：页面加载出完整的S3参数填写界面，所有必填字段均有明确标注。

2. 核对提前准备好的S3接入信息，按照表单提示依次填入Endpoint、AccessKey、SecretKey、Bucket名称、Region字段，若存储桶绑定了自定义CDN域名，也可以在对应配置项中填写，后续生成的文件访问链接会自动使用该域名。结果：所有必填字段均完成填写，无空项、多余空格或大小写错误。

3. 根据自身站点需求配置存储策略的业务规则，包括单文件上传大小上限、允许上传的文件类型、文件在存储桶中的存储路径规则、直链签名有效期等，无特殊需求可以保留系统默认配置。结果：业务规则配置符合站点的运营要求，不会出现正常文件无法上传的问题。

4. 点击页面下方的「测试连通性」按钮，等待Cloudreve系统主动向S3存储服务发起连接测试，测试过程中不要关闭或刷新页面。结果：系统弹出「连接成功」的提示，若提示连接失败则需要回到上一步逐一核对参数填写是否正确。

5. 连通性测试通过后，点击「保存」按钮完成存储策略创建，然后进入「用户组」或「用户管理」页面，将新建的S3存储策略分配给对应的用户或用户组使用。结果：被分配权限的用户可以在前端上传时选择该S3存储策略。

6. 切换到普通用户账号，在Cloudreve前端上传提前准备好的测试文件，上传完成后分别测试在线预览、生成直链、下载三个功能，确认所有功能正常可用。结果：文件上传、预览、下载均无报错，直链可以正常访问，配置正式生效。

7. 若需要将该S3存储策略作为站点默认存储，回到存储策略列表页面，点击对应策略的「设为默认」按钮即可，后续所有用户上传的文件都会默认存入该S3存储桶中。

四、常见错误

1. Endpoint填写错误：常见问题包括多写了http/https前缀、误填存储桶访问域名而非官方Endpoint、公网部署的Cloudreve填了内网Endpoint，解决办法是直接复制对象存储服务商提供的官方公网Endpoint，不要手动修改内容，确认地址不带存储桶前缀。

2. AccessKey或SecretKey错误：常见问题包括复制时多带了空格、大小写错误、使用的密钥没有对应存储桶的读写权限，解决办法是重新在对象存储控制台生成新的密钥，确认密钥关联的权限策略包含该存储桶的读、写、列文件权限，复制时注意不要选中多余字符。

3. Region填写不匹配：常见问题包括填错存储桶所属区域的标识、服务商无Region要求时误填了错误内容，解决办法是按照服务商提供的Region标识准确填写，若服务商无强制要求则留空该字段即可。

4. 跨域配置错误导致上传失败：常见问题是存储桶的CORS配置没有添加Cloudreve站点的域名，导致前端上传请求被拦截，解决办法是在对象存储控制台的存储桶跨域配置中，添加Cloudreve站点域名，允许GET、POST、PUT、DELETE等请求方法。

5. 上传成功但访问链接不可用：常见问题包括自定义CDN域名解析错误、存储桶设置为私有但配置时没有开启签名功能、直链有效期设置过短，解决办法是检查自定义域名的解析和CDN回源配置，私有存储桶不要直接复制原始存储地址访问，使用Cloudreve生成的签名链接即可正常访问。

五、示例说明

以下是Cloudreve S3存储策略的通用配置示例，所有字段均按照实际获取的信息填写即可，无需修改其他配置：

| 配置字段 | 填写说明 |

| --- | --- |

| Endpoint | 填写所用S3对象存储服务官方提供的公网访问地址，不要携带存储桶名称前缀 |

| AccessKey | 填写你在对象存储服务控制台生成的、拥有对应存储桶读写权限的访问密钥ID |

| SecretKey | 填写与上述AccessKey配对的访问密钥密码 |

| Bucket | 填写你提前创建好的存储桶的准确名称，注意大小写要与控制台完全一致 |

| Region | 填写存储桶所属区域的官方标识，若服务商无强制要求可留空 |

| 自定义CDN域名 | 可选，如果你给存储桶绑定了加速域名，可在此处填写，最终生成的文件访问链接会使用该域名 |

| 存储路径前缀 | 可选，可自定义Cloudreve上传的文件在存储桶中的存放目录，比如填cloudreve/就会所有文件存入该目录下 |

| 直链有效期 | 可选，私有存储桶的签名链接有效时长，单位为秒，无特殊需求可以设置为86400（24小时） |

六、更简单的方案

如果不想自己搭建MinIO这类自建S3存储服务，也不想花费精力维护服务器、处理存储扩容、流量带宽调度等运维问题，可以直接选择成熟的第三方兼容S3协议的云对象存储服务，开箱即用，无需运维底层架构。如果你需要一个兼容S3协议、适合网盘系统存储源、附件存储、下载分发的对象存储服务，可以了解 七彩云对象存储，它适配Cloudreve等各类支持S3协议的程序，适合需要低门槛接入和不限流量下载分发的站长、开发者使用。

七、FAQ

Q1：Cloudreve开源版支持配置S3对象存储源吗？

A：支持，无论是开源版还是Pro版都提供S3兼容存储策略的配置入口，配置流程完全一致，没有功能差异，无需额外安装插件即可使用。

Q2：配置完成后之前已经上传到本地存储的文件可以迁移到S3存储里吗？

A：可以，Cloudreve后台自带存储策略迁移工具，选择对应的源存储策略和目标S3存储策略即可批量迁移文件，迁移完成后系统会自动更新文件的访问路径，不会影响现有文件的正常使用。

Q3：S3存储桶设置为私有读写会影响Cloudreve的文件访问吗？

A：不会，Cloudreve会自动为私有存储桶的文件生成签名访问链接，只要配置的密钥有对应的读权限，就可以正常生成可访问的链接，不需要将存储桶设置为公开读写，反而能提升文件存储的安全性。

Q4：可以在同一个Cloudreve站点配置多个不同的S3存储源吗？

A：可以，你可以创建多个S3类型的存储策略，分别分配给不同的用户组或者单独的用户使用，不同存储策略的文件互相隔离，互不影响，适合需要划分不同存储资源的场景。

八、总结

整个Cloudreve配置S3对象存储源的流程核心就是「准备接入参数-填写配置-测试连通性-分配权限-验证功能」五个核心步骤，不需要复杂的代码修改，稍有站点运维经验的站长都可以快速完成配置。这种配置方式适合需要将Cloudreve的文件存放到第三方存储、降低自身服务器存储压力、提升文件下载分发速度的场景，不管是个人使用的私人网盘，还是面向用户的公共资源存储、下载站类的站点都适用。如果没有特殊的本地化存储需求，选择第三方S3兼容存储服务可以大幅降低运维成本，提升站点的整体稳定性。