OSS功能

重点注意事项复制标题链接

• 访问站点不要携带路径（如 /、/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 配置。

重点说明：云厂商只需修改 访问站点 对应域名，尽量不要修改其他参数。
云厂商建议绑定自定义域名使用（七牛云为强制要求）。

示例：

• 七牛云访问站点

• 阿里云访问站点

• 腾讯云访问站点

2. MinIO 使用 HTTPS 访问复制标题链接

注意：S3 API 签名算法不支持托管 MinIO Server API 的代理方案。

minio https 配置方式

3. 切换 OSS 配置复制标题链接

在配置列表中点击 状态 启用即可（一次仅能启用一个默认配置）。
也可使用 OssFactory.instance("configKey") 指定配置。

如果你的业务要区分“图片、附件、私有文件”等不同存储策略，优先通过多套 OSS 配置切换，不建议在一套配置里混放所有场景。

4. 扩展分类复制标题链接

如需文件分类，建议创建多个 OSS 配置进行切换存储：

• 通过不同 configKey / 前缀目录区分
• 或使用独立桶（可分别设置访问权限）

指定配置示例：

OssClient client = OssFactory.instance("image");

功能使用复制标题链接

上传文件或图片复制标题链接

在 系统管理 -> 文件管理 中点击 上传文件 或 上传图片。

列表展示与预览复制标题链接

默认展示图片（可预览），文件显示路径。

可通过 预览禁用/启用 切换展示方式：

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

也可在 参数设置 中将 OSS预览列表资源 设为 false 统一关闭预览：

对应参数键：sys.oss.previewListResource

删除与下载复制标题链接

删除会根据 OSS 服务商类型调用对应删除接口。
可勾选多服务商类型文件进行批量删除。

下载可填写文件名并确认：