Strapi 是一个强大且灵活的开源 CMS，用于构建自定义 API，管理内容非常方便。阿里云 OSS（对象存储服务）则是一种高可用的分布式存储服务，常用于存储和管理非结构化数据。本文将手把手教你如何在 Strapi V4 中集成阿里云 OSS，实现内容的云端存储。
1. 前期准备工作
在开始之前，请确保以下几点准备工作完成：
• 注册阿里云账号，并在控制台开通 OSS 服务。
• 安装 Strapi：确保你已经安装好了 Strapi，若没有安装，可以通过以下命令安装：
npx create-strapi-app my-project --quickstart
2. 创建阿里云 OSS 存储桶
-
登录阿里云控制台，进入 OSS 管理控制台。
-
创建一个新的存储桶（Bucket），区域选择你所需的（如 oss-cn-beijing 等）。
-
设置存储桶权限，通常选择 公共读（ACL: Public Read） 以便于公开访问图片等文件资源。
3. 获取阿里云 OSS 的 AccessKey
-
在阿里云控制台的 AccessKey 管理 页面，获取 AccessKey ID 和 AccessKey Secret。如果没有 AccessKey，可以创建一个新的。
-
保存好这些信息，将在接下来的配置中使用。
4. 安装 Strapi 的阿里云 OSS 插件
在 Strapi 中，我们可以通过社区插件实现 OSS 的文件存储功能。在终端中进入你的 Strapi 项目目录，运行以下命令安装 OSS 插件：
npm install strapi-provider-upload-ali-oss
注意：此插件的包名可能会有所变化，请确保安装的是与当前 Strapi 版本兼容的插件。
5. 配置 Strapi 中的阿里云 OSS 插件
安装完插件后，我们需要对插件进行配置。打开 Strapi 项目中的 config/plugins.js 文件（若没有此文件，可以新建一个），并添加以下代码：
module.exports = ({ env }) => ({
upload: {
config: {
provider: 'strapi-provider-upload-ali-oss',
providerOptions: {
accessKeyId: env('OSS_ACCESS_KEY_ID'), // 阿里云 AccessKey ID
accessKeySecret: env('OSS_ACCESS_KEY_SECRET'), // 阿里云 AccessKey Secret
region: env('OSS_REGION'), // OSS 区域，如 'oss-cn-beijing'
bucket: env('OSS_BUCKET'), // 存储桶名称
url: env('OSS_URL', 'https://<your-bucket-name>.<region>.aliyuncs.com'), // 文件访问 URL
timeout: env.int('OSS_TIMEOUT', 60000), // 超时时间，可选
},
},
},
});
然后，在项目根目录下的 .env 文件中，填入刚刚在阿里云获取到的信息：
OSS_ACCESS_KEY_ID=你的AccessKey ID
OSS_ACCESS_KEY_SECRET=你的AccessKey Secret
OSS_REGION=你的OSS区域 # 如 oss-cn-beijing
OSS_BUCKET=你的存储桶名称
OSS_URL=https://<your-bucket-name>.<region>.aliyuncs.com
确保将上述信息替换为实际的值。
6. 重启 Strapi 服务
配置完成后，重启 Strapi 服务以使配置生效：
npm run develop
7. 测试上传文件
进入 Strapi 后台，在 Media Library（媒体库） 中尝试上传一张图片或其他文件。上传成功后，可以点击文件查看其 URL，确保文件已经成功存储到阿里云 OSS 上。
常见问题与解答
-
文件上传失败或无法访问：检查存储桶权限是否为公共读，或确保配置中的 OSS 信息正确无误。
-
URL 配置问题：确保在 .env 文件中正确配置 OSS_URL，并确认 bucket 名称和区域拼接正确。
总结
通过上述简单的步骤，我们成功地将 Strapi V4 与阿里云 OSS 集成起来，使文件可以安全、方便地存储在阿里云对象存储中。这种方式不仅可以减轻服务器压力，还能通过 CDN 等优化文件访问速度。希望本文对你有所帮助。
