SFTP

RustFS enthält ein Gateway für das SSH File Transfer Protocol (SFTP), das Buckets und Objekte über eine verschlüsselte SSH-Verbindung für SFTP-Clients bereitstellt. Sie können Buckets auflisten und erstellen sowie Objekte hochladen, herunterladen, umbenennen oder löschen, während RustFS die Berechtigungen des authentifizierten Benutzers von Identity and Access Management (IAM) durchsetzt.

SFTP ist ein optionales Feature zur Build-Zeit und nicht im Standard-Build von RustFS enthalten. Bauen Sie RustFS mit dem Feature sftp oder full, bevor Sie den Listener aktivieren. Der Listener ist zur Laufzeit standardmäßig deaktiviert.

ÜberblickCopy Anchor Link

Das Gateway bildet SFTP-Pfade auf RustFS-Ressourcen ab:

Das Erstellen oder Entfernen eines Verzeichnisses direkt unter / erstellt oder entfernt einen Bucket. Verzeichnisse unterhalb eines Buckets werden auf Präfixe von Objektschlüsseln abgebildet und existieren nicht als eigenständige Dateisystemverzeichnisse.

RustFS unterstützt die folgenden Operationen über das SFTP-Gateway:

Geben Sie einen RustFS-Zugriffsschlüssel als SFTP-Benutzernamen und den zugehörigen geheimen Zugriffsschlüssel als Passwort ein. RustFS prüft die S3-Richtlinien des IAM-Benutzers für jede Operation.

KonfigurationCopy Anchor Link

Mit SFTP-Unterstützung bauenCopy Anchor Link

Bauen Sie RustFS mit dem SFTP-Feature:

cargo build --release --features sftp

Um alle optionalen RustFS-Features einschließlich SFTP zu aktivieren, verwenden Sie stattdessen --features full. RUSTFS_SFTP_ENABLE=true hat in einem Binary ohne das Feature sftp keine Wirkung.

SFTP-VariablenCopy Anchor Link

Der Standardport 2222 vermeidet den privilegierten SSH-Port 22. Die Adresse kann IPv4- oder IPv6-Syntax verwenden, zum Beispiel 127.0.0.1:2222 oder [::]:2222.

Host-Schlüssel vorbereitenCopy Anchor Link

Erstellen Sie ein dauerhaftes Verzeichnis für Host-Schlüssel und erzeugen Sie einen Ed25519-Host-Schlüssel:

mkdir -p /path/to/sftp-keys
ssh-keygen -t ed25519 \
	-f /path/to/sftp-keys/ssh_host_ed25519_key \
	-N ""
chmod 600 /path/to/sftp-keys/ssh_host_ed25519_key*

Der Host-Schlüssel darf keine Passphrase verwenden. RustFS akzeptiert außerdem private ECDSA- und RSA-Host-Schlüssel, die es einlesen kann.

Unter Unix darf jede reguläre Datei im Verzeichnis der Host-Schlüssel nur für ihren Eigentümer zugänglich sein. Der Befehl ssh-keygen erzeugt außerdem eine .pub-Datei. Belassen Sie sie wie gezeigt mit Berechtigungen nur für den Eigentümer oder entfernen Sie sie, weil RustFS sie nicht liest. RustFS verweigert den Start, wenn das Verzeichnis fehlt, keinen verwendbaren privaten Schlüssel enthält oder eine reguläre Datei enthält, bei der Bits für die Gruppe oder für andere Benutzer gesetzt sind.

SFTP-Listener startenCopy Anchor Link

Das folgende Beispiel startet SFTP für lokale Tests auf der Loopback-Schnittstelle:

export RUSTFS_SFTP_ENABLE=true
export RUSTFS_SFTP_ADDRESS=127.0.0.1:2222
export RUSTFS_SFTP_HOST_KEY_DIR=/path/to/sftp-keys
export RUSTFS_ACCESS_KEY=<your-access-key>
export RUSTFS_SECRET_KEY=<your-secret-key>

rustfs /path/to/data

Binden Sie für entfernte Verbindungen an eine passende Netzwerkschnittstelle und lassen Sie eingehenden TCP-Verkehr zum konfigurierten SFTP-Port zu. Dieser Listener ist von den Listenern der S3-API und der Console getrennt.

VerwendungCopy Anchor Link

Die folgenden Beispiele verwenden den OpenSSH-Client sftp, die kanonischen Namen my-bucket und hello.txt sowie einen lokalen Listener auf Port 2222.

VerbindenCopy Anchor Link

sftp -P 2222 <your-access-key>@127.0.0.1

Geben Sie den geheimen Zugriffsschlüssel von RustFS ein, wenn nach dem Passwort gefragt wird. Prüfen Sie bei der ersten Verbindung den angezeigten Fingerabdruck des Host-Schlüssels, bevor Sie ihn akzeptieren.

Buckets auflisten und erstellenCopy Anchor Link

Listen Sie an der sftp-Eingabeaufforderung die für den IAM-Benutzer sichtbaren Buckets auf und erstellen Sie my-bucket:

sftp> ls /
sftp> mkdir /my-bucket
sftp> cd /my-bucket

Bucket-Namen müssen denselben Namensregeln folgen wie Buckets, die über die S3-API erstellt werden. Objekte können nicht direkt unter / angelegt werden.

Objekt hochladen und herunterladenCopy Anchor Link

Laden Sie /path/to/hello.txt hoch, listen Sie den Bucket auf und laden Sie das Objekt herunter:

sftp> put /path/to/hello.txt /my-bucket/hello.txt
sftp> ls /my-bucket
sftp> get /my-bucket/hello.txt hello.txt

Uploads müssen sequenziell vom Anfang der Datei erfolgen. Fortsetzen, Anfügen, Änderungen an Ort und Stelle und segmentierte Uploads eines Objekts über mehrere Verbindungen werden nicht unterstützt.

Objekt umbenennenCopy Anchor Link

sftp> rename /my-bucket/hello.txt /my-bucket/greeting.txt

RustFS implementiert das Umbenennen als serverseitige Kopie mit anschließendem Löschen der Quelle. Die Operation ist nicht atomar, und das Umbenennen eines Buckets wird nicht unterstützt. Der IAM-Benutzer benötigt die Berechtigung, die Quelle zu lesen und zu löschen und das Ziel zu schreiben.

Objekt und Bucket löschenCopy Anchor Link

Löschen Sie das Objekt und entfernen Sie anschließend den leeren Bucket:

sftp> rm /my-bucket/greeting.txt
sftp> rmdir /my-bucket

RustFS löscht einen nicht leeren Bucket über SFTP nicht rekursiv.

Desktop-Client verbindenCopy Anchor Link

Verwenden Sie diese Einstellungen in grafischen Clients wie FileZilla, Cyberduck oder WinSCP:

Konfigurieren Sie den Client für Uploads der vollständigen Datei über eine einzelne Verbindung. Symbolische Links sowie Änderungen an POSIX-Eigentümerschaft, Berechtigungen oder Zeitstempeln werden nicht unterstützt, weil das Gateway SFTP-Operationen auf Objektspeicher abbildet.

Nächste SchritteCopy Anchor Link

• Zugangsdaten verwalten
• Dienststatus prüfen
• Lebenszyklusverwaltung konfigurieren