# gitee-lfs-multipart-uploader

**Repository Path**: oscstudio/gitee-lfs-multipart-uploader

## Basic Information

- **Project Name**: gitee-lfs-multipart-uploader
- **Description**: gitee lfs高速对象存储直传工具
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-04-16
- **Last Updated**: 2025-10-21

## Categories & Tags

**Categories**: networklib

**Tags**: None

## README

# gitee-lfs-multipart-uploader

#### 介绍
gitee lfs高速对象存储直传工具

#### 构建要求
|名称|版本|
|:-|:-|
|golang|1.21 or later|
|make|-|

#### 编译 && 安装
```
$ git clone https://gitee.com/oscstudio/gitee-lfs-multipart-uploader.git
$ cd gitee-lfs-multipart-uploader
$ make

# 确认版本信息
$ ./multipart-transfer -v
```

PS：可以将编译输出的multipart-transfer文件放入path目录，方便后期使用

#### 使用

1. 下载插件（一键安装）

Linux/Unix
```shell
# multipart-transfer会被安装在/usr/local/bin中
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/latest)页面
> 2. 下载`MultipartTransferSetup.exe`，并双击执行
> 3. 选择安装位置，执行完毕

2. 启用插件

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

Linux
```shell
$ multipart-transfer --lfs-enable-multipart <repo_path>

# 例如仓库放在/home/git/repo
$ multipart-transfer --lfs-enable-multipart /home/git/repo
```

Windows
```shell
$ multipart-transfer.exe --lfs-enable-multipart <repo_path>

# 例如仓库在/c/Users/SURA9/Desktop/work-space/repo
$ multipart-transfer.exe --lfs-enable-multipart /c/Users/SURA9/Desktop/work-space/repo
```

3. 推送lfs文件
启用插件后，不需要额外操作，直接推送即可，插件会在需要时自动运行
```shell
git push origin master
```

## 断点续传

启用`分片传输插件`后，默认启用断点续传特性，大文件上传过程中（至少上传300MB之后）若发生中断，不会丢失所有进度
![resume-transfer](./docs/images/resume-transfer.gif)