docs(infra): 补充 RustFS S3 接入说明与 MySQL 示例

补充文件客户端的 RustFS 配置注释，沿用现有 S3 存储类型。新增非主的 RustFS MySQL 示例配置，使用占位密钥和私有桶访问。

docs(infra): 补充 RustFS S3 接入说明与 MySQL 示例
补充文件客户端的 RustFS 配置注释，沿用现有 S3 存储类型。新增非主的 RustFS MySQL 示例配置，使用占位密钥和私有桶访问。
YunaiV
1 parent 058223f3
Showing 5 changed files with 12 additions and 5 deletions
sql/mysql/ruoyi-vue-pro.sql
yudao-module-infra/pom.xml
yudao-module-infra/src/main/java/cn/iocoder/yudao/module/infra/framework/file/core/client/s3/S3FileClient.java
yudao-module-infra/src/main/java/cn/iocoder/yudao/module/infra/framework/file/core/client/s3/S3FileClientConfig.java
yudao-module-infra/src/main/java/cn/iocoder/yudao/module/infra/framework/file/package-info.java
@@ -316,6 +316,7 @@ INSERT INTO `infra_file_config` (`id`, `name`, `storage`, `remark`, `master`, `c
 INSERT INTO `infra_file_config` (`id`, `name`, `storage`, `remark`, `master`, `config`, `creator`, `create_time`, `updater`, `update_time`, `deleted`) VALUES (30, 'SFTP 存储（示例）', 12, '', b'0', '{\"@class\":\"cn.iocoder.yudao.module.infra.framework.file.core.client.sftp.SftpFileClientConfig\",\"basePath\":\"/upload\",\"domain\":\"http://127.0.0.1:48080\",\"host\":\"127.0.0.1\",\"port\":2222,\"username\":\"foo\",\"password\":\"pass\"}', '1', '2025-05-02 16:34:10', '1', '2026-07-02 15:35:07', b'0');
 INSERT INTO `infra_file_config` (`id`, `name`, `storage`, `remark`, `master`, `config`, `creator`, `create_time`, `updater`, `update_time`, `deleted`) VALUES (34, '七牛云存储【私有】（示例）', 20, '请换成你自己的密钥！！！', b'0', '{\"@class\":\"cn.iocoder.yudao.module.infra.framework.file.core.client.s3.S3FileClientConfig\",\"endpoint\":\"s3.cn-south-1.qiniucs.com\",\"domain\":\"http://t151glocd.hn-bkt.clouddn.com\",\"bucket\":\"ruoyi-vue-pro-private\",\"accessKey\":\"3TvrJ70gl2Gt6IBe7_IZT1F6i_k0iMuRtyEv4EyS\",\"accessSecret\":\"wd0tbVBYlp0S-ihA8Qg2hPLncoP83wyrIq24OZuY\",\"enablePathStyleAccess\":false,\"enablePublicAccess\":false}', '1', '2025-08-17 21:22:00', '1', '2026-07-02 15:35:07', b'0');
 INSERT INTO `infra_file_config` (`id`, `name`, `storage`, `remark`, `master`, `config`, `creator`, `create_time`, `updater`, `update_time`, `deleted`) VALUES (35, '1', 20, '1', b'0', '{\"@class\":\"cn.iocoder.yudao.module.infra.framework.file.core.client.s3.S3FileClientConfig\",\"endpoint\":\"http://www.baidu.com\",\"domain\":\"http://www.xxx.com\",\"bucket\":\"1\",\"accessKey\":\"2\",\"accessSecret\":\"3\",\"enablePathStyleAccess\":false,\"enablePublicAccess\":false,\"region\":\"1\"}', '1', '2025-10-02 14:32:12', '1', '2026-07-02 15:35:07', b'0');
+INSERT INTO `infra_file_config` (`id`, `name`, `storage`, `remark`, `master`, `config`, `creator`, `create_time`, `updater`, `update_time`, `deleted`) VALUES (36, 'RustFS 存储（示例）', 20, '请先部署 RustFS、创建存储桶，并替换成你自己的地址和密钥！！！', b'0', '{\"@class\":\"cn.iocoder.yudao.module.infra.framework.file.core.client.s3.S3FileClientConfig\",\"endpoint\":\"http://127.0.0.1:9000\",\"domain\":\"http://127.0.0.1:9000/ruoyi-vue-pro\",\"bucket\":\"ruoyi-vue-pro\",\"accessKey\":\"your-access-key\",\"accessSecret\":\"your-secret-key\",\"enablePathStyleAccess\":true,\"enablePublicAccess\":false,\"region\":\"us-east-1\"}', '1', '2026-10-25 23:01:12', '1', '2026-10-25 23:01:12', b'0');
 COMMIT;
  
 -- ----------------------------
@@ -104,7 +104,7 @@
             <groupId>com.github.mwiede</groupId>
             <artifactId>jsch</artifactId> <!-- 文件客户端：解决 sftp 连接 -->
         </dependency>
-        <!-- 文件客户端：解决阿里云、腾讯云、minio 等 S3 连接 -->
+        <!-- 文件客户端：解决阿里云、腾讯云、minio、rustfs 等 S3 连接 -->
         <dependency>
             <groupId>software.amazon.awssdk</groupId>
             <artifactId>s3</artifactId>
@@ -26,7 +26,7 @@ import java.net.URL;
 import java.time.Duration;
  
 /**
- * 基于 S3 协议的文件客户端，实现 MinIO、阿里云、腾讯云、七牛云、华为云等云服务
+ * 基于 S3 协议的文件客户端，实现 MinIO、RustFS、阿里云、腾讯云、七牛云、华为云等云服务
  *
  * @author 芋道源码
  */
@@ -156,7 +156,7 @@ public class S3FileClient extends AbstractFileClient&lt;S3FileClientConfig&gt; {
      * @return Domain 地址
      */
     private String buildDomain() {
-        // 如果已经是 http 或者 https，则不进行拼接.主要适配 MinIO
+        // 如果已经是 http 或者 https，则不进行拼接.主要适配 MinIO、RustFS
         if (HttpUtil.isHttp(config.getEndpoint()) || HttpUtil.isHttps(config.getEndpoint())) {
             return StrUtil.format("{}/{}", config.getEndpoint(), config.getBucket());
         }
@@ -265,7 +265,7 @@ public class S3FileClient extends AbstractFileClient&lt;S3FileClientConfig&gt; {
             }
         }
  
-        // 3.4 其他情况（MinIO、七牛云等）使用默认值
+        // 3.4 其他情况（MinIO、RustFS、七牛云等）使用默认值
         return "us-east-1";
     }
  
@@ -30,6 +30,7 @@ public class S3FileClientConfig implements FileClientConfig {
      * 4. 七牛云：https://developer.qiniu.com/kodo/4088/s3-access-domainname
      * 5. 华为云：https://console.huaweicloud.com/apiexplorer/#/endpoint/OBS
      * 6. 火山云：https://www.volcengine.com/docs/6349/107356
+     * 7. RustFS：https://docs.rustfs.com/en/administration/protocols/s3/ 。例如说，http://127.0.0.1:9000（S3 API 端口，不是 9001 控制台端口）
      */
     @NotNull(message = "endpoint 不能为空")
     private String endpoint;
@@ -41,6 +42,7 @@ public class S3FileClientConfig implements FileClientConfig {
      * 4. 七牛云：https://developer.qiniu.com/kodo/8556/set-the-custom-source-domain-name
      * 5. 华为云：https://support.huaweicloud.com/usermanual-obs/obs_03_0032.html
      * 6. 火山云：https://www.volcengine.com/docs/6349/128983
+     * 7. RustFS：不填写时为 endpoint/bucket；PathStyle 访问时需带上 /bucket，例如说 http://127.0.0.1:9000/ruoyi-vue-pro，且需前端可访问
      */
     @URL(message = "domain 必须是 URL 格式")
     private String domain;
@@ -58,6 +60,7 @@ public class S3FileClientConfig implements FileClientConfig {
      * 4. 七牛云：https://portal.qiniu.com/user/key
      * 5. 华为云：https://support.huaweicloud.com/qs-obs/obs_qs_0005.html
      * 6. 火山云：https://console.volcengine.com/iam/keymanage/
+     * 7. RustFS：https://docs.rustfs.com/en/installation/container/docker/ 。例如说，启动时配置的 RUSTFS_ACCESS_KEY
      */
     @NotNull(message = "accessKey 不能为空")
     private String accessKey;
@@ -69,6 +72,8 @@ public class S3FileClientConfig implements FileClientConfig {
  
     /**
      * 是否启用 PathStyle 访问
+     *
+     * MinIO、RustFS：建议 true。其中，RustFS 默认使用 PathStyle，虚拟主机风格需服务端额外配置 RUSTFS_SERVER_DOMAINS
      */
     @NotNull(message = "enablePathStyleAccess 不能为空")
     private Boolean enablePathStyleAccess;
@@ -91,6 +96,7 @@ public class S3FileClientConfig implements FileClientConfig {
      * 5. 七牛云：不需要填写，会自动识别
      * 6. 华为云：不需要填写，会自动识别
      * 7. 火山云：不需要填写，会自动识别
+     * 8. RustFS：需与服务端的 RUSTFS_REGION 一致，默认 us-east-1；不填写时，也使用 us-east-1
      */
     private String region;
  
@@ -5,7 +5,7 @@
  * 2. ftp：FTP 服务器
  * 3. sftp：SFTP 服务器
  * 4. db：数据库
- * 5. s3：支持 S3 协议的云存储服务，例如说 MinIO、阿里云、华为云、腾讯云、七牛云等等
+ * 5. s3：支持 S3 协议的云存储服务，例如说 MinIO、RustFS、阿里云、华为云、腾讯云、七牛云等等
  *
  * @author 芋道源码
  */