File Manager — Guide utilisateur | YoBench

À quoi sert le module « File Manager »

Le File Manager est un explorateur unique pour les fichiers de votre ordinateur et ceux du stockage cloud. Au lieu de jongler entre Finder/Explorer, un client FTP, une console S3 et WinSCP, vous obtenez une seule fenêtre où vous pouvez ouvrir jusqu'à quatre dossiers côte à côte, glisser-déposer des fichiers entre eux et garder un œil sur les longues copies via la file de transferts.

Ce que vous obtenez :

• Quatre types de connexions — disque local, FTP, SFTP et stockage compatible S3 (Amazon S3, MinIO, Yandex Cloud, Backblaze B2, Cloudflare R2 et autres).
• Jusqu'à quatre dossiers côte à côte — un explorateur à deux, trois ou quatre panneaux avec navigation, tri et filtres indépendants par colonne.
• File de transferts — les copies et déplacements sont visibles dans un panneau séparé avec la progression par fichier et en octets, avec pause, reprise et annulation.
• Téléversements reprenables — les gros fichiers vers S3 sont découpés en parties de 8 Mo ; si la connexion tombe, le transfert reprend à partir de la dernière partie réussie.
• Résolution des conflits — quand des noms se chevauchent, vous pouvez ignorer, écraser ou renommer automatiquement, avec une option « appliquer à tout ».
• Inspecteur — aperçu pour les images, le texte, les PDF, la vidéo et l'audio, ainsi que les propriétés du fichier et le hash SHA256 à la demande.
• Archives ZIP — créez et extrayez directement dans l'explorateur.
• Restauration de session — les dossiers et panneaux ouverts reviennent après un redémarrage de l'application.
• Identifiants chiffrés — les mots de passe FTP, les clés SSH et les clés d'accès cloud sont stockés chiffrés.

Connexions supportées et leurs paramètres

Local

• Folder — chemin vers le dossier. Le bouton Choose ouvre le sélecteur système.

FTP

• Host — adresse du serveur.
• Port — 21 par défaut.
• Username et Password.
• Root path — utilisé comme « racine » de la connexion, / par défaut.
• Use TLS — case à cocher pour FTPS, désactivée par défaut.
• La connexion fonctionne en mode passif.

SFTP

• Host et Port (22 par défaut).
• Username.
• Password — pour l'authentification par mot de passe (optionnel).
• Private Key — le texte de la clé privée SSH (-----BEGIN OPENSSH PRIVATE KEY-----…). Optionnel.
• Passphrase — si la clé est protégée par une passphrase.
• Host Fingerprint — empreinte du serveur sous la forme SHA256:… pour une validation trust-on-first-use. Optionnel.
• Root path — / par défaut.

Vous pouvez utiliser un mot de passe, une clé ou les deux en même temps.

Stockage compatible S3

• S3 Endpoint — URL du fournisseur. Laissez vide pour AWS S3. Exemples : https://storage.yandexcloud.net, https://s3.us-west-002.backblazeb2.com, https://<account>.r2.cloudflarestorage.com, http://localhost:9000 pour MinIO.
• S3 Region — us-east-1 par défaut.
• S3 Bucket — obligatoire.
• S3 Prefix — préfixe optionnel à l'intérieur du bucket, utilisé comme « racine » de la connexion.
• S3 Access Key et S3 Secret Key.
• Force Path Style — case à cocher pour les fournisseurs qui exigent des URL de type chemin plutôt que virtual-hosted (comme MinIO). Désactivée par défaut.

Pour les gros fichiers, le téléversement multipart démarre automatiquement avec une taille de partie de 8 Mo.

Comment la fenêtre est organisée

Le File Manager comporte jusqu'à quatre colonnes simultanément. Chaque colonne affiche :

• Address bar — le chemin courant ; cliquez pour l'éditer (ou appuyez sur Cmd/Ctrl+L).
• File list — triable par nom, taille, date de modification ou type.
• Search / filter input — filtre la liste par sous-chaîne.
• Hidden files toggle — affiche ou masque les fichiers cachés.

Les colonnes peuvent être ajoutées et retirées. Quand moins de quatre sont ouvertes, un bouton + Add column apparaît à droite. Passez d'une colonne à l'autre avec Tab / Shift+Tab ou sautez directement avec Cmd/Ctrl+1..4.

À droite, vous pouvez ouvrir l'inspecteur — un panneau latéral avec trois onglets :

• Preview — aperçu du fichier sélectionné. Supporte les images, le texte (jusqu'à 100 000 caractères), les PDF, la vidéo et l'audio. Pour les archives et les binaires, seules les métadonnées sont affichées.
• Properties — taille, date de modification, chemin complet.
• Hash — SHA256 calculé à la demande.

La largeur de l'inspecteur est ajustable à la souris (entre 280 et 720 pixels).

File de transferts

Toutes les opérations longues (copie, déplacement, téléversement, téléchargement) atterrissent dans le panneau de transferts au bas de la fenêtre. Vous pouvez le masquer et le réafficher.

Chaque tâche affiche :

• Le type d'opération (copie, déplacement, téléversement).
• La progression — fichiers traités sur le total.
• L'état — en cours, en pause, terminée, annulée ou échouée.
• La progression en octets.

Actions disponibles :

• Pause (‖) — met en pause une tâche en cours.
• Resume (▶) — reprend une tâche en pause ou échouée.
• Cancel (×) — annule une tâche dans n'importe quel état.
• Clear finished — retire les tâches terminées de la liste.

Si un fichier du même nom existe déjà à la destination, la boîte de résolution de conflit s'ouvre :

• Skip — ignorer ce fichier.
• Overwrite — remplacer l'existant.
• Rename — ajouter (1), (2) et ainsi de suite.
• Apply to all remaining conflicts — appliquer votre choix à tous les conflits restants de cette tâche.
• Cancel job — annuler toute l'opération.

Archives

Le menu contextuel d'un fichier ou d'un dossier contient les entrées Create archive et Extract archive :

• Format supporté : ZIP.
• Les archives peuvent être construites à partir de fichiers sélectionnés dans n'importe quelle colonne (par exemple, empaqueter un dossier local et téléverser le ZIP directement vers S3).
• Les archives peuvent être extraites dans n'importe quel dossier de n'importe quelle connexion.
• Protection contre les zip-bombs : l'extraction est plafonnée à 10 Go de données décompressées.

Restauration de session

Après un redémarrage de l'application, les éléments suivants sont restaurés :

• Quelles colonnes étaient ouvertes et leurs largeurs.
• La connexion et le dossier courant pour chaque colonne.
• Le tri, le filtre et le toggle des fichiers cachés.
• La colonne active et la largeur de l'inspecteur.

La connexion elle-même est stockée séparément et n'est jamais perdue. La session est sauvegardée automatiquement avec un debounce de 0,5 seconde après chaque changement.

Mises à jour en direct des dossiers

Pour les dossiers locaux, le File Manager surveille le système de fichiers et rafraîchit la liste tout seul — ajoutez ou supprimez un fichier dans Finder/Explorer et la colonne se met à jour immédiatement. Pour les connexions distantes (FTP, SFTP, S3), le rafraîchissement automatique n'est pas disponible — appuyez sur Cmd/Ctrl+R ou sur le bouton Refresh pour relire le dossier.

Sécurité

• Les mots de passe FTP, les clés SSH, les passphrases et les identifiants S3 sont stockés chiffrés dans la base locale de l'application.
• Le renderer (processus UI) ne voit jamais les secrets bruts — seulement des indicateurs « password set » / « key set ».
• Le bouton Show password est limité à cinq révélations par heure et par processus.
• Pour SFTP, vous pouvez épingler une empreinte de serveur (SHA256:…) ; à la prochaine connexion, l'application la vérifiera — vous protégeant ainsi contre l'usurpation du serveur sur le réseau.

Raccourcis clavier

Réglages

Les réglages du File Manager comportent quatre sections :

• Sources — CRUD complet sur les connexions enregistrées, avec les boutons Test, masquer et supprimer.
• Behaviour — valeurs par défaut : afficher ou non les fichiers cachés, comportement du glisser-déposer, etc.
• Hotkeys — table de référence des raccourcis clavier.
• About — informations sur le module.

Flux d'utilisation

1. Connectez un dossier local

1. Ouvrez File Manager depuis la barre latérale.
2. Settings → Sources → New source.
3. Type — Local.
4. Nom (par exemple « Documents ») et chemin.
5. Enregistrez.
6. Dans l'explorateur, cliquez sur + Add column et choisissez la nouvelle connexion.

2. Connectez-vous à S3

1. Settings → Sources → New source → type S3.
2. Renseignez Endpoint (ou laissez vide pour AWS), Region, Bucket, Access Key, Secret Key.
3. Si votre fournisseur a besoin d'URL de type chemin (comme MinIO), activez Force Path Style.
4. Test — la connexion devrait lister les objets avec succès.
5. Enregistrez.

3. Copiez des fichiers entre fournisseurs

1. Ouvrez deux colonnes — une avec le dossier local, l'autre avec S3 (ou FTP).
2. Sélectionnez les fichiers dans la colonne source (Cmd/Ctrl+A, Shift+click, Cmd/Ctrl+click).
3. Glissez la sélection dans la colonne de destination — ou appuyez sur F5 (copier) / F6 (déplacer).
4. Le transfert apparaît dans le panneau de transferts en bas. Si des fichiers existent déjà, la boîte de conflit s'ouvre.
5. Fermez la fenêtre ou continuez à travailler — le transfert tourne en arrière-plan. Vous pouvez le mettre en pause et le reprendre plus tard, y compris à travers les redémarrages de l'application.

4. Extrayez une archive cloud sur votre ordinateur

1. Ouvrez deux colonnes : S3 (ou FTP) et un dossier local.
2. Trouvez l'archive ZIP dans la colonne distante.
3. Clic droit sur l'archive → Extract archive.
4. Choisissez le dossier de destination — même directement dans la colonne locale.
5. L'extraction tourne en arrière-plan comme n'importe quel autre transfert — avec progression et support de la pause.

Étapes suivantes

• DB Manager — planifiez les sauvegardes de bases directement vers S3 ou un serveur FTP.
• Scenarios — automatisez les déplacements de fichiers récurrents et réutilisez les mêmes connexions.
• Settings — configurez un mot de passe maître pour protéger toutes les connexions enregistrées.

Aide et retour

Quelque chose ne fonctionne pas ou une fonctionnalité manquante ? Contactez-nous via le formulaire de retour.