Cloudinary

Cloudinary

这是 Cloudinary 平台的后端。

关于 Cloudinary

Cloudinary 是一个图像和视频 API 平台。它受到 150 万开发者以及 10000 家企业和高速增长型公司的信赖,是他们技术栈中用于提供视觉上引人入胜体验的关键部分。

账户与定价

要使用此后端,你需要在 Cloudinary 上 创建一个免费账户。可以先从具有慷慨使用限制的免费计划开始。然后,随着需求的增长,升级到最适合你需求的计划。请参阅 定价详情

保护你的凭证

请参考 文档

配置

以下是一个进行 Cloudinary 配置的示例。

首先,创建一个 cloudinary.com 账户并选择一个计划。

你需要登录并从开发者板块获取你账户的 API 密钥API 密钥密码

现在运行

rclone config

按照交互式设置过程操作:

No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n

Enter the name for the new remote.
name> cloudinary-media-library

Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
[snip]
XX / cloudinary.com
\ (cloudinary)
[snip]
Storage> cloudinary

Option cloud_name.
You can find your cloudinary.com cloud_name in your [dashboard](https://console.cloudinary.com/pm/developer-dashboard)
Enter a value.
cloud_name> ****************************

Option api_key.
You can find your cloudinary.com api key in your [dashboard](https://console.cloudinary.com/pm/developer-dashboard)
Enter a value.
api_key> ****************************

Option api_secret.
You can find your cloudinary.com api secret in your [dashboard](https://console.cloudinary.com/pm/developer-dashboard)
This value must be a single character, one of the following: y, g.
y/g> y
Enter a value.
api_secret> ****************************

Option upload_prefix.
[Upload prefix](https://cloudinary.com/documentation/cloudinary_sdks#configuration_parameters) to specify alternative data center
Enter a value.
upload_prefix>

Option upload_preset.
[Upload presets](https://cloudinary.com/documentation/upload_presets) can be defined for different upload profiles
Enter a value.
upload_preset>

Edit advanced config?
y) Yes
n) No (default)
y/n> n

Configuration complete.
Options:
- type: cloudinary
- api_key: ****************************
- api_secret: ****************************
- cloud_name: ****************************
- upload_prefix:
- upload_preset:

Keep this "cloudinary-media-library" remote?
y) Yes this is OK (default)
e) Edit this remote
d) Delete this remote
y/e/d> y

列出媒体库顶级目录

rclone lsd cloudinary-media-library:

创建一个新目录。

rclone mkdir cloudinary-media-library:directory

列出目录的内容。

rclone ls cloudinary-media-library:directory

修改时间和哈希值

Cloudinary 会自动为任何成功的上传操作存储 MD5 哈希值和时间戳,并且这些信息是只读的。

标准选项

以下是 Cloudinary 特有的标准选项。

–cloudinary-cloud-name

Cloudinary 环境名称

属性:

  • 配置项:cloud_name
  • 环境变量:RCLONE_CLOUDINARY_CLOUD_NAME
  • 类型:字符串
  • 是否必需:是

–cloudinary-api-key

Cloudinary API 密钥

属性:

  • 配置项:api_key
  • 环境变量:RCLONE_CLOUDINARY_API_KEY
  • 类型:字符串
  • 是否必需:是

–cloudinary-api-secret

Cloudinary API 密钥密码

属性:

  • 配置项:api_secret
  • 环境变量:RCLONE_CLOUDINARY_API_SECRET
  • 类型:字符串
  • 是否必需:是

–cloudinary-upload-prefix

为美国以外的环境指定 API 端点

属性:

  • 配置项:upload_prefix
  • 环境变量:RCLONE_CLOUDINARY_UPLOAD_PREFIX
  • 类型:字符串
  • 是否必需:否

–cloudinary-upload-preset

选择上传时资产处理方式的上传预设

属性:

  • 配置项:upload_preset
  • 环境变量:RCLONE_CLOUDINARY_UPLOAD_PRESET
  • 类型:字符串
  • 是否必需:否

高级选项

以下是 Cloudinary 特有的高级选项。

–cloudinary-encoding

后端的编码方式。

有关更多信息,请参阅 概述中的编码部分

属性:

  • 配置项:encoding
  • 环境变量:RCLONE_CLOUDINARY_ENCODING
  • 类型:编码方式
  • 默认值:斜杠、小于号大于号、双引号、问号、星号、竖线、井号、百分号、反斜杠、删除符、控制字符、右空格、无效 UTF-8、点号

–cloudinary-eventually-consistent-delay

等待 N 秒以确保支持后端操作的数据库最终一致性

属性:

  • 配置项:eventually_consistent_delay
  • 环境变量:RCLONE_CLOUDINARY_EVENTUALLY_CONSISTENT_DELAY
  • 类型:时长
  • 默认值:0 秒

–cloudinary-description

远程存储的描述。

属性:

  • 配置项:description
  • 环境变量:RCLONE_CLOUDINARY_DESCRIPTION
  • 类型:字符串
  • 是否必需:否