Strapi plugin logo for Qiniu Cloud

Qiniu Cloud

A provider for strapi server to upload file to Qiniu Cloud


A provider for strapi server to upload file to Qiniu Cloud


  • Node.js >= 14
  • npm > 8


$ npm install provider-upload-qiniu-cloud --save


$ yarn add provider-upload-qiniu-cloud --save

For more details, please see:


Strapi v4

The lastest version of the provider supports v4 by default. See example below for ./config/plugins.js:

module.exports = ({ env }) => ({
  upload: {
    config: {
      provider: 'provider-upload-qiniu-cloud', // full package name is required
      providerOptions: {
        accessKey: env('ACCESS_KEY', ''),
        secretKey: env('SECRET_KEY', ''),
        prefix: env('PREFIX', ''),
        zone: env('ZONE', 'Zone_z0'),
        bucket: env('BUCKET', ''),
        publicBucketDomain: env('PUBLIC_BUCKET_DOMAIN', ''),
        https: env('HTTPS', true),
        cdn: env('CDN', false),

Official documentation here

Security Middleware Configuration

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. You should replace strapi::security string with the object bellow instead as explained in the middleware configuration documentation.


module.exports = [
  // ...
    name: 'strapi::security',
    config: {
      contentSecurityPolicy: {
        useDefaults: true,
        directives: {
          'connect-src': ["'self'", 'https:'],
          'img-src': ["'self'", 'data:', 'blob:', '*'],
          'media-src': ["'self'", 'data:', 'blob:', '*'],
          upgradeInsecureRequests: null,
  // ...

Provider Options

accessKeystring<qiniu access key id>
secretKeystring<qiniu access key secret>
bucketstringbucket name
prefixstringdir name in bucket
zonestringqiniu region (see Qiniu Development Documentation below)
publicBucketDomainstringcustom origin domain name for accessing the uploaded file, e.g. // example:
httpsbooleanDomain with or without https
cdnbooleanWhether to use cdn acceleration when uploading

Qiniu Development Documentation

Install now

npm install provider-upload-qiniu-cloud

Last updated

76 days ago

Strapi Version

Supports V3


github profile image for WilliamYang

Related plugin


Useful links

Create your own plugin

Check out the available plugin resources that will help you to develop your plugin or provider and get it listed on the marketplace.