Skip to main content

为 Strapi Cloud 上传提供商配置

🌐 Upload Provider Configuration for Strapi Cloud

Page summary:

像 S3 或 Cloudinary 这样的外部存储需要插件设置、安全中间件和云变量。

Strapi Cloud 开箱即用带有本地上传提供者。不过，如果需要，它也可以配置为使用第三方上传提供者。

🌐 Strapi Cloud comes with a local upload provider out of the box. However, it can also be configured to use a third-party upload provider, if needed.

Note

有关适用于上传的文件大小和基于内存的限制，请参见 Strapi Cloud 上传大小限制。

🌐 For the file size and memory-based limits that apply to uploads, see Upload size limits for Strapi Cloud.

配置第三方上传提供商​

🌐 Configuring a third-party upload provider

Caution

请注意，Strapi 无法为第三方上传提供商提供支持。

🌐 Please be advised that Strapi is unable to provide support for third-party upload providers.

Prerequisites
  • 一个在 v4.8.2+ 上运行的本地 Strapi 项目。
  • 第三方上传提供者的凭证（参见 Strapi Market）。

为在 Strapi Cloud 中使用第三方上传提供商进行配置，需要以下四个配置步骤，然后进行部署：

🌐 Configuring a third-party upload provider for use with Strapi Cloud requires the following 4 configuration steps, followed by a deployment:

  1. 在本地 Strapi 项目中安装提供程序插件。
  2. 在本地 Strapi 项目中配置提供者。
  3. 在本地 Strapi 项目中配置安全中间件。
  4. 将环境变量添加到 Strapi Cloud 项目中。

安装提供程序插件​

🌐 Install the provider plugin

使用 npm 或 yarn，按照对应供应商在 Marketplace 中的条目说明，将提供程序插件作为包依赖安装到本地 Strapi 项目中。

配置提供程序​

🌐 Configure the provider

要在你的 Strapi 项目中配置第三方上传提供商，请通过以下方式创建或编辑生产环境 /config/env/production/plugins.js|ts 的插件配置文件，添加上传配置选项如下：

🌐 To configure a third-party upload provider in your Strapi project, create or edit the plugins configuration file for your production environment /config/env/production/plugins.js|ts by adding upload configuration options as follows:


module.exports = ({ env }) => ({
// … some unrelated plugins configuration options
upload: {
   config: {
      // … provider-specific upload configuration options go here
   }
// … some other unrelated plugins configuration options
}
});
Caution

文件结构必须与上述路径完全匹配，否则配置将不会应用到 Strapi 云。

🌐 The file structure must match the above path exactly, or the configuration will not be applied to Strapi Cloud.

每个提供商将有不同的配置设置可用。请查看 Marketplace中该提供商的相应条目。

示例:

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: {},
      },
    },
  },
  // ...
});

配置安全中间件​

🌐 Configure the security middleware

由于 Strapi 安全中间件的默认设置，你需要修改 contentSecurityPolicy 设置才能在媒体库中正确查看缩略图预览。

🌐 Due to the default settings in the Strapi security middleware you will need to modify the contentSecurityPolicy settings to properly see thumbnail previews in the Media Library.

Caution

在 Strapi Cloud 上，NODE_ENV 始终设置为 production。对全局 config/middlewares.ts 文件的更改会在每次部署时被覆盖，因此不会生效。请将你的安全中间件自定义放在 config/env/production/middlewares.ts 中。详情请参见 Strapi Cloud 的中间件配置。

🌐 On Strapi Cloud, NODE_ENV is always set to production. Changes to the global config/middlewares.ts file are overwritten on each deploy and will not take effect. Place your Security Middleware customizations in config/env/production/middlewares.ts instead. See Middleware Configuration for Strapi Cloud for details.

在你的 Strapi 项目中执行此操作：

🌐 To do this in your Strapi project:

  1. 在你的 Strapi 项目中，导航到 /config/env/production/middlewares.js 或 /config/env/production/middlewares.ts。
  2. 用上传提供者提供的对象替换默认的 strapi::security 字符串。

示例:

module.exports = [
  // ...
  {
    name: 'strapi::security',
    config: {
      contentSecurityPolicy: {
        useDefaults: true,
        directives: {
          'connect-src': ["'self'", 'https:'],
          'img-src': [
            "'self'", 
            'data:', 
            'blob:', 
            'market-assets.strapi.io', 
            'res.cloudinary.com'
          ],
          'media-src': [
            "'self'",
            'data:',
            'blob:',
            'market-assets.strapi.io',
            'res.cloudinary.com',
          ],
          upgradeInsecureRequests: null,
        },
      },
    },
  },
  // ...
];
Tip

在将上述更改推送到 GitHub 之前，向 Strapi Cloud 项目添加环境变量，以防在更改完成之前触发项目的重建和新部署。

🌐 Before pushing the above changes to GitHub, add environment variables to the Strapi Cloud project to prevent triggering a rebuild and new deployment of the project before the changes are complete.

Strapi 云配置​

🌐 Strapi Cloud configuration

  1. 登录 Strapi Cloud，然后在“项目”页面上点击相应的项目。
  2. 点击 设置 标签，然后在左侧菜单中选择 变量。
  3. 添加特定于上传提供者的所需环境变量。
  4. 点击 保存。

示例：

变量值
CLOUDINARY_NAMEyour_cloudinary_name
CLOUDINARY_KEYyour_cloudinary_api_key
CLOUDINARY_SECRETyour_cloudinary_secret

部署​

🌐 Deployment

要部署项目并使用第三方上传提供商，请推送之前的更改。这将触发 Strapi Cloud 项目的重新构建和新部署。

🌐 To deploy the project and use the third-party upload provider, push the changes from earlier. This will trigger a rebuild and new deployment of the Strapi Cloud project.

一旦应用构建完成，项目将使用新的上传提供者。

🌐 Once the application finishes building, the project will use the new upload provider.

Custom Provider

如果你想创建自定义上传提供程序，请参阅 CMS 文档中的 Providers 文档。

🌐 If you want to create a custom upload provider, please refer to the Providers documentation in the CMS Documentation.

On this page