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 → 开启流式缓存重试），最终彻底解决。本文将完整复盘整个过程，附带所有配置、日志解读、参数对照表、注意事项和官方/社区验证链接，帮助看这篇文章的人少走弯路。

问题成因深度分析

会话 TTL 机制：Cloudreve 在创建上传会话时记录 TTL（默认通常24小时）。所有分片必须在 TTL 内完成，否则后续分片直接返回 40011。在TTL内的分片成功，但总耗时（尤其是大文件 1GB+、并发 5、磁盘慢）超过 TTL，导致失败。（当然这个不是主要原因）
前端重试机制：Cloudreve 前端对失败分片会自动重试，但会话已过期，重试仍返回 79 字节，形成死循环。
499 收尾：重试持续太久，浏览器超时主动关闭连接，openresty 记录 499。
反向代理放大因素：HTTP/2 多路复用、超时不足、缺少 ProxyHeader 可能让部分请求延迟，进一步推高总耗时。

配置对照表（推荐最终值）

配置位置	关键参数	推荐值	作用说明	优先级
Cloudreve 后台	上传会话 TTL（秒）	86400（24h）	覆盖大文件全程上传	★★
存储策略	分片并发上传数	2~3	减轻磁盘 I/O 压力，缩短总耗时	★★★★★
OpenResty location	proxy_http_version	1.1	避免 HTTP/2 复用导致的超时问题	★★★★★
OpenResty	listen 443 ssl	去掉 http2	强制 HTTP/1.1	★★★★
OpenResty	proxy_read_timeout / send_timeout	3600s	允许单个分片最长 1 小时	★★★★★
本地存储（Linux）	预分配硬盘空间	开启	减少写入碎片，提升大文件稳定性	★★★

完整推荐 location 块：

location / {
    allow all;
    proxy_set_header Host $http_host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_redirect off;

    proxy_request_buffering off;
    proxy_buffering off;
    proxy_cache off;

    client_max_body_size 0;
    client_body_timeout 3600s;
    proxy_connect_timeout 300s;
    proxy_send_timeout 3600s;
    proxy_read_timeout 3600s;
    send_timeout 3600s;
    proxy_ignore_client_abort on;

    proxy_http_version 1.1;
    chunked_transfer_encoding on;
}