---
title: "上传二进制文件升级"
method: POST
path: "/upgrade/upload"
tags: ["系统升级"]
---

# 上传二进制文件升级

`POST /upgrade/upload`

上传 Songloft 二进制文件进行离线升级。上传后验证文件可执行并提取版本信息返回给前端，由前端判断是否需要二次确认（如跨通道升级）。确认后调用 /upgrade/upload/confirm 执行实际替换。

## Response `200`

上传文件的版本信息

- ModelsUploadedBinaryInfo
  - `build_time` string — 上传文件的构建时间
  - `build_type` string — 上传文件的构建类型（full/lite）
  - `channel` string — 上传文件的通道（stable/dev）
  - `channel_mismatch` boolean — 通道是否不匹配（需前端二次确认）
  - `current_channel` string — 当前运行通道
  - `current_version` string — 当前运行版本
  - `version` string — 上传文件的版本号

## Other responses

- `400` — 请求参数错误或文件无效
- `403` — 非 Docker 环境不支持升级
- `500` — 保存或验证文件失败

---

[API](https://skmtc.net/songloft-org/apis/songloft-api.md) · [All operations](https://skmtc.net/songloft-org/apis/songloft-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/songloft-org/songloft-api/versions/ee41778dbf8f/schema)