进阶 rustfs.com 2026-11-14 08:26:37 · 20 阅读

第10章 如何使用 Cloudflare Tunnel 加固 RustFS 安全

返回全部文章

使用 Cloudflare Tunnel 加固 RustFS 安全

2026年1月24日

4 分钟阅读

RustFS 安全

默认情况下,RustFS 使用 9001 端口提供 Web 控制台,使用 9000 端口提供 API 访问。为确保安全性与合规性,即使使用 Nginx、Traefik 或 Caddy 等反向代理,用户也应始终启用 HTTPS 部署 RustFS。本文将分享一种更安全的方案:借助 Cloudflare Tunnel 访问 RustFS 实例,避免将端口直接暴露于公网,从而进一步提升 RustFS 的安全性。

安装 RustFS RustFS 支持二进制、Docker、Helm Chart 等多种安装方式。详细步骤请参考安装指南。本节演示如何通过 docker-compose.yml 使用 Docker 安装 RustFS。

创建包含以下内容的 docker-compose.yml 文件:

services: rustfs: image: rustfs/rustfs:latest container_name: rustfs hostname: rustfs environment: - RUSTFS_VOLUMES=/data/rustfs{1...4} - RUSTFS_ADDRESS=0.0.0.0:9000 - RUSTFS_CONSOLE_ENABLE=true - RUSTFS_CONSOLE_ADDRESS=0.0.0.0:9001 - RUSTFS_ACCESS_KEY=rustfsadmin - RUSTFS_SECRET_KEY=rustfsadmin - RUSTFS_TLS_PATH=/opt/tls ports: - "9000:9000" # API 端点 - "9001:9001" # 控制台 volumes: - data1:/data/rustfs1 - data2:/data/rustfs2 - data3:/data/rustfs3 - data4:/data/rustfs4 - ./certs:/opt/tls

networks: - rustfs

networks: rustfs: driver: bridge name: rustfs

volumes: data1: data2: data3: data4:

运行以下命令部署 RustFS 实例: docker compose up -d

验证安装状态: docker compose ps NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS rustfs rustfs/rustfs:1.0.0-alpha.81 "/entrypoint.sh rust…" rustfs 22 minutes ago Up 22 minutes 0.0.0.0:9000-9001->9000-9001/tcp, [::]:9000-9001->9000-9001/tcp

配置 Cloudflare Tunnel 配置 Cloudflare Tunnel 主要涉及两个部分:域名配置与隧道配置。

1. 域名配置(可选但推荐) 正确的域名配置能确保后续顺畅访问 RustFS,因此你需要拥有一个域名。

登录 Cloudflare 账号,进入域名管理页面。 在左侧菜单中选择“账户主页”。如果已有域名,选择“接入域名”;否则,选择“购买域名”。 若接入自有域名,输入域名并遵循引导,直到点击“继续激活”。 完成后,仪表盘上该域名的状态应显示为“已激活”。

2. 隧道配置

登录 Cloudflare Zero Trust 控制台。 进入“网络 -> 隧道”,点击“创建隧道”。 选择 cloudflared 作为连接器类型。 在“安装并运行连接器”部分,选择与 RustFS 服务器匹配的操作系统,并遵循安装指引。 安装完成后,可在 RustFS 服务器上验证服务状态。 在“路由流量”部分,配置主机名与服务:

主机名:选择先前添加的域名,也可指定子域名(例如 rustfs)。 服务:选择类型与 URL。本方案选择 HTTP(若内部已启用 HTTPS 则选 HTTPS),URL 设为 localhost:9001。

点击“完成配置”。

此时隧道状态应显示为绿色的“健康”标识。 注意:在主机名设置中,进入“附加应用设置 -> HTTP 设置”,在“HTTP 主机头”字段填写用于访问 RustFS 的域名。此举可避免 S3 API 调用时出现 SignatureDoesNotMatch 错误。

登录验证 恭喜你!现在可通过配置好的域名访问 RustFS 实例。按上述配置,访问地址为 https://rustfs.xiaomage.vip。

使用默认凭据 rustfsadmin / rustfsadmin 登录 RustFS 实例。 之后可使用 mc、rc 或 rclone 等工具与 RustFS 交互。

使用 mc 操作 RustFS mc 是 MinIO 的客户端工具。由于 RustFS 兼容 S3 且可作为 MinIO 的替代方案,mc 能与其完美配合。

准备工作 参照 MinIO 文档安装 mc,并检查版本以确认安装成功。 mc --version # mc version RELEASE.2025-08-29T21-30-41Z...

使用示例 # 设置别名 mc alias set rustfs https://rustfs.xiaomage.vip rustfsadmin rustfsadmin

# 创建存储桶 mc mb rustfs/hello

# 列出存储桶 mc ls rustfs [2026-01-23 21:39:36 CST] 0B hello/ [2026-01-23 20:12:59 CST] 0B test/

# 上传文件 echo "123456" > 1.txt mc cp 1.txt rustfs/hello # 1.txt: 100.0% 7 B 1 B/s

# 验证上传 mc ls rustfs/hello [2026-01-23 21:40:44 CST] 7B STANDARD 1.txt

使用 rclone 操作 RustFS rclone 是一款强大的命令行工具,用于在不同云存储服务间同步文件,同样可用于操作 RustFS。

准备工作 按照官方指南安装 rclone 命令行工具,并检查版本 rclone 以确认安装成功。 rclone --version # rclone v1.72.1 ...

使用示例

配置 rclone

运行 rclone config 并遵循引导。最终生成的 ~/.config/rclone/rclone.conf 配置内容应如下: [rustfs] type = s3 provider = Minio access_key_id = rustfsadmin secret_access_key = rustfsadmin endpoint = https://rustfs.xiaomage.vip region = us-east-1 force_path_style = true

注意:由于 rclone 提供商列表中尚未包含 RustFS,故选用 Minio 作为提供商。未来我们将提交 PR,将 RustFS 加入提供商列表。

基础命令

# 列出存储桶与对象 rclone ls rustfs: --s3-sign-accept-encoding=false 7 hello/1.txt 11792 test/1.log 520512 test/123.mp3

# 查看对象内容 rclone cat rustfs:hello/1.txt --s3-sign-accept-encoding=false 123456

注意:必须添加 --s3-sign-accept-encoding=false 参数,因为 Cloudflare 会修改 Accept-Encoding 请求头。在 S3 协议中,此改动会触发 SignatureDoesNotMatch 错误。详情参见 RustFS 问题 #1492。

使用 rc 操作 RustFS 准备工作 rc 是 RustFS 的原生 CLI 工具,当前版本 0.1.1,可通过 Cargo 安装或从源码编译。安装后检查版本以确认成功。 rc --version # rc 0.1.1

使用示例 rc 支持 alias、ls、mb、rb 等标准命令,用法与 mc 类似。 # 设置别名 rc alias set rustfs https://rustfs.xiaomage.vip rustfsadmin rustfsadmin ✓ 别名 'rustfs' 配置成功。

# 列出存储桶 rc ls rustfs [2026-01-23 13:39:36] 0B hello/ [2026-01-23 13:56:57] 0B rclone/ [2026-01-23 12:12:59] 0B test/

# 创建存储桶 rc mb rustfs/client ✓ 存储桶 'rustfs/client' 创建成功。

如需了解其他功能,请运行 rc --help。若遇到问题,请在 GitHub Issues 中提供反馈。

本篇用到的工具

评论 (0)