在大模型部署过程中,上传模型参数文件一直是个难题。Git LFS 虽支持大文件管理,但 原生不支持断点续传,一旦网络中断就需重头上传,对于动辄几十 GB 的模型权重而言,上传失败是常态。
为解决这一问题,Gitee 开源了 gitee-lfs-multipart-uploader 工具,支持 大文件分片上传与断点续传,适配 Linux/Unix 与 Windows,安装启用后即可无感接入 Git 使用流程,显著提升超大文件上传成功率。
开源仓库地址:https://gitee.com/oscstudio/gitee-lfs-multipart-uploader为什么需要这个工具?
在使用原生 Git LFS 上传 LLM 等超大文件时,常会遇到网络中断、上传失败的问题。Git LFS 默认并不支持断点续传,一旦中途失败,必须从头重来。对于数 GB 到数十 GB 的模型权重文件而言,这种失败往往意味着永远也上传不上去。
为此,我们建议在上传 大于 1GB 的 LFS 对象时,启用 Gitee 自定义的上传插件。该插件支持自动分片与断点续传,极大提升上传成功率,尤其适用于 LLM 权重、Embedding 文件、训练中间结果等典型大文件上传场景。
原生 Git LFS 无断点能力,该插件支持断点续传
分片上传,适配大文件传输需求
上传失败可恢复,适合模型、嵌入等多类大文件
跨平台支持,Linux/Unix 与 Windows 都能用
无感接入,启用后直接 git push 即可
Linux/macOS
curl -fsSL https://gitee.com/oscstudio/gitee-lfs-multipart-uploader/raw/master/install.sh | bash
Windows
1.访问最新版发布页:https://gitee.com/oscstudio/gitee-lfs-multipart-uploader/releases
2.下载并运行MultipartTransferSetup.exe
![]()
启用分片传输功能
以本地仓库路径 为例:
Linux/macOS
multipart-transfer --lfs-enable-multipart
Windows
multipart-transfer.exe --lfs-enable-multipart
上传 LFS 文件插件启用后,直接推送即可。工具会自动检测是否为大文件并接管上传。
git push origin master
支持断点续传(默认开启)上传大文件中断后,只要已上传 ≥300MB,即可从断点继续,不必从头开始。

如你有大模型权重需要上传,或者想摆脱 LFS 上传失败的烦恼,不妨试试这款轻量工具。如需帮助或想参与共建,欢迎访问项目仓库:https://gitee.com/oscstudio/gitee-lfs-multipart-uploader

特别声明:以上内容(如有图片或视频亦包括在内)为自媒体平台“网易号”用户上传并发布,本平台仅提供信息存储服务。
Notice: The content above (including the pictures and videos if any) is uploaded and posted by a user of NetEase Hao, which is a social media platform and only provides information storage services.