第18章 MinIO (S3 兼容) 配置指南

MinIO（S3 兼容） ​通过 S3 兼容存储策略使用 MinIO 存储文件。配置 ​参考 MinIO 官方文档部署你的 MinIO 集群。

使用 Web 面板或命令行工具 mc mb 创建一个存储桶；使用 Web 面板或命令行工具 mc admin accesskey create 创建一组访问密钥。

在 Cloudreve 中创建 S3 兼容存储策略，并按以下规则填写信息：

存储策略中的 Bucket Name 填写刚创建的存储桶名称； 存储策略中的 Endpoint 填写 MinIO 集群的 API 端点，并勾选 Force Path Style Endpoint； 存储策略中的 Region 填写 us-east-1； 存储策略中的 Access credential 填写刚创建的访问密钥的 Access Key 和 Secret Key。 MinIO 无需配置 CORS 策略，点击 I have set it manually 跳过 CORS 策略创建即可。

常见问题 ​上传报错：Chunk upload failed: X-Amz-Expires must be less than a week (in seconds)

检查 设置 -> 文件系统 -> 上传会话有效期（秒），该值应小于 604800。

上传报错：Request failed: AxiosError: Network Error

检查用户能否连接到你的 MinIO 集群 API 端点； 如果你的 Cloudreve 站点启用了 HTTPS，请为 MinIO 端点配置 HTTPS，或通过 Web 服务器反向代理 MinIO 端点。 上传传输失败，报错：Transfer upload failed, error: Unable to parse response

展开详细报错信息，检查其中是否包含 413 Request Entity Too Large。如果有，请修改 Nginx 反向代理配置，设置或调大 client_max_body_size 的值，例如 client_max_body_size 20000m;。该值应大于待上传文件的大小。

检查是否有外部 WAF 防火墙拦截了上传请求。

MinIO 端点经过反向代理后，无法上传或执行任何文件操作。

如果反向代理端点包含端口，配置 Nginx 时需要将 proxy_set_header 设置为 $http_host：nginxproxy_set_header Host $host; proxy_set_header Host $http_host; 如果文件的创建和删除操作正常，但无法从 Web 端上传文件，可尝试在 Nginx 反向代理配置中添加 proxy_cache_convert_head off;。