集成阿里云 OSS 对象存储
集成阿里云 OSS 对象存储
ThingsCloud 支持集成阿里云 OSS 对象存储服务,为设备图片上传提供安全、稳定的云端存储空间。集成后,设备通过图片上传服务上报的图片将自动存储到您指定的阿里云 OSS Bucket 中,便于在应用端长期管理和访问。
准备工作
注册阿里云账号并完成企业认证
进入 阿里云 > OSS 对象存储,确保您的账号已完成企业认证。如果还没有阿里云账号,请先完成注册和实名认证流程。
创建 Bucket
进入 OSS 控制台,创建一个新的 Bucket 用于存储设备上传的图片。
Bucket 名称:建议使用英文命名,例如 thingscloud-device-images,名称全局唯一且创建后不可修改。
地域:根据您的业务需要选择。建议遵循以下原则:
| 业务场景 | 推荐地域 |
|---|---|
| 中国大陆为主 | 华东 1(杭州)、华东 2(上海)、华北 2(北京)、华南 1(深圳) |
| 东南亚业务 | 新加坡 |
| 欧洲业务 | 德国(法兰克福) |
| 美国业务 | 美国(硅谷)、美国(弗吉尼亚) |
选择靠近设备或用户所在的地域,可有效降低访问延迟并减少流量费用。
存储类型:选择标准存储。
其余配置项保持默认即可,如下图所示:

创建完成后,记录 Bucket 名称和地域节点,稍后需要填写在 ThingsCloud 集成设置中。
地域节点可以在下边的 Endpoint 中找到,例如 oss-cn-beijing.aliyuncs.com,那么地域节点就是 cn-beijing。
设置阿里云访问 AccessKey
接下来,为您的阿里云账号创建 AccessKey,用于 ThingsCloud 集成访问。
出于安全考虑,这里推荐使用阿里云 RAM 子用户模式的 AccessKey,并授予有限的访问权限。
进入 阿里云 > RAM 访问控制,创建用户,为该用户只添加 AliyunOSSFullAccess 权限。

然后,在子用户的页面中,创建 AccessKey,复制 AccessKey ID 和 AccessKey Secret,随后要填写在 ThingsCloud 集成设置中。
提示
AccessKey Secret 仅在创建时显示一次,请务必妥善保存。如不慎丢失,需要重新创建新的 AccessKey。
填写 ThingsCloud 项目集成设置
进入 ThingsCloud 控制台,在 项目 > 第三方集成 中,找到阿里云对象存储配置项,填写以下信息:
| 配置项 | 说明 |
|---|---|
| AccessKey ID | 阿里云 RAM 用户的 AccessKey ID |
| AccessKey Secret | 阿里云 RAM 用户的 AccessKey Secret |
| 地域节点 | Bucket 所在地域的名称,例如 cn-hangzhou |
| Bucket 名称 | 创建的 OSS Bucket 名称 |
填写完成后,点击保存,平台会发起测试请求来检查参数是否正确。保存成功后,点击启用按钮即可正式生效。
成功启用后,设备通过 图片上传服务 上传的图片,将自动存储到您指定的阿里云 OSS Bucket 中,并生成可供外部访问的图片 URL。