第11章 Cloudreve 本地存储配置指南与常见问题排查

本地存储

使用本地存储策略时，文件将保存在运行 Cloudreve 的同一台服务器上。

配置文件存储路径

您可以在存储策略配置中修改 Blob 存储目录（Blob Storage Directory）来指定文件存放路径。默认情况下，新创建的本地存储策略会使用 Cloudreve 可执行文件所在目录下的 data/uploads 目录。您可以按需修改该路径。如果输入相对路径，则相对于 Cloudreve 可执行文件所在目录。

TIP：如果在 Cloudreve 命令行参数中指定了 --use-working-dir，则 Blob 存储目录的相对路径将相对于启动时的工作目录。

预分配磁盘空间

在 Linux 或 macOS 上，启用“预分配磁盘空间”选项后，Cloudreve 会在上传开始时预分配磁盘空间，从而减少分块上传造成的碎片化。

常见问题

上传的文件无法下载，且看不到缩略图。

• 检查站点 URL 设置。
• 验证文件下载 URL 中的主机名部分是否正确。前往“管理面板 -> 设置 -> 站点信息”，确认当前站点 URL 是否在列表中。
• 如果不在列表中，请添加它，然后前往“管理面板 -> 文件系统”，点击底部的“清空 Blob URL 缓存”，再次尝试下载。
• 如果在列表中，但下载链接中的主机名仍不正确，请确保 Web 服务器的反向代理配置正确转发了 Host 头。例如，在 Nginx 中，需要在 location / 配置块中添加 proxy_set_header Host $host; 指令。
• 检查是否在 HTTPS 环境中使用了 HTTP 站点 URL。
• 检查服务器时间与客户端时间是否差异过大。如果差异较大，请同步时间，然后前往“管理面板 -> 文件系统”，点击底部的“清空 Blob URL 缓存”，再次尝试下载。
• 如果您正在使用 Cloudflare，请检查缓存级别（Cache Level）是否设置为 Standard。

文件下载链接中的域名/主机名不是我当前访问站点时使用的。

• 前往“管理仪表盘 -> 设置 -> 基本”，确认当前站点 URL 是否在列表中。
• 如果不在列表中，请添加它，然后前往“管理仪表盘 -> 设置 -> 文件系统”，点击底部的“清空 Blob URL 缓存”，再次尝试下载。
• 如果在列表中，但下载链接中的主机名仍不正确，请确保 Web 服务器的反向代理配置正确转发了 Host 头。例如，在 Nginx 中，需要在 location / 配置块中添加 proxy_set_header Host $host; 指令。

文件显示上传成功，但在文件列表中仍显示为“上传中”。

• 请检查是否有外部 WAF 防火墙阻止了上传请求。

文件上传失败，提示“无法解析响应”。

• 展开详细错误信息，检查是否包含“413 Request Entity Too Large”字样。
• 如果包含，请修改 Nginx 反向代理配置，设置或增大 client_max_body_size 的值，例如：client_max_body_size 20000m;。如果启用了分块上传，该值应大于分块大小；如果未启用分块上传，该值应大于上传文件大小。
• 检查是否有外部 WAF 防火墙阻止了上传请求。

使用 Cloudflare 时，无法上传大于 100MB 的文件。

• Cloudflare 免费版默认将单次文件上传请求的大小限制为 100MB。您可以为该存储策略设置分块上传来绕过此限制，分块大小需小于 100MB。