strapi-provider-upload-aliyun

0.1.5 • Public • Published

strapi-provider-upload-oss

A provider for strapi server to upload file to Aliyun OSS

Requirements

  • Node.js >= 10
  • npm > 6

Installation

$ npm install strapi-provider-upload-aliyun --save

For more details, please see: https://strapi.io/documentation/v3.x/plugins/upload.html#using-a-provider

Usage

Strapi version > 3.0.0

With a stable release of Strapi 3.0.0, the configuration was moved to a JavaScript file. Official documentation here.

To enable the provider, create or edit the file at ./config/plugins.js.

module.exports = ({ env }) => ({
  upload: {
    provider: 'oss',
    providerOptions: {
      accessKeyId: env('ACCESS_KEY_ID'),
      accessKeySecret: env('ACCESS_KEY_SECRET'),
      region: env('REGION'),
      bucket: env('BUCKET'),
      uploadPath: env('UPLOAD_PATH'),
      baseUrl: env('BASE_URL'),
      timeout: env('TIMEOUT')
    }
  }
});

See below table for description of each provider option.

Strapi Beta or alpha

The description for each fields to fill in strapi's configuration UI are as follows:

Field value
AccessKeyId token <aliyun access key id>
AccessKeySecret token token <aliyun access key secret>
Region OSS region (see reference below)
Bucket bucket name
Upload Path absoulte path to store the file
Base URL to access can be your custom oss url for accessing the uploaded file, e.g. //www.website.com
timeout OSS upload timeout (unit: seconds)
Automatically generate thumbnails (Beta) VIDEO FILES ONLY currently only supports .mp4 file, will generate thumbnail for the video uploaded (screenshot at 00:01 of the video, size: 480x360)

Example:

OSS Region reference

https://help.aliyun.com/document_detail/31837.html#title-qvx-r3a-xr4

Troubleshooting

Q: getting "The bucket you are attempting to access must be addressed using the specified endpoint. Please send all future requests to this endpoint."

A: Check if the OSS region is correct for the bucket you're using

Contribution

This repo is maintained periodically, any contribution is highly welcomed

Readme

Keywords

Package Sidebar

Install

npm i strapi-provider-upload-aliyun

Homepage

strapi.io

Weekly Downloads

1

Version

0.1.5

License

MIT

Unpacked Size

10.5 kB

Total Files

5

Last publish

Collaborators

  • panw3i