Nexus/docs/changelog/2026-06-11-upload-limit-500m.md

Changelog — 上传/推送体积上限统一 500MB

日期：2026-06-11

摘要

将推送/文件上传的 Nginx client_max_body_size 与后端 MAX_UPLOAD_FILE_SIZE、下载上限统一为 500MB，修复生产 OpenResty 全局 50MB 导致 80MB 推送失败的问题。

动机

生产 1Panel OpenResty 全局 client_max_body_size 50m，站点未覆盖；仓库模板为 100m，与后端 ZIP 500MB 不一致。用户 80MB 上传在 Nginx 层 413 被拒。

涉及文件

• server/api/sync_v2.py — MAX_UPLOAD_FILE_SIZE、下载 MAX_DOWNLOAD_SIZE → 500MB
• deploy/nginx_http.conf、deploy/nginx_https.conf、deploy/install.sh
• deploy/1panel/openresty-nexus.conf.example — 500m + 600s 上传超时
• docs/install-guide.md、docs/design/plans/2026-06-04-1panel-docker-production.md

生产变更

• OpenResty 全局 nginx.conf：50m → 500m
• api.synaglobal.vip 站点 proxy/root.conf：增加 client_max_body_size 500m 与 proxy/body 600s 超时

迁移 / 重启

• 无 DB 迁移；重载 OpenResty/Nginx 后生效
• 后端需部署以应用 sync_v2.py 单文件 500MB 校验

验证

pytest tests/test_sync_upload_staging.py -q
nginx -t && openresty -s reload  # 生产

推送页上传 ≤500MB 单文件/ZIP/批次应通过；>500MB 返回明确 400/413。