跳到主要内容
gitee logo

LFS 大文件直传/分片传输插件

提示

在过往的 Gitee LFS 文件上传流程中，LFS 文件数据会从客户端先上传至 Gitee LFS 服务进行中转，再由 LFS 服务转发到 Gitee LFS 对象存储。

受 Gitee LFS 服务带宽等因素制约，这一过程容易导致文件上传速度慢、失败重试率高等问题

2025 年 11 月，Gitee LFS 服务从原有的 服务中转传输 升级为 支持对象存储直传，可以使客户端直接将文件上传到对象存储，可大幅提升了上传速度和成功率

注意

Gitee LFS 默认使用 对象存储直传，当单个 lfs 文件超过 3.5GB，需要使用 Gitee 提供的 分片传输插件，否则无法使用对象存储直传特性

下载安装​

bash
curl -fsSL https://gitee.com/oscstudio/gitee-lfs-multipart-uploader/raw/master/install.sh | bash

默认情况下，multipart-transfer 命令会被安装到 /usr/local/bin

在 Linux/unix/macOS 上启用插件​

下述 <lfs_repo_path> 为启用对象存储直传工具，支持相对路径

bash
multipart-transfer --lfs-enable-multipart <lfs_repo_path>

假定推送的 lfs 仓库位于 /home/git/repo

bash
multipart-transfer --lfs-enable-multipart /home/git/repo

推送 LFS 文件​

启用插件后，不需要额外操作，直接推送即可，插件会在需要时自动运行

bash
git push origin master

断点续传支持​

启用分片传输插件后，默认启用断点续传特性，大文件上传过程中（至少上传 300MB 之后）若发生中断，不会丢失所有进度

resume-transfer