# Cloudinary 提供商

> Source: https://strapi.nodejs.cn/cms/configurations/media-library-providers/cloudinary

🌐 Cloudinary provider

`@strapi/provider-upload-cloudinary` 包允许你将媒体库资源存储在  [Cloudinary](https://cloudinary.com/) 上。本页介绍使用你的 Cloudinary 云名称、API 密钥和 API 密码进行的安装和配置。

[媒体库](/cms/features/media-library) 功能由一个名为 Upload 的后端服务器包提供支持，该包利用了提供程序的使用。

🌐 The [Media Library](/cms/features/media-library) feature is powered by a back-end server package called Upload which leverages the use of providers.

Strapi 为媒体库维护了 3 个提供者。本页介绍  [Cloudinary](https://cloudinary.com/)  提供者的安装和配置。有关其他提供者，请参阅 [媒体库页面](/cms/features/media-library#providers) 中的列表。

## 安装 {#installation}

🌐 Installation

要安装官方 Strapi 维护的 Cloudinary 提供程序，请在终端中运行以下命令：

🌐 To install the official Strapi-maintained Cloudinary provider, run the following command in a terminal:

```bash
yarn add @strapi/provider-upload-cloudinary
```

```bash
npm install @strapi/provider-upload-cloudinary --save
```

## 配置 {#configuration}

🌐 Configuration

提供者配置在 [ `/config/plugins` 文件](/cms/configurations/plugins) 中定义。如果此文件不存在，请先创建它。提供者配置接受以下条目：

🌐 Providers configuration is defined in [the `/config/plugins` file](/cms/configurations/plugins). If this file does not exist, create it first. The provider configuration accepts the following entries:

* `provider` 用于定义提供者名称（即 `cloudinary`）
* `providerOptions` 用于定义在构建提供者期间传递的选项（完整选项列表见 [Cloudinary documentation](https://cloudinary.com/documentation/cloudinary_sdks#configuration_parameters) ）
* `actionOptions` 用于定义直接传递给每个方法参数的选项。官方的 Cloudinary 文档列出了 [upload/uploadStream](https://cloudinary.com/documentation/image_upload_api_reference#upload_optional_parameters) 和 [delete](https://cloudinary.com/documentation/image_upload_api_reference#destroy_optional_parameters)可用的选项。

```js title="/config/plugins.js"
module.exports = ({ env }) => ({
  // ...
  upload: {
    config: {
      provider: 'cloudinary',
      providerOptions: {
        cloud_name: env('CLOUDINARY_NAME'),
        api_key: env('CLOUDINARY_KEY'),
        api_secret: env('CLOUDINARY_SECRET'),
      },
      actionOptions: {
        upload: {},
        uploadStream: {},
        delete: {},
      },
    },
  },
  // ...
});
```

```ts title="/config/plugins.ts"

  // ...
  upload: {
    config: {
      provider: 'cloudinary',
      providerOptions: {
        cloud_name: env('CLOUDINARY_NAME'),
        api_key: env('CLOUDINARY_KEY'),
        api_secret: env('CLOUDINARY_SECRET'),
      },
      actionOptions: {
        upload: {},
        uploadStream: {},
        delete: {},
      },
    },
  },
  // ...
});
```

:::note Notes

* Strapi 有一个默认的 [`security` 中间件](/cms/configurations/middlewares#security)，它有一个非常严格的 `contentSecurityPolicy`，只允许加载 `"'self'"` 的图片和媒体。有关更多信息，请参见  [provider page](https://www.npmjs.com/package/@strapi/provider-upload-aws-s3)  上的示例配置或 [中间件文档](/cms/configurations/middlewares#security)。
* 在每个环境使用不同的提供者时，请在 `/config/env/${yourEnvironment}/plugins.js|ts` 中指定正确的配置（参见 [environments](/cms/configurations/environment)）。

:::