s3fs

In dieser Anleitung verbinden Sie s3fs-fuse — das FUSE-basierte S3-Dateisystem — mit RustFS. Sie hängen einen Bucket als lokales Verzeichnis ein, schreiben Dateien über den Mount, hängen ihn aus und bestätigen, dass die Objekte im Bucket erhalten bleiben. Der Ablauf wurde mit s3fs v1.93 gegen rustfs/rustfs-x86-musl:v2.3.1 auf Ubuntu 24.04 verifiziert.

Sie benötigen einen Linux-Host mit FUSE (Paket fuse3) und der Binärdatei s3fs.

ArchitekturCopy Anchor Link

Jede Datei, die unter dem Mount-Punkt entsteht, wird zu einem Objekt im Bucket, dessen Objektschlüssel der relative Pfad ist. Das ist eine einfache 1:1-Abbildung ohne Cache-Schicht.

apt-get install -y s3fs
s3fs --version

Amazon Simple Storage Service File System V1.93 ...

echo "<your-access-key>:<your-secret-key>" > ~/.passwd-s3fs
chmod 600 ~/.passwd-s3fs

mkdir -p /mnt/s3fs-demo
s3fs s3fs-demo /mnt/s3fs-demo \
  -o passwd_file=~/.passwd-s3fs \
  -o url=http://<your-rustfs-endpoint>:9000 \
  -o endpoint=us-east-1 \
  -o use_path_request_style \
  -o allow_other -o umask=000

echo "hello from s3fs" > /mnt/s3fs-demo/s3fs-test.txt
dd if=/dev/urandom of=/mnt/s3fs-demo/blob.bin bs=1M count=5
cat /mnt/s3fs-demo/s3fs-test.txt

hello from s3fs

fusermount -u /mnt/s3fs-demo
s3fs s3fs-demo /mnt/s3fs-demo -o passwd_file=~/.passwd-s3fs \
  -o url=http://<your-rustfs-endpoint>:9000 -o endpoint=us-east-1 \
  -o use_path_request_style
ls /mnt/s3fs-demo/

blob.bin  s3fs-test.txt

rc ls rustfs/s3fs-demo/

[2026-10-06 12:09:27]      5 MiB blob.bin
[2026-10-06 12:09:26]       16 B s3fs-test.txt

fusermount -u /mnt/s3fs-demo
rc rm rustfs/s3fs-demo/ --recursive --force

FehlerbehebungCopy Anchor Link

fuse: device not found innerhalb eines ContainersCopy Anchor Link

Übergeben Sie --device /dev/fuse --cap-add SYS_ADMIN an docker run, oder --privileged, wenn der Mount-Helfer weiterhin scheitert.

Permission denied beim Lesen des Mounts als anderer BenutzerCopy Anchor Link

s3fs-Mounts gehören standardmäßig nur dem Benutzer, der sie eingehängt hat. Fügen Sie beim Einhängen -o allow_other -o umask=000 (oder eine engere umask) hinzu.

Der Mount gelingt, die Auflistung ist auf einem anderen Client aber leerCopy Anchor Link

s3fs hat keinen Metadaten-Cache, der über Mounts hinweg geteilt wird, Clients und List-Operationen sind aber letztendlich konsistent. Hängen Sie neu ein oder listen Sie nach einigen Sekunden erneut auf.

Nächste SchritteCopy Anchor Link

• Lesen Sie die S3-Kompatibilitätshinweise, bevor Sie weitere FUSE-Optionen einsetzen.
• Erstellen Sie dedizierte Produktions-Zugangsdaten über die Zugriffsschlüssel-Verwaltung.
• Folgen Sie der s3fs-fuse-Dokumentation für Leistungsoptionen wie -o multipart und -o parallel_count.