阿里云 OSS 上传插件

将系统文件上传到阿里云对象存储（OSS）。

功能特性

• 支持上传图片到阿里云 OSS
• 支持自定义 CDN 域名
• 自动设置缓存策略
• 支持路径风格和虚拟主机风格访问
• 与现有系统上传功能无缝集成
• 支持自动转换为 WebP 格式
• 支持 MD5 哈希作为文件名确保唯一性
• 集成测试连接功能
• 自动检查更新功能
• 完整的更新日志展示

更新检查

插件支持自动检查更新。更新信息从 https://gx.o0v0.com/aliyun-oss-update.txt 获取。

更新文件格式

txt
version: 1.1.0
releaseDate: 2026-06-09
updateUrl: https://bbs.o0v0.com/posts/12
changelog: |
  - 添加版本检查功能
  - 支持从远程获取更新信息
  - 新增更新检查管理卡片
  - 显示完整更新日志和下载链接
  - 优化用户体验和错误处理

安装

1. 将插件文件夹 aliyun-oss 放到项目的 addons/ 目录下
2. 在后台插件管理中安装并启用该插件
3. 进入插件设置页面，填写相关配置

配置说明

必需配置

• Bucket: 阿里云 OSS 的存储空间名称，例如 my-bucket
• Region: 阿里云 OSS 的地域，例如 cn-hangzhou
• Endpoint: 阿里云 OSS 的访问域名（公网 endpoint），格式为 https://oss-cn-hangzhou.aliyuncs.com
• Access Key ID: 阿里云访问密钥 ID
• Access Key Secret: 阿里云访问密钥 Secret

可选配置

• 资源访问基础 URL: 可以配置 CDN 域名，例如 https://cdn.example.com。不配置则使用 OSS 默认访问地址
• 使用路径风格访问: 仅特殊情况需要（如使用旧版 CDN），一般保持关闭
• 自动转换为 WebP 格式: 上传图片时自动转换为 WebP 格式以节省存储空间
• WebP 转换质量: 1-100，建议设置在 75-90 之间
• 使用 MD5 哈希作为文件名: 确保文件名唯一性，避免重复上传相同文件

使用说明

1. 在插件设置页面填写配置信息
2. 点击"测试连接"验证配置是否正确
3. 勾选"启用阿里云 OSS 上传"
4. 保存设置
5. 系统上传的文件将自动上传到 OSS

注意事项

• 请确保阿里云 OSS 已配置正确的 CORS 策略
• 建议 Bucket 权限设置为公共读，私有写
• Access Key 建议使用子账号，并仅授予 OSS 读写权限
• 定期更换 Access Key 以提高安全性

技术实现

本插件使用阿里云 OSS 兼容的 S3 API 接口，通过 @aws-sdk/client-s3 库实现文件上传。

更新日志

v1.1.0 (2026-06-09)

• 添加版本检查功能
• 支持从远程获取更新信息
• 新增更新检查管理卡片
• 显示完整更新日志和下载链接
• 优化用户体验和错误处理

v1.0.1 (2026-05-20)

• 修复日志刷屏问题：移除了插件加载和运行过程中的大量调试日志，仅保留必要的错误日志
• 添加自动转换为 WebP 格式功能
• 支持 MD5 哈希作为文件名确保唯一性
• 集成测试连接功能

v1.0.0

• 初始版本
• 支持上传文件到阿里云 OSS
• 支持自定义 CDN 域名
• 支持路径风格和虚拟主机风格访问
• 支持自动设置缓存策略

Copyright OV 乐在途中-社区 <<https://bbs.o0v0.com>>



应该没有什么问题了，有问题留言吧！
留下你们的5积分吧！