RustFS 保姆级上手指南：国产开源高性能对象存储

最近在给项目选型对象存储的时候，发现一个挺有意思的现象：一边是MinIO社区版功能逐渐“躺平”，另一边是大家对存储性能和安全性的要求越来越高。就在这时，一个叫 RustFS 的国产开源项目闯入了我的视野。

折腾了一阵子后，我感觉这玩意儿确实有点东西。它用Rust语言写，天生就带着高性能和内存安全的基因，性能号称比MinIO快一大截，而且用的是对商业友好的Apache 2.0协议。今天，我就手把手带大家从零开始，搭建一个属于自己的RustFS服务，体验一下国产存储的威力。

一、 RustFS是什么？为什么值得你关注？

简单说，RustFS是一个分布式对象存储系统。你可以把它理解成一个你自己搭建的、功能跟阿里云OSS、亚马逊S3几乎一样的“私有云盘”。

但它有几个非常突出的亮点，让我觉得必须试试：

性能猛兽：基于Rust语言开发，没有GC（垃圾回收）带来的性能抖动，官方数据显示在4K随机读场景下，性能比MinIO高出40%以上，内存占用还不到100MB，简直是“小钢炮”。
100%S3兼容：这意味着你现有的所有使用S3 API的代码、工具（比如AWS CLI），都不用改一行代码，就能无缝切换到RustFS，迁移成本极低。
开源协议友好：采用 Apache 2.0 许可证，不像MinIO的AGPLv3有那么强的“传染性”，企业用起来没有后顾之忧，老板们肯定喜欢这点。
国产化适配：作为国产项目，它完美支持麒麟、统信等国产操作系统和鲲鹏、海光等国产CPU，信创项目必备3。

二、上手前，环境准备好了吗？

“工欲善其事，必先利其器”。在开始安装前，我们先确认一下环境，避免踩坑。

操作系统：Linux（推荐，性能最佳）、macOS、Windows均可。
硬件配置：至少4GB内存（建议8GB及以上），支持ARM或x86_64架构。
工具软件：
- Docker（可选，但强烈推荐新手使用，能省去大量编译配置的麻烦）。
- Git（用于克隆代码仓库，如果选择源码安装）。
- AWS CLI（可选，用于测试S3兼容性）。

三、两种安装方式，总有一款适合你

RustFS提供了两种主流的安装方式，你可以根据自己的情况选择。

方式一：Docker部署（推荐新手，三分钟搞定）

这是最快、最简单的方式，特别适合快速体验和测试。

拉取官方镜像打开终端，执行：
```
docker pull rustfs/rustfs:latest
```

运行容器我们用docker-compose来管理会更清晰，先创建一个目录，比如/mnt/rustfs，在里面创建docker-compose.yml文件：

version: '3.7' services: rustfs: image: rustfs/rustfs:latest container_name: rustfs-server ports: - "9000:9000" # API服务端口 - "9001:9001" # Web控制台端口 volumes: - ./data:/data # 将容器内的/data目录挂载到当前目录下的data文件夹 environment: - RUSTFS_ROOT_USER=rustfsadmin # 设置访问密钥 - RUSTFS_ROOT_PASSWORD=rustfsadmin # 设置密钥密码

启动服务在docker-compose.yml文件所在目录执行：
```
docker-compose up -d
```
看到容器启动成功，恭喜你，RustFS服务已经跑起来了！

方式二：源码编译（生产环境首选）

如果你想在生产环境部署，或者想深度定制，源码编译是更好的选择。

克隆代码

git clone https://github.com/rustfs/rustfs.git cd rustfs

编译项目 RustFS使用Cargo（Rust的包管理器）进行编译。确保你的系统已经安装了Rust环境。
```
cargo build --release
```
编译过程可能需要几分钟，耐心等待一下。编译成功后，可执行文件位于 target/release/rustfs。

四、启动与配置，让RustFS跑起来

无论你用哪种方式安装，启动服务时都需要做一些基本配置。

创建存储目录 RustFS需要一个目录来存放数据。我们先创建它：
```
mkdir -p /data/rustfs chmod 755 /data/rustfs # 确保有读写权限
```
启动服务
- 如果你用Docker：在docker-compose.yml里已经配置好了，它会自动使用挂载的./data目录。
- 如果你用源码编译：
```
./target/release/rustfs /data/rustfs
```
  这样会使用默认配置启动。如果想自定义，可以通过命令行参数：
```
./target/release/rustfs /data/rustfs \ --address "0.0.0.0:9000" \ --access-key "myaccesskey" \ --secret-key "mysecretkey" \ --console-enable \ --console-address "0.0.0.0:9001"
```
  核心参数说明：
  - --address: API服务监听的地址和端口。
  - --access-key / --secret-key: S3认证的访问密钥，请务必修改！
  - --console-enable: 启用Web管理控制台。
  - --console-address: Web控制台的监听地址和端口。

五、实战！创建你的第一个存储桶

服务启动后，我们就可以通过两种方式来操作它了。

方式一：Web控制台（最直观）

打开浏览器，访问 http://<你的服务器IP>:9001。
使用你配置的access-key和secret-key登录（比如Docker例子里都是rustfsadmin）。
登录后，点击界面上的“Create Bucket”按钮，输入一个名字（比如my-first-bucket），你的第一个存储桶就创建成功了！你还可以在桶里上传、下载、删除文件，非常方便。

方式二：AWS CLI（程序员的最爱）

配置AWS CLI 在终端执行：
```
aws configure
```
按提示输入你的Access Key ID、Secret Access Key，区域可以随便填（比如us-east-1）。

执行基本操作记得在所有命令后面加上--endpoint-url http://<你的服务器IP>:9000来指向你的RustFS服务。

# 列出所有存储桶 aws s3 ls --endpoint-url http://localhost:9000 # 上传一个文件 echo "hello rustfs" > test.txt aws s3 cp test.txt s3://my-first-bucket/ --endpoint-url http://localhost:9000 # 下载文件 aws s3 cp s3://my-first-bucket/test.txt ./downloaded.txt --endpoint-url http://localhost:9000 # 删除文件 aws s3 rm s3://my-first-bucket/test.txt --endpoint-url http://localhost:9000