当前位置：首页 > news >正文

大疆司空平台接入实战：司空 Sync文件同步

news 2026/3/26 18:06:46

前言

在前面的文章中，我们已经介绍了 [大疆司空平台 OpenAPI 无权限异常排查] 和 [Java SDK 开发指南]。本文将继续深入讲解司空 Sync 文件同步的完整配置流程。

提示：司空 Sync 是大疆司空平台提供的数据同步服务，支持将无人机拍摄的照片、视频、直播回放等文件自动同步到用户自建的 OSS 存储桶中，便于后续的数据管理和分析。

本文将从OSS 存储桶创建、RAM 用户权限配置、司空 Sync 设置三个方面，详细介绍如何搭建一套完整的文件同步系统。

一、司空 Sync 概述

1.1 什么是司空 Sync

司空 Sync（DJI FlightHub Sync）是大疆司空平台提供的云边协同数据同步服务。它允许用户将无人机作业过程中产生的各类媒体文件，自动同步到指定的第三方云存储服务中。

特性	说明
支持的文件类型	照片、视频、直播回放、建图成果
支持的云存储	阿里云 OSS、腾讯云 COS、华为云 OBS
同步方式	增量同步、全量同步
同步状态	实时显示同步进度和状态

1.2 应用场景

在实际的无人机作业场景中，司空 Sync 主要有以下应用：

数据备份：将无人机拍摄的文件自动备份到云端，防止本地数据丢失
团队协作：团队成员可以直接从 OSS 获取最新的航拍数据
后续处理：为后续的 AI 分析、三维建模等提供数据源
合规存档：满足行业监管对航拍数据长期保存的要求

注意：文件同步功能需要司空平台组织管理员权限才能配置。

二、创建 OSS 存储桶

2.1 登录阿里云控制台

首先，访问阿里云官网并登录您的账号。如果没有账号，需要先注册并完成实名认证。

2.2 创建存储桶

登录阿里云控制台，进入OSS 对象存储服务
点击"创建 Bucket"按钮
填写 Bucket 名称，这里假设创建的存储桶名称是dji-files
选择地域，建议选择离您作业地点较近的地域
存储类型选择"标准存储"，适用于频繁访问的航拍数据

图 1：创建 OSS 存储桶界面

2.3 配置访问权限

在 OSS 详情配置中，找到权限控制，分别设置是否允许公共访问和读写权限：

权限类型	推荐设置	说明
读写权限	私有	防止未授权写入
公共访问	公共读	允许团队成员查看下载

图 2：OSS 权限配置界面

提示：如果您的数据涉及敏感信息，建议保持"私有"读写权限，通过 RAM 用户授权方式控制访问。

三、阿里云创建 AK 和 SK

3.1 创建 RAM 用户

打开阿里云控制台，进入RAM 访问控制服务
在左侧导航栏点击"用户"，然后点击"创建用户"
创建时勾选使用永久 AccessKey 访问
这里假定我们创建的 RAM 用户名称是司空 OSS 文件同步

图 3：创建 RAM 用户界面

创建成功后，请立即保存 AccessKey ID 和 AccessKey Secret，后续配置司空 Sync 时需要使用。

3.2 创建权限策略

进入权限策略页面，点击"创建权限策略"，选择脚本编辑器模式。

图 4：权限策略脚本编辑器

3.2.1 官方样例问题分析

官方文档提供的"权限配置代码样例"存在一个问题：按照官方样例配置后，会出现"连通失败，请检查 IP 和端口填写是否正确，检查网络状态"的错误提示。

经过实际测试，官方样例缺少了必要的列举和获取权限，导致司空平台无法验证存储桶的连通性。

3.2.2 推荐的权限策略

建议配置权限策略如下，将 bucket 名称替换成自己的，这里假设 bucket 名称是dji-files：

{"Version":"1","Statement":[{"Effect":"Allow","Action":["oss:Get*","oss:List*","oss:ListParts","oss:ListObjects","oss:GetObject","oss:GetObjectTagging","oss:PutObjectTagging","oss:PutObject","oss:AbortMultipartUpload"],"Resource":["acs:oss:*:*:dji-files","acs:oss:*:*:dji-files/*"]}]}

关键点说明：

权限 Action	用途
`oss:Get*`	获取 Bucket 信息，用于连通性测试
`oss:List*`	列举对象，用于同步状态检查
`oss:PutObject`	上传文件，核心写入权限
`oss:AbortMultipartUpload`	取消分片上传，异常处理需要

重要提示：官方给的"权限配置代码样例"有问题，会出现"连通失败，请检查 IP 和端口填写是否正确，检查网络状态"，这里我们加上oss:Get*和oss:List*以解决这一问题。

3.3 保存权限策略

点击"保存"按钮，填写权限策略名称，如SikongUploadOnlyTest。

3.4 授权 RAM 用户

在权限策略详情页面：

点击授权管理标签页
点击"新增授权"按钮
选择上面创建的 RAM 用户司空 OSS 文件同步
将本权限策略授权给该 RAM 用户

图 5：RAM 用户授权界面

四、设置司空 Sync

4.1 进入司空 Sync 配置页面

打开大疆司空平台，找到组织列表，点击组织设置，进入司空 Sync 配置页面。

图 6：司空 Sync 配置入口

4.2 找到文件同步配置

在左侧导航栏找到直播与数据存储中的文件同步选项，点击进入配置页面。

图 7：文件同步配置入口

五、编辑存储桶配置

5.1 填写 OSS 配置信息

按照页面提示，依次填写以下配置信息：

配置项	说明	示例值
云服务提供商	选择云存储类型	阿里云 OSS
地域	OSS Bucket 所在地域	华东 1（杭州）
Bucket 名称	步骤二创建的存储桶名称	dji-files
AccessKey ID	步骤三创建的 RAM 用户 AK	LTAI5t…
AccessKey Secret	对应的 SK	xxxxxxxxxxxx
目录前缀	可选，用于分类存储	dji-photos/