# 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 校验

## 验证

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

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