ossimport 是什么
ossimport 是阿里云提供的对象数据迁移工具：部署在自有服务器上，把本地目录或其他云存储的数据迁移到 OSS。它的工作方式是读配置文件：全局参数描述凭据与并发，任务配置描述源端类型、源路径、目标桶与迁移规则，然后由启动脚本拉起任务，控制台与日志里看进度。相比服务端拉取的方式，它跑在自己可控的机器上，带宽与并发都能自己调，适合专线环境内的批量搬迁。
基本信息
| 部署形态 | 单机版与分布式版，按数据量与带宽需求选择 |
|---|---|
| 配置文件 | sys.properties 等全局参数加任务配置，描述源端与目标端 |
| 主要能力 | 增量迁移、断点续传、并发控制、失败重试 |
| 运行方式 | 启动脚本拉起任务，控制台查看进度与统计 |
| 运行环境 | 需要 Java 运行环境，部署在可访问源端与 OSS 的服务器上 |
| 典型限制 | 并发过高会打满源端带宽，影响同机的其他业务 |
典型使用场景
- 本地文件服务器上云：把存量目录整体迁移到 OSS
- 跨云对象搬迁：从其他云的对象存储把数据搬到 OSS
- 专线环境迁移：用自己控制的并发与限速，避免占满专线
- 分批次搬迁：按目录或业务线拆分任务，失败影响面可控
- 增量追平：源端仍在写入时重复运行任务，把差量补齐
- 大规模小文件搬迁：通过并发参数与机器数量横向扩展吞吐
使用要点
使用要点
# 1) 编辑配置：源类型（本地目录 / 其他对象存储）/ 源路径 / 目标 bucket / 并发与分片大小
# 2) 启动任务（Linux 单机版示例）：
# bash start.sh
# 3) 观察日志与统计，确认无失败分片；失败项按日志重试
# 4) 对仍在写入的源端：重复运行任务做差量追平，直到增量收敛
# 5) 迁移完成后抽样比对：对象数量、总容量与内容摘要
# 提示：先小批量试跑，确认权限、命名与目录层级映射符合预期再放大配置与核对要点
| 项目 | 作用 | 常见问题 |
|---|---|---|
| 源端类型与路径 | 指定从哪里读数据 | 路径末尾斜杠处理不当，目录层级与预期不一致 |
| 目标桶与前缀 | 指定数据落到哪里 | 前缀写错导致数据散落或覆盖既有目录 |
| 并发与分片 | 控制吞吐与请求压力 | 并发过大触发源端限流，反而更慢 |
| 增量规则 | 决定已有对象是否重新传输 | 规则配错导致重复全量传输，浪费时间 |
| 凭据 | 访问源端与 OSS 的授权 | 权限过大存在风险，权限过小中途失败 |
| 日志与统计 | 判断任务成功与否 | 只看任务结束不看失败分片，漏传未发现 |
迁移前先确认目标桶的命名与权限规则：对象存储的桶名有全局唯一与字符限制，源端目录名直接映射过去可能不符合要求。
迁移用的凭据权限应限定在目标桶范围内：给到账号级的高权限，一旦配置文件泄露，损失面会远超迁移所需。