RustFS 详细配置

RustFS 是 S3 兼容对象存储。本文说明在 RustFS 上准备好桶与密钥后，如何在虾传中完成对接。

RustFS 的安装与运维请参阅 RustFS 官方文档。

适用场景

• 已有可访问的 RustFS 实例，用于虾传广域网文件中转。

在 RustFS 控制台准备

创建存储桶

1. 登录 RustFS 控制台 → 对象浏览。
2. 点击 创建存储桶，输入桶名（如 test），保持私有即可。

创建访问密钥

1. 访问密钥 → + 添加访问密钥。

2. 填写信息后 提交。

3. 立即复制或导出 Access Key 与 Secret Key。

配置 CORS

Web 端直传需在 RustFS 服务上允许虾传 Web 的 Origin。若使用 Docker / Compose 部署，在 environment 下增加：

RUSTFS_CORS_ALLOWED_ORIGINS: https://xiachuan.net,https://www.xiachuan.net

多个 Origin 用英文逗号分隔，不要加空格。修改后重启 RustFS 容器生效。

YAML 片段示例：

services:
  rustfs:
    environment:
      RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY}
      RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY}
      RUSTFS_CONSOLE_ENABLE: ${RUSTFS_CONSOLE_ENABLE}
      RUSTFS_CORS_ALLOWED_ORIGINS: https://xiachuan.net,https://www.xiachuan.net

填写虾传设置

入口：设置 → S3，或 S3 云端中转会话 内的 S3 设置。

从 RustFS 侧获取 S3 API 地址（不是 Web 控制台地址），填入虾传 Endpoint：

特别注意： Path-style 访问 开关请保持开启（见下图）。

测试连接

保存后点击 测试连接，再实际传文件验证。若失败，请检查 Endpoint、Bucket、密钥、Path-style 与 CORS Origin 是否与当前 Web 地址一致。

常见问题

小文件正常，50MB 以上大文件上传失败？

若 RustFS 部署在服务端且前面有 Nginx（或其他反向代理）转发 S3 API，小文件能成功、大文件失败，常见原因是代理的请求体大小限制。Nginx 默认 client_max_body_size often 为 1m，超过即返回 413 Request Entity Too Large，浏览器侧表现为上传中断或失败。

在代理 RustFS S3 API 的 server / location 中调大限制，例如：

client_max_body_size 1024m;

修改后重载 Nginx（nginx -s reload）。若仍有个别超大文件超时，可酌情增加 proxy_read_timeout、proxy_send_timeout 等。

此限制来自反向代理配置，与虾传客户端无关；直连 RustFS 端口（不经过 Nginx）时通常不受此项影响。

相关链接

• RustFS 官方文档