Linux 安装 RustFS

一、安装前必读

本页面包含了 RustFS 的三种安装模式的全部文档和说明。其中，多机多盘的模式包含了企业级可用的性能、安全性和扩展性。并且，提供了生产工作负载需要的架构图。请装前请阅读，我们的启动模式与检查清单，如下：

启动模式，前明确您的 Linux 启动模式；
检查清单，检查各项指标是否符合生产指导特征，若不需要生产标准可不阅读此指导；

二、先决条件

操作系统版本；
防火墙；
主机名；
内存条件；
时间同步；
容量规划；
磁盘规划；
容量规划；
数据分层规划。

2.1. 操作系统版本

我们推荐 Linux 内核为 4.x 及以上的版本，但是 5.x 及以上的版本可以获得更好的 IO 吞吐和网络性能。

您可以使用 Ubuntu 20.04 和 RHEL88.x 来安装 RustFS。

2.2 防火墙

Linux 系统默认开启防火墙，您可以使用以下命令查看防火墙状态：

bash

systemctl status firewalld

如果您的防火墙状态为“active”，您可以使用以下命令禁用防火墙：

bash

systemctl stop firewalld
systemctl disable firewalld

或者放行 RustFS 的 9000 端口：

bash

firewall-cmd --zone=public --add-port=9000/tcp --permanent
firewall-cmd --reload

部署中的所有 RustFS 服务器必须使用相同的监听端口。如果您使用的是 9000 端口，其他服务器的所有端口均需要为 9000 端口。

2.3 主机名

创建 RustFS 集群必须要使用 相同的、具备连续性 的主机名。有两种方式实现连续性的主机名：

DNS 配置；
HOSTS 配置。

bash


vim /etc/hosts
127.0.0.1 localhost localhost.localdomain localhost4 localhost4.localdomain4
::1 localhost localhost.localdomain localhost6 localhost6.localdomain6
192.168.1.1 node1
192.168.1.2 node2
192.168.1.3 node3
192.168.1.4 node4

2.4 内存条件

RustFS 需要至少 2 GB 的内存来运行测试环境，生产的环境最低需要 64 GB 的内存。

2.5 时间同步

多节点的一致性必须要使用时间服务器维护时间的一致性，不然可能会出现无法启动服务的情况。相关时间服务器例如使用 ntp , timedatectl , 或者 timesyncd 。

RustFS 需要时间同步，您可以使用以下命令检查时间同步状态：

bash

timedatectl status

如果状态为“synchronized”，则表示时间同步正常。

三、配置用户名

RustFS 启动，我们建议您配置一个专门的无登录权限的用户进行启动 RustFS 的服务。在 rustfs.service 启动控制脚本中，默认的用户和用户组是 rustfs-user 和 rustfs-user 。

您可以使用 groupadd 和 useradd 命令创建用户和组. 以下示例创建用户、组并设置权限以访问 RustFS 指定的数据目录。

四、下载安装包

请先安装 wge 或者 curl 下载 rustfs 安装包。

bash

# 下载地址
wget https://dl.rustfs.com/rustfs/rustfs
chmod +x rustfs
mv rustfs /usr/local/bin/

五、配置环境变量

创建配置文件

bash

sudo tee /etc/default/rustfs <<EOF
RUSTFS_ROOT_USER=rustfsadmin
RUSTFS_ROOT_PASSWORD=rustfsadmin
RUSTFS_VOLUMES="/data/rustfs{0...3}"
RUSTFS_ADDRESS=":7000"
#RUSTFS_SERVER_DOMAINS="play.rustfs.com:7000"
RUSTFS_CONSOLE_ENABLE=true
RUSTFS_CONSOLE_ADDRESS=":7001"
RUSTFS_OBS_CONFIG="/etc/default/obs.toml"
RUSTFS_TLS_PATH="/opt/tls"
EOF

bash

sudo mkdir -p /data/rustfs{0..3} /var/logs/rustfs /opt/tls
sudo chmod -R 750 /data/rustfs* /var/logs/rustfs

六、配置可观测性系统

创建观测配置文件

bash

sudo tee /etc/default/obs.toml <<EOF
[observability]
endpoint = "http://localhost:4317"
use_stdout = false
sample_ratio = 2.0
meter_interval = 30
service_name = "rustfs"
service_version = "0.1.0"
environments = "production" 
logger_level = "debug"
local_logging_enabled = true

[sinks]
[sinks.kafka]
enabled = false
bootstrap_servers = "localhost:9092"
topic = "logs"
batch_size = 100
batch_timeout_ms = 1000

[sinks.webhook]
enabled = false
endpoint = "http://localhost:8080/webhook"
auth_token = ""
batch_size = 100
batch_timeout_ms = 1000

[sinks.file]
enabled = true
path = "/var/logs/rustfs/app.log"
batch_size = 10
batch_timeout_ms = 1000

[logger]
queue_capacity = 10
EOF

设置日志轮转

bash

sudo tee /etc/logrotate.d/rustfs <<EOF
/var/logs/rustfs/*.log {
 daily
 rotate 7
 missingok
 notifempty
 compress
 delaycompress
 sharedscripts
 postrotate
 systemctl restart rustfs >/dev/null 2>&1 || true
 endscript
}
EOF

七、配置系统服务

创建 systemd 服务文件

bash

sudo tee /etc/systemd/system/rustfs.service <<EOF
[Unit]
Description=RustFS Object Storage Server
Documentation=https://rustfs.com/docs/
After=network-online.target
Wants=network-online.target

[Service]
Type=notify
NotifyAccess=main
User=root
Group=root

WorkingDirectory=/usr/local
EnvironmentFile=-/etc/default/rustfs
ExecStart=/usr/local/bin/rustfs \$RUSTFS_VOLUMES \$RUSTFS_OPTS

LimitNOFILE=1048576
LimitNPROC=32768
TasksMax=infinity

Restart=always
RestartSec=10s

OOMScoreAdjust=-1000
SendSIGKILL=no

TimeoutStartSec=30s
TimeoutStopSec=30s

NoNewPrivileges=true
ProtectSystem=full
ProtectHome=true
PrivateTmp=true
PrivateDevices=true
ProtectClock=true
ProtectKernelTunables=true
ProtectKernelModules=true
ProtectControlGroups=true
RestrictSUIDSGID=true
RestrictRealtime=true

[Install]
WantedBy=multi-user.target
EOF

重新加载服务配置

bash

sudo systemctl daemon-reload

八、启动服务与验证

启动服务并设置开机自启

bash

sudo systemctl enable --now rustfs

验证服务状态

bash

systemctl status rustfs

检查服务端口

bash

ss -tunlp | grep -E '7000|7001'

验证控制台访问

bash

curl -u rustfsadmin:rustfsadmin http://localhost:7001/metrics

查看日志文件

bash

tail -f /var/logs/rustfs/app.log

测试存储接口（示例）

bash

curl -X PUT -u rustfsadmin:rustfsadmin \
-H "Content-Type: application/octet-stream" \
--data-binary @testfile \
http://localhost:7000/bucket1/object1

安装前检查

安装指南

Linux 安装 RustFS

一、安装前必读

二、先决条件

2.1. 操作系统版本

2.2 防火墙

2.3 主机名

2.4 内存条件

2.5 时间同步

三、配置用户名

四、下载安装包

五、配置环境变量

六、配置可观测性系统

七、配置系统服务

八、启动服务与验证

Linux 安装 RustFS ​

一、 安装前必读 ​

二、 先决条件 ​

2.1. 操作系统版本 ​

2.2 防火墙 ​

2.3 主机名 ​

2.4 内存条件 ​

2.5 时间同步 ​

三、配置用户名 ​

四、下载安装包 ​

五、配置环境变量 ​

六、配置可观测性系统 ​

七、配置系统服务 ​

八、启动服务与验证 ​

Linux 安装 RustFS

一、安装前必读

二、先决条件

2.1. 操作系统版本

2.2 防火墙

2.3 主机名

2.4 内存条件

2.5 时间同步

三、配置用户名

四、下载安装包

五、配置环境变量

六、配置可观测性系统

七、配置系统服务

八、启动服务与验证