第12章 手把手教程:使用 RPM/DEB 包安装 RustFS
← 全部文章Step-by-Step Tutorial: How to Install RustFS with RPM/DEB Packages2026年8月19日2 min readRustFSInstallationTutorialLinuxRustFS 自 1.0.0-rc.1 版本起开始提供 rpm/deb 软件包,你可以用一条 dpkg 命令完成安装。本指南将引导你在 Ubuntu 24.04 上,使用 RPM/DEB 包部署一个单节点、多磁盘的 RustFS 实例。 准备数据磁盘 RustFS 推荐 XFS 文件系统,请先将数据磁盘格式化为 XFS。本例使用 /dev/sda 作为数据磁盘。
格式化为 XFS
sudo mkfs.xfs /dev/sda
创建挂载点
sudo mkdir -p /data/rustfs/mnmd
注意:RustFS 以 rustfs 用户运行,数据目录的属主必须为 rustfs。
sudo chown -R rustfs:rustfs /data/rustfs/mnmd
挂载磁盘(立即生效)
sudo mount /dev/sda /data/rustfs/mnmd
将挂载项写入 /etc/fstab
# 获取磁盘 UUID blkid /dev/sda
# 将 UUID 写入 /etc/fstab vim /etc/fstab UUID=your-uuid /data/rustfs/mnmd xfs defaults 0 0
对每块数据磁盘重复上述操作。 安装 RustFS RPM/DEB 软件包支持 x86_64 和 arm64 架构。请下载与你服务器匹配的软件包。例如,在 Ubuntu 24.04 上请下载 DEB 包: curl -L -o rustfs.deb https://dl.rustfs.com/artifacts/rustfs/packages/release/rustfs_1.0.0~rc.1_amd64.deb
安装: dpkg -i rustfs.deb Selecting previously unselected package rustfs. (Reading database ... 69397 files and directories currently installed.) Preparing to unpack rustfs.deb ... Unpacking rustfs (1.0.0~rc.1) ... Setting up rustfs (1.0.0~rc.1) ... RustFS installed. Configure /etc/default/rustfs then: systemctl start rustfs
配置环境变量。RustFS 默认从 /etc/default/rustfs 读取配置。请将以下内容写入该文件。 RUSTFS_ACCESS_KEY=rustfs@test RUSTFS_SECRET_KEY=rustfs@test RUSTFS_VOLUMES="/data/rustfs{1...4}/mnmd" RUSTFS_ADDRESS=":9000" RUSTFS_CONSOLE_ADDRESS=":9001" RUSTFS_CONSOLE_ENABLE=true RUSTFS_OBS_LOGGER_LEVEL=error RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/"
启动 RustFS 服务: systemctl start rustfs
查看服务状态: systemctl status rustfs ● rustfs.service - RustFS Object Storage Server Loaded: loaded (/usr/lib/systemd/system/rustfs.service; disabled; pres> Drop-In: /etc/systemd/system/rustfs.service.d └─override.conf Active: active (running) since Tue 2026-08-18 13:29:36 UTC; 4s ago Docs: https://rustfs.com/docs/ Main PID: 29351 (rustfs) Status: "Running" Tasks: 55 Memory: 136.5M (peak: 138.5M) CPU: 175ms CGroup: /system.slice/rustfs.service └─29351 /usr/bin/rustfs server
验证安装 通过控制台验证 打开 http://ip:9001,使用 rustfs@test/rustfs@test 登录:
在状态页面确认集群信息:
通过 rc CLI 验证 rc 是 RustFS 的客户端 CLI 工具。你可以用它管理对象、桶、存储池以及集群状态。 安装 rc 请下载与你操作系统匹配的软件包。例如,在 Ubuntu 24.04 上安装最新版 rc: wget https://github.com/rustfs/cli/releases/download/v0.1.31/rustfs-cli-linux-amd64-gnu-v0.1.31.tar.gz
解压并安装: tar -zxvf rustfs-cli-linux-amd64-gnu-v0.1.31.tar.gz chmod +x rc cp rc /usr/local/bin
确认安装成功: rc --version rc 0.1.31
使用 rc
设置别名
rc alias set rustfs-deb http://10.0.0.14:29000 rustfs@test rustfs@test ✓ Alias 'rustfs-deb' configured successfully.
创建桶
rc mb rustfs-deb/deb-demo ✓ Bucket 'rustfs-deb/deb-demo' created successfully.
列出桶
rc ls rustfs-deb [2026-08-18 13:39:40] 0B deb-demo/
上传对象
# 写入文件 echo "Hello RustFS" > 1.txt
# 将文件上传到桶 rc cp 1.txt rustfs-deb/deb-demo 1.txt -> rustfs-deb/deb-demo/1.txt (13 B)
# 列出对象 rc ls rustfs-deb/deb-demo [2026-08-18 13:41:08] 13 B 1.txt
升级 RustFS 开始前
确认当前安装版本
rustfs --version rustfs 1.0.0-rc.1 build time : 2026-08-08 08:24:07 +00:00 build profile: release build os : linux-x86_64 rust version : rustc 1.97.1 (8bab26f4f 2026-07-14) rust channel : stable-x86_64-unknown-linux-gnu git branch : git commit : 778f1dfa2155cbbc61ad54e6896de9e29d2c4d8d git tag : 1.0.0-rc.1 git status :
或者使用: dpkg -l | grep -i rustfs ii rustfs 1.0.0~rc.1 amd64 High-performance distributed object storage
确认目标软件包
升级前,请前往 RustFS 下载页确认目标版本已发布。 执行升级 下载目标版本的软件包。仍以 Ubuntu 24.04 为例,下载 DEB 包: curl -L -o rustfs.deb https://dl.rustfs.com/artifacts/rustfs/packages/release/rustfs_1.0.0~rc.2_amd64.deb
执行升级: dpkg -i rustfs.deb
验证升级结果: rustfs 1.0.0-rc.2 build time : 2026-08-14 19:55:50 +00:00 build profile: release build os : linux-x86_64 rust version : rustc 1.97.1 (8bab26f4f 2026-07-14) rust channel : stable-x86_64-unknown-linux-gnu git branch : git commit : e9f53180273b32a9c2b0aa8b5a384047bc7e875c git tag : 1.0.0-rc.2 git status :
或者使用: dpkg -l | grep -i rustfs ii rustfs 1.0.0~rc.2 amd64 High-performance distributed object storage
升级完成。 总结 RustFS 提供多种安装方式——源码、二进制文件和容器——你可以选择最适合自己的场景。RPM/DEB 软件包提供熟悉且便捷的方式来安装和管理 RustFS。