在大模型部署過程中,上傳模型參數文件一直是個難題。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.