FTP(S)

RustFS inclut une passerelle FTP qui expose les compartiments (buckets) et les objets aux clients FTP standard. Vous pouvez l’exécuter en FTP non chiffré pour des tests locaux isolés, ou en FTP explicite sur TLS (FTPS) pour des connexions chiffrées. RustFS authentifie chaque session auprès de la gestion des identités et des accès (IAM) et applique les politiques S3 de l’utilisateur aux opérations de stockage.

La prise en charge de FTP et de FTPS est compilée dans le binaire RustFS standard, mais les deux écouteurs sont désactivés par défaut à l’exécution. N’activez que l’écouteur que vous comptez utiliser.

Vue d’ensembleCopy Anchor Link

La passerelle associe les chemins FTP aux ressources RustFS :

Les opérations FTP suivantes sont prises en charge :

RustFS ne prend actuellement en charge ni le renommage FTP ni les chargements qui ajoutent du contenu à un objet existant. Comme le stockage S3 n’a pas de répertoire de travail natif ni de modèle de répertoires POSIX, certaines opérations de système de fichiers propres à un client peuvent ne pas se comporter comme sur un serveur FTP classique.

Saisissez une clé d’accès RustFS comme nom d’utilisateur FTP et la clé secrète correspondante comme mot de passe. Un nom d’utilisateur non valide et un mot de passe non valide renvoient tous deux 530 Not logged in. Après la connexion, RustFS vérifie les autorisations S3 de l’utilisateur IAM pour chaque opération.

ConfigurationCopy Anchor Link

FTP et FTPS utilisent des écouteurs et des variables d’environnement distincts.

Variables FTPCopy Anchor Link

Variables FTPSCopy Anchor Link

La compilation RustFS standard active la fonctionnalité de compilation ftps, qui fournit à la fois FTP et FTPS. Si vous compilez RustFS avec --no-default-features, incluez la fonctionnalité explicitement :

cargo build --release --features ftps

Tests locaux avec FTPCopy Anchor Link

Démarrez un écouteur FTP non chiffré sur l’interface de bouclage :

export RUSTFS_FTP_ENABLE=true
export RUSTFS_FTP_ADDRESS=127.0.0.1:8021
export RUSTFS_FTP_PASSIVE_PORTS=40000-40010
export RUSTFS_ACCESS_KEY=<your-access-key>
export RUSTFS_SECRET_KEY=<your-secret-key>

rustfs /path/to/data

La liaison à 127.0.0.1 empêche les hôtes distants de se connecter à l’écouteur non chiffré.

Préparer un certificat de testCopy Anchor Link

FTPS attend rustfs_cert.pem et rustfs_key.pem dans le répertoire de certificats. Pour un test local, créez un certificat autosigné de courte durée :

mkdir -p /path/to/ftps-certs

openssl req -x509 -newkey rsa:2048 -nodes \
	-keyout /path/to/ftps-certs/rustfs_key.pem \
	-out /path/to/ftps-certs/rustfs_cert.pem \
	-days 7 \
	-subj "/CN=localhost" \
	-addext "subjectAltName=DNS:localhost,IP:127.0.0.1"

En production, utilisez un certificat émis par une autorité de certification de confiance. Protégez rustfs_key.pem contre tout accès non autorisé et assurez-vous que les noms alternatifs du sujet du certificat correspondent à l’hôte utilisé par les clients.

Démarrer FTPSCopy Anchor Link

Configurez un écouteur FTPS explicite :

export RUSTFS_FTPS_ENABLE=true
export RUSTFS_FTPS_ADDRESS=0.0.0.0:8022
export RUSTFS_FTPS_TLS_ENABLED=true
export RUSTFS_FTPS_CERTS_DIR=/path/to/ftps-certs
export RUSTFS_FTPS_PASSIVE_PORTS=40000-50000

rustfs /path/to/data

RustFS exige TLS à la fois sur le canal de contrôle et sur le canal de données FTPS. Configurez les clients pour explicit FTP over TLS, parfois libellé FTPES ou Require explicit FTP over TLS. Le FTPS implicite n’est pas le mode implémenté par cet écouteur.

Si le répertoire de certificats est absent, n’existe pas ou ne contient pas un certificat et une clé utilisables, l’initialisation de FTPS échoue. Consultez Configurer TLS pour des indications générales sur les certificats.

Configurer les connexions passivesCopy Anchor Link

FTP utilise le port de contrôle pour les commandes et une connexion de données distincte pour les listes et les transferts de fichiers. Pour le mode passif :

1. Autorisez le trafic TCP entrant vers le port de contrôle configuré.
2. Autorisez le trafic TCP entrant vers chaque port de la plage passive configurée.
3. Définissez RUSTFS_FTP_EXTERNAL_IP ou RUSTFS_FTPS_EXTERNAL_IP lorsque les clients se connectent à travers un NAT ou un répartiteur de charge.

Par exemple, un serveur FTPS derrière un NAT peut annoncer son nom d’hôte public :

export RUSTFS_FTPS_EXTERNAL_IP=storage.example.com
export RUSTFS_FTPS_PASSIVE_PORTS=40000-40100

Utilisez les variables préfixées par FTP correspondantes pour l’écouteur FTP en clair. RustFS prend en charge les modes de transfert actif et passif, mais le mode passif est en général plus simple à exploiter à travers les pare-feu des clients.

UtilisationCopy Anchor Link

Les exemples utilisent lftp ainsi que les noms canoniques my-bucket et hello.txt. L’utilisateur IAM doit disposer des autorisations S3 requises pour chaque opération.

Se connecter en FTPCopy Anchor Link

Utilisez le FTP en clair uniquement avec l’écouteur de test en bouclage :

lftp -u <your-access-key> ftp://127.0.0.1:8021

Saisissez la clé secrète lorsque lftp demande un mot de passe.

Se connecter en FTPSCopy Anchor Link

Connectez-vous à l’écouteur FTPS explicite et exigez le chiffrement des connexions de contrôle et de données :

lftp -u <your-access-key> -e '
	set ftp:ssl-force true;
	set ftp:ssl-protect-data true;
	open ftp://storage.example.com:8022
'

Saisissez la clé secrète lorsque vous y êtes invité. Laissez la vérification des certificats activée en production.

Pour le seul certificat de test local autosigné, connectez-vous à localhost et désactivez la vérification des certificats pour cette session :

lftp -u <your-access-key> -e '
	set ftp:ssl-force true;
	set ftp:ssl-protect-data true;
	set ssl:verify-certificate no;
	open ftp://localhost:8022
'

Répertorier les compartiments et créer un compartimentCopy Anchor Link

À l’invite lftp, répertoriez les compartiments visibles et créez my-bucket :

lftp> cls -1 /
lftp> mkdir my-bucket
lftp> cd my-bucket

Les noms de compartiment doivent suivre les mêmes règles de nommage que les compartiments créés via l’API S3.

Charger et télécharger un objetCopy Anchor Link

Chargez /path/to/hello.txt, répertoriez le compartiment, puis téléchargez l’objet :

lftp> put /path/to/hello.txt -o hello.txt
lftp> ls
lftp> get hello.txt -o hello.txt

Le chargement remplace un objet de même clé. L’ajout de contenu à un objet existant n’est pas pris en charge.

Supprimer un objet et un compartimentCopy Anchor Link

Supprimez l’objet, revenez à la racine, puis supprimez le compartiment :

lftp> rm hello.txt
lftp> cd /
lftp> rmdir my-bucket

N’oubliez pas que rmdir retire récursivement les objets restants du compartiment avant de le supprimer.

Connecter d’autres clientsCopy Anchor Link

Utilisez ces paramètres dans les clients FTP graphiques tels que FileZilla ou Cyberduck :

Si la connexion réussit, mais que le listage des répertoires ou les transferts expirent, vérifiez d’abord les règles de pare-feu des ports passifs et le paramètre d’adresse IP externe.

Étapes suivantesCopy Anchor Link

• Gérer les identifiants
• Configurer TLS
• Vérifier l’état du service