关于 RustFS
在新一代对象存储 RustFS 的 MCP 扩展实践中，介绍了 RustFS，它是一个用 Rust 编写的开源分布式存储系统，完全兼容 S3。支持多种安装方式：源码编译、二进制、Docker 以及 Helm Chart。本文分享 RustFS 在 k3s 上的安装。
k3s 的安装
k3s 是经 CNCF 一致性认证的 Kubernetes 发行版，专为物联网及边缘计算而设计。简言之，k3s 是一个轻量级的 Kubernetes 发行版。
k3s 的安装非常简单，对于国内用户来讲，执行如下命令可以加速 k3s 的安装：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
| $ curl -sfL https://rancher-mirror.rancher.cn/k3s/k3s-install.sh | INSTALL_K3S_MIRROR=cn sh -
[INFO] Finding release for channel stable
[INFO] Using v1.28.5+k3s1 as release
[INFO] Downloading hash rancher-mirror.rancher.cn/k3s/v1.28.5-k3s1/sha256sum-amd64.txt
[INFO] Downloading binary rancher-mirror.rancher.cn/k3s/v1.28.5-k3s1/k3s
[INFO] Verifying binary download
[INFO] Installing k3s to /usr/local/bin/k3s
[INFO] Skipping installation of SELinux RPM
[INFO] Creating /usr/local/bin/kubectl symlink to k3s
[INFO] Creating /usr/local/bin/crictl symlink to k3s
[INFO] Skipping /usr/local/bin/ctr symlink to k3s, command exists in PATH at /usr/bin/ctr
[INFO] Creating killall script /usr/local/bin/k3s-killall.sh
[INFO] Creating uninstall script /usr/local/bin/k3s-uninstall.sh
[INFO] env: Creating environment file /etc/systemd/system/k3s.service.env
[INFO] systemd: Creating service file /etc/systemd/system/k3s.service
sh: 1014: restorecon: not found
sh: 1015: restorecon: not found
[INFO] systemd: Enabling k3s unit
Created symlink /etc/systemd/system/multi-user.target.wants/k3s.service → /etc/systemd/system/k3s.service.
[INFO] systemd: Starting k3s
|
接着可以查看 k3s 是否安装成功：
1
2
3
4
5
6
7
8
9
| #查看 k3s 版本
$ k3s --version
k3s version v1.33.4+k3s1 (148243c4)
go version go1.24.5
# 查看 k3s 集群
$ kubectl get nodes
NAME STATUS ROLES AGE VERSION
vm-0-12-ubuntu Ready control-plane,master 135m v1.33.4+k3s1
|
安装 RustFS
使用 RustFS Helm Chart来在 k3s 上进行安装。克隆此仓库到本地：
1
| $ git clone git@github.com:majinghe/rustfs-helm.git
|
整个目录结构如下：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
| ├── Chart.yaml
├── templates
│ ├── NOTES.txt
│ ├── _helpers.tpl
│ ├── configmap.yaml
│ ├── ingress.yaml
│ ├── secret-tls.yaml
│ ├── secret.yaml
│ ├── service.yaml
│ ├── serviceaccount.yaml
│ ├── statefulset.yaml
│ └── tests
│ └── test-connection.yaml
├── tls
│ ├── tls.crt
│ └── tls.key
└── values.yaml
|
可以根据自身需要对 values.yaml 中的参数进行修改，比如 CPU、Memory 的请求限制、PVC 的大小、StorageClass 的名称、Ingress 信息等。
由于在 k3s 上是通过 PVC 来当作 RustFS 实例所用到的 VOLUME，所以使用了 Rancher 自研的 local-path-provisioner来将本地磁盘转换为 StorageClass，直接执行如下命令即可：
1
2
3
| kubectl get sc
NAME PROVISIONER RECLAIMPOLICY VOLUMEBINDINGMODE ALLOWVOLUMEEXPANSION AGE
local-path (default) rancher.io/local-path Delete WaitForFirstConsumer false 149m
|
因此，在 values.yaml 文件中增加 PVC 内容：
1
2
3
| storageclass:
name: local-path
size: 256Mi
|
接着执行如下命令：
1
2
3
4
5
6
7
8
9
| $ helm install rustfs -n rustfs --create-namespace ./
NAME: rustfs
LAST DEPLOYED: Tue Sep 16 07:20:59 2025
NAMESPACE: rustfs
STATUS: deployed
REVISION: 1
NOTES:
1. Get the application URL by running these commands:
http://your.rustfs.com/
|
可以查看 pod，pvc，ingres，svc 等资源：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
| kubectl -n rustfs get pods,pvc,ingress,svc
NAME READY STATUS RESTARTS AGE
pod/rustfs-0 1/1 Running 0 88m
pod/rustfs-1 1/1 Running 0 92m
pod/rustfs-2 1/1 Running 0 96m
pod/rustfs-3 1/1 Running 0 101m
NAME STATUS VOLUME CAPACITY ACCESS MODES STORAGECLASS VOLUMEATTRIBUTESCLASS AGE
persistentvolumeclaim/data-rustfs-0-rustfs-0 Bound pvc-5ff16d6f-217e-4e05-b553-0c9245aa8dfb 256Mi RWO local-path <unset> 145m
persistentvolumeclaim/data-rustfs-0-rustfs-1 Bound pvc-665927f9-5bbb-4866-87ac-c4254e32cf11 256Mi RWO local-path <unset> 145m
persistentvolumeclaim/data-rustfs-0-rustfs-2 Bound pvc-595df1fe-2196-4174-9e52-eeed6a705284 256Mi RWO local-path <unset> 145m
persistentvolumeclaim/data-rustfs-0-rustfs-3 Bound pvc-480b6848-4cb0-416f-8e88-137ebec4e035 256Mi RWO local-path <unset> 145m
persistentvolumeclaim/data-rustfs-1-rustfs-0 Bound pvc-0a7cc385-0378-486a-83f7-db883fe1e29d 256Mi RWO local-path <unset> 145m
persistentvolumeclaim/data-rustfs-1-rustfs-1 Bound pvc-f304ed03-0967-4e62-b8cd-fdb2525b1018 256Mi RWO local-path <unset> 145m
persistentvolumeclaim/data-rustfs-1-rustfs-2 Bound pvc-cf9d3539-b5a1-4e7e-95c0-a2cf99e57bc5 256Mi RWO local-path <unset> 145m
persistentvolumeclaim/data-rustfs-1-rustfs-3 Bound pvc-9caaf98c-faee-444d-9e2c-a377aafb9fb9 256Mi RWO local-path <unset> 145m
persistentvolumeclaim/data-rustfs-2-rustfs-0 Bound pvc-8ea082b2-ba9f-4cd6-9866-866ed541697f 256Mi RWO local-path <unset> 145m
persistentvolumeclaim/data-rustfs-2-rustfs-1 Bound pvc-e7c69318-2648-4722-964e-cc89b798c191 256Mi RWO local-path <unset> 145m
persistentvolumeclaim/data-rustfs-2-rustfs-2 Bound pvc-883e9eba-1038-4789-b7fc-731f6becf794 256Mi RWO local-path <unset> 145m
persistentvolumeclaim/data-rustfs-2-rustfs-3 Bound pvc-ac8be1b7-ed72-4994-b5a5-87ef2fefcfd2 256Mi RWO local-path <unset> 145m
persistentvolumeclaim/data-rustfs-3-rustfs-0 Bound pvc-1d80e06a-91a7-4e64-8f3f-aaadaf576bb9 256Mi RWO local-path <unset> 145m
persistentvolumeclaim/data-rustfs-3-rustfs-1 Bound pvc-f3bca979-bec3-49fa-92d7-44c45560c94b 256Mi RWO local-path <unset> 145m
persistentvolumeclaim/data-rustfs-3-rustfs-2 Bound pvc-ad3a9d90-db72-49d1-b372-0f321869f7a5 256Mi RWO local-path <unset> 145m
persistentvolumeclaim/data-rustfs-3-rustfs-3 Bound pvc-fbf06576-873b-46d7-b084-c0a71ed324fe 256Mi RWO local-path <unset> 145m
NAME CLASS HOSTS ADDRESS PORTS AGE
ingress.networking.k8s.io/rustfs traefik your.rustfs.com 10.0.0.4 80, 443 30m
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
service/rustfs-headless ClusterIP None <none> 80/TCP,9001/TCP 108m
service/rustfs-svc ClusterIP 10.43.240.116 <none> 80/TCP,9001/TCP 108m
|
等待所有资源都处于 Ready 状态就可以登录 RustFS 了。
登录 RustFS
可以使用默认用户名和密码来登录 RustFS 实例。默认用户名和密码都写在了 values.yaml 中，并通过 secret 的方式以环境变量的形式注入到了 Pod 中。本次安装指定的默认用户名和密码均为 rustfsadmin。因此使用该用户名和密码，在浏览器中输入 Ingress 的地址 https://your.rustfs.com 即可看到 RustFS 的登录页面：
接着就可以来创建存储桶、对象等使用 RustFS。详细使用，可以查看 RustFS 官方文档。