# obs-sync

**Repository Path**: flexus-agent/obs-sync

## Basic Information

- **Project Name**: obs-sync
- **Description**: obs文件同步
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-03
- **Last Updated**: 2026-03-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# obs-sync

## 介绍
obs文件同步

## 软件架构
1）将华为云SMB团队运营的OBS桶中的大模型文件通过华为云内网传输复制到同Region的客户的桶里，每个region的源端桶都存放常见的大模型文件，源端桶名都相同。

2）华为云提供的OBSUTIL工具可让两个桶之间进行数据复制，并且流量不穿透过OBSUTIL机器。

3）权限和安全是一个重要因素，客户不可能将其AK、SK暴露给华为云SMB团队，华为云SMB团队的AK、SK也不能暴露给客户，因此使用云厂商对象存储服务都具备的临时安全Token机制。SMB团队运营一台颁发临时安全Token服务器。客户的服务器通过HTTPS协议从Token机器获取临时的AK、SK和Token，以具备访问源端桶的能力。客户的服务器保存自身的长期AK、SK，以访问客户自己的桶。

4）客户服务器以对象存储服务作为数据库，不使用传统mysql服务，以减少组件，最大程度使系统得到简化。

5）SMB团队运营一台服务器，只用于为客户颁发临时Token，不需要使用数据库。

![img.png](img.png)


## 使用说明

### sts模式
服务端发放临时秘钥。

#### 配置
创建配置文件.env.sts，参考.env.template文件

```bash
# 编译镜像
docker build -t obs-sync-manager:0.2 .

# 容器配置
cp .env.template .env.sts
# 修改容器配置
vim .env.sts

#启动 STS 模式
cp docker-compose.yml.template docker-compose.yml
docker compose --env-file .env.sts up -d obs-sync-sts
```

#### 接口url
##### 获取临时凭证
GET /api/center/token?ts=

### task模式
客户端下载/复制obs文件

#### 配置
创建配置文件.env.task，参考.env.template文件

```bash
# 编译镜像
docker build -t obs-sync-manager:0.2 .

# 容器配置
cp .env.template .env.task
# 修改容器配置
vim .env.task

# 启动 TASK 模式
cp docker-compose.yml.template docker-compose.yml
docker compose --env-file .env.task up -d obs-sync-task
```

#### 接口url
##### 创建任务
POST /api/task?modelName=&taskType=

taskType枚举
TaskTypeLocal  = "local"  // 模型储存本地
TaskTypeBucket = "bucket" // 模型储存obs

##### 查询任务信息
GET /api/task?id=

##### 查询模型信息
GET /api/fetch/models