A plugin for NodeBB to take file uploads and store them on Aliyun OSS.
npm install nodebb-plugin-alioss-uploads-updated
Plugin Version | Dependency | Version Requirement |
---|---|---|
1.1.2 | NodeBB | >= 3.2.0 |
You can configure this plugin via a combination of the below, for instance, you can use environment variables. You can also configure via the NodeBB Admin panel, which will result in the Bucket and Credentials being stored in the NodeBB Database.
If you choose to use the Database storage for Credentials, then they will take precedence over Environment Variables, the full load order is:
- Database
- Environment Variables
export OSS_ACCESS_KEY_ID="your_access_key_id"
export OSS_SECRET_ACCESS_KEY="your_secret_access_key"
export OSS_DEFAULT_REGION="oss-cn-hangzhou"
export OSS_UPLOADS_BUCKET="your_bucket"
export OSS_UPLOADS_HOST="host"
export OSS_UPLOADS_PATH="path"
NOTE: Asset host is optional - If you do not specify an asset host, then the default asset host is <bucket>.<endpoint>.aliyuncs.com
.
NOTE: Asset path is optional - If you do not specify an asset path, then the default asset path is /
.
From the NodeBB Admin panel, you can configure the following settings to be stored in the Database:
bucket
— The OSS bucket to upload intohost
- The base URL for the asset. Typcially http://<bucket>.<endpoint>.aliyuncs.comregion
- The endpoint of the OSS. like oss-cn-hangzhoupath
- The asset path (optional)accessKeyId
— The OSS Access Key IdsecretAccessKey
— The OSS Secret Access Key
NOTE: Storing your OSS Credentials in the database is bad practice, and you really shouldn't do it.
Feel free to fork and pull request.
- Recommended to install nodebb before local install
- Install plugin dependencies before link (I'm not sure that's necessary)
If the plugin is already installed and active, simply click Rebuild & Restart
after the code update.
- NodeBB S3 Uploads Plugin
- NodeBB Aliyun OSS Plugin (Outdated version)