> 本文整理自平台文档 docs/wujies/5.x/ruoyi-vue-plus/framework/basic/oss.mdx,用于站点内容演示。
(https://console.wujies.cn/remote-apps/cms-assets/doc-bf9a29d95a69-cover.svg)
- - -
重点注意事项
- 访问站点不要携带路径(如
/、/ruoyi) - 阿里云与腾讯云:访问站点中不要包含桶名,系统会自动处理
- MinIO:站点不建议使用
localhost,请使用127.0.0.1 - 访问站点与自定义域名不要包含
http/https前缀,HTTPS 请使用配置项控制 - 4.4.0 版本支持配置公有/私有权限(阿里云需开启跨域配置)
代码使用
参考 SysOssService.upload 的用法。 使用 OssFactory.instance() 获取当前启用的 OssClient 实例,执行上传并保存返回结果到业务表。
OssFactory.instance()获取当前默认启用的 OSS 配置OssFactory.instance("configKey")可显式指定某一套配置- 如果系统开启了多租户,框架会按“租户 + 配置键”区分 OSS 客户端实例,避免不同租户相同
configKey相互覆盖

功能配置
### 1. 配置 OSS
进入 系统管理 -> 文件管理 -> 配置管理 填写 OSS 配置。
<br /> <br /> 
重点说明:云厂商只需修改 访问站点 对应域名,尽量不要修改其他参数。 云厂商建议绑定自定义域名使用(七牛云为强制要求)。

示例:
- 七牛云访问站点
<br /> 
- 阿里云访问站点

- 腾讯云访问站点

### 2. MinIO 使用 HTTPS 访问
注意:S3 API 签名算法不支持托管 MinIO Server API 的代理方案。
[minio https 配置方式](https://blog.csdn.net/Michelle_Zhong/article/details/126484358)
### 3. 切换 OSS 配置
在配置列表中点击 状态 启用即可(一次仅能启用一个默认配置)。 也可使用 OssFactory.instance("configKey") 指定配置。
如果你的业务要区分“图片、附件、私有文件”等不同存储策略,优先通过多套 OSS 配置切换,不建议在一套配置里混放所有场景。

### 4. 扩展分类
如需文件分类,建议创建多个 OSS 配置进行切换存储:
- 通过不同
configKey/ 前缀目录区分 - 或使用独立桶(可分别设置访问权限)

指定配置示例:
OssClient client = OssFactory.instance("image");

功能使用
### 上传文件或图片
在 系统管理 -> 文件管理 中点击 上传文件 或 上传图片。
<br /> <br /> <br /> 
### 列表展示与预览
默认展示图片(可预览),文件显示路径。
<br /> 
可通过 预览禁用/启用 切换展示方式:

禁用后图片会显示为路径:

也可在 参数设置 中将 OSS预览列表资源 设为 false 统一关闭预览:
对应参数键:sys.oss.previewListResource

### 删除与下载
删除会根据 OSS 服务商类型调用对应删除接口。 可勾选多服务商类型文件进行批量删除。
 
下载可填写文件名并确认:
 
本文导览
(https://console.wujies.cn/remote-apps/cms-assets/doc-bf9a29d95a69-guide.svg)


评论区需要浏览器启用 JavaScript 才能加载。