RustFS安装使用

一、什么是RustFS：

RustFS 是用 Rust 编写的新一代对象存储系统，是 MinIO 的国产替代，完全开源，同时完全兼容 S3。

二、创建数据目录，并赋权

bash 复制代码

mkdir /opt/rustfs/data -p
chmod 777 /opt/rustfs/data

三、创建容器

#19001为HTTP/S3 API 端口，19000为RPC 集群通信端口。

bash 复制代码

docker run -d \
  --name rustfs \
  -p 19000:9000 \
  -p 19001:9001 \
  -v /opt/rustfs/data:/data \
  -e RUSTFS_ACCESS_KEY=rustfsadmin \
  -e RUSTFS_SECRET_KEY=rustfsadmin \
  -e RUSTFS_CONSOLE_ENABLE=true \
  -e RUSTFS_ADDRESS=:9000 \
  docker.m.daocloud.io/rustfs/rustfs:latest

四、访问web

http://192.168.70.213:19001/rustfs/console/auth/login

五、登录管理端

账号（accessKey）：rustfsadmin

密码（secretKey）：rustfsadmin

六、创建存储桶

七、创建访问密钥，添加的访问秘钥默认继承当前账号的权限。

八、创建用户，密码至少八位，选择用户组策略。

九、命令行客户端安装（mc为minio的客户端）

bash 复制代码

wget https://dl.min.io/client/mc/release/linux-amd64/mc -O /usr/local/bin/mc
chmod +x /usr/local/bin/mc
mc --version

十、mc常用命令

1、实例配置别名，使用 mc alias 给 RustFS 实例配置好别名，url改成具体地址，ACCESS_KEY 和 SECRET_KEY换成添加的访问秘钥。

bash 复制代码

mc host add rustfs http://192.168.70.213:19001 Owr1Pd547kls2QfU9F8M feK6lJ4UywtrpHjAMmQFvdI8GqoDkCnNi9BPcW30 --api S3v4

2、列出当前的存储桶

bash 复制代码

mc ls rustfs

3、列出存储桶中的数据

bash 复制代码

mc ls rustfs/upload/2025/12

4、列出存储桶中的数据

bash 复制代码

mc ls rustfs/upload/2025/12

5、创建存储桶

bash 复制代码

mc mb rustfs/dba

6、删除存储桶

bash 复制代码

mc rb rustfs/dba

7、上传文件

bash 复制代码

mc cp nnn.yaml rustfs/upload/2025/

8、上传目录

bash 复制代码

mc cp -r template rustfs/upload/2025/

9、删除文件、目录

bash 复制代码

mc rb rustfs/upload/2025/nnn.yaml
mc rm rustfs/upload/2025/template

十一、数据备份与还原

1、数据全量备份。数据目录/data中的.rustfs.sys隐藏目录存放元数据，因此备份整个data目录即同时备份数据和元数据。

bash 复制代码

#文件级备份，适用数据量低于3TB
tar -zcvf rustfs_backup_$(date +%Y%m%d).tar.gz /opt/rustfs/data

2、数据全量还原。

bash 复制代码

tar -zxvf rustfs_backup_$(date +%Y%m%d).tar.gz -C /opt/rustfs/data