Cloudreve + OpenResty 反向代理大文件分片上传进度卡 99%、499 错误及会话过期完整解决指南

关键要点

问题根源：OpenResty 默认缓冲机制（proxy_request_buffering on）导致流式分片上传进度计算异常；后续会话 TTL 过期引发 79 字节错误响应，最终浏览器主动关闭连接产生 499。

• 核心修复：禁用代理缓冲 + 延长所有超时 + 将上传会话 TTL 设为 86400 秒 + 开启“缓存流式分片文件以用于重试” + 强制 HTTP/1.1 + 降低分片并发数。

• 最终效果：16MB 分片、并发 2 个的大文件（10GB+）上传进度实时流畅，无卡顿、无回退、无 499。

• 适用场景：任何 Cloudreve + Nginx/OpenResty/宝塔/1Panel 部署，亲测 Edge 145、Chrome 最新版有效。

• 推荐立即操作：按本文配置 10 分钟即可完成，成功率 95% 以上。

问题背景 使用 Cloudreve 自建网盘时，通过 OpenResty 反向代理暴露公网，大文件上传经常卡在 99%、进度回退，甚至报“分片 [xx] 上传失败: 上传会话不存在或已过期”，OpenResty 日志出现 200 + 79 字节错误后跟 499。小文件、直连后端均正常。典型场景：分片大小 25MB、并发上限 5 个。

最终推荐配置摘要

• Cloudreve 后台：上传会话 TTL → 86400 秒；传输与通信 → 开启“缓存流式分片文件以用于重试”；分片错误重试次数 → 50；存储策略分片并发数 → 临时降至 2-3。

• OpenResty location 块：完整禁用缓冲 + 所有超时设为 3600s +proxy_ignore_client_abort on + proxy_http_version 1.1。

快速验证 重载 OpenResty 后用 1GB+ 文件测试，cloudreve的反代日志所有分片稳定返回 200 + 19 字节（成功响应），大文件成功上传。

Cloudreve + OpenResty 反向代理大文件分片上传疑难杂症终极排查与解决全记录

作为一名自建网盘爱好者，我在部署 Cloudreve 时遇到了一个顽固问题：通过 OpenResty 反向代理后，大文件分片上传进度始终卡在 99%，甚至出现回退，最终报错“分片 [41] 上传失败: 上传会话不存在或已过期”，OpenResty 日志显示部分请求从 19 字节成功响应突变为 79 字节错误（Upload Session Expired）响应，并以 499（Client Closed Request）收尾。小文件和直连后端完全正常，这让我意识到问题出在反向代理层与 Cloudreve 上传机制的交互上。

经过多轮排查（禁用缓冲 → 延长超时 → 分析日志响应体大小 → 调整会话 TTL → 开启流式缓存重试），最终彻底解决。本文将完整复盘整个过程，附带所有配置、日志解读、参数对照表、注意事项和官方/社区验证链接，帮助看这篇文章的人少走弯路。

1
location / {
2
    allow all;
3
    proxy_set_header Host $http_host;
4
    proxy_set_header X-Real-IP $remote_addr;
5
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
6
    proxy_set_header X-Forwarded-Proto $scheme;
7
    proxy_redirect off;
8

9
    proxy_request_buffering off;
10
    proxy_buffering off;
11
    proxy_cache off;
12

13
    client_max_body_size 0;
14
    client_body_timeout 3600s;
15
    proxy_connect_timeout 300s;
16
    proxy_send_timeout 3600s;
17
    proxy_read_timeout 3600s;
18
    send_timeout 3600s;
19
    proxy_ignore_client_abort on;
20

21
    proxy_http_version 1.1;
22
    chunked_transfer_encoding on;
23
}