> For the complete documentation index, see [llms.txt](https://academy.shade.inc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.shade.inc/shade-academy/shade-academy-fr/shadefs/introduction-to-shadefs.md). # Introduction à ShadeFS ## **Aperçu** ShadeFS est une solution de montage de disque cloud qui transforme complètement la façon dont vous interagissez avec les fichiers multimédias stockés dans le cloud. Contrairement aux solutions de stockage cloud traditionnelles qui exigent le téléchargement complet des fichiers avant d’y accéder (hum, Dropbox), ShadeFS diffuse en temps réel les segments dont vous avez besoin, un peu comme YouTube livre le contenu vidéo. Cette approche vous donne un accès immédiat à vos médias tout en optimisant l’utilisation de la bande passante. ## **Fonctionnalités clés** * ShadeFS transforme votre disque cloud en un dossier local accessible par défaut via le dossier « /Volumes » * Lorsque vous montez un disque, il apparaît dans votre système de fichiers local comme un disque dur physique, avec en plus l’avantage du streaming intelligent et de la mise en cache * Le système synchronise automatiquement les arborescences de fichiers entre tous les utilisateurs, garantissant que tout le monde dans votre équipe travaille avec la même structure de contenu, quel que soit son emplacement. * Les fichiers téléchargés sont automatiquement acheminés via nos pipelines de génération de proxys et d’analyse par IA ## **Configuration requise** ShadeFS a quelques prérequis pour fonctionner de manière optimale sur votre machine. * Pour travailler avec du contenu vidéo 4K, nous recommandons une vitesse Internet minimale de 500 Mbit/s en téléchargement * Les utilisateurs disposant d’une bande passante plus faible devraient envisager de travailler avec des fichiers proxy ou du contenu en résolution inférieure à la 4K * Votre appareil doit également disposer de suffisamment d’espace de stockage pour le cache, avec un minimum de 10 Go pour les opérations de base ## **Prise en main** Une fois que vous avez téléchargé et ouvert l’application de bureau, vous pouvez monter n’importe quel disque en le sélectionnant dans le panneau de gauche, en cliquant sur le menu « ... », puis en choisissant « Monter le disque ». Le disque apparaîtra dans votre explorateur de fichiers local, que vous utilisiez Windows, macOS ou Linux. {% embed url="" %} ## **Emplacement de montage** Par défaut, chaque disque se monte à l’emplacement standard de votre système d’exploitation. Les propriétaires et administrateurs de l’espace de travail peuvent définir un emplacement de montage personnalisé par disque dans les paramètres du disque, sous **Général > Chemin de montage personnalisé**, en utilisant les champs **chemin macOS**, **chemin Linux**, et **chemin Windows** Sur Windows, vous pouvez monter un disque sur une lettre de lecteur telle que `X:` ou `Z:` (les lecteurs système C:, D: et E: ne sont pas autorisés). Laissez un champ vide pour utiliser la valeur par défaut du système. ## **Backend de montage (macOS)** Sur macOS, ShadeFS monte les disques via un serveur de fichiers intégré à l’application de bureau Shade, donc vous n’avez rien d’autre à installer. Le serveur s’exécute uniquement sur votre Mac, et les disques montés apparaissent sous `/Volumes` comme n’importe quel autre disque. Si vous préférez macFUSE, installez-le et activez **Utiliser le backend macFUSE** dans **Paramètres > ShadeFS > Configuration**. Un seul disque peut être monté à la fois avec le backend macFUSE, et ShadeFS redémarre lorsque vous activez ou désactivez ce réglage. ## **Configuration du cache** ShadeFS utilise un système de cache pour optimiser les performances de vos fichiers multimédias. Par défaut, le système crée un cache de 26 Go dans le dossier **.shade** situé à la racine de votre répertoire utilisateur. Cependant, vous pouvez personnaliser à la fois l’emplacement et la taille du cache dans **Paramètres > ShadeFS > Gestion du cache** pour mieux répondre à vos besoins. [Gestion du cache de ShadeFS](https://academy.shade.inc/shadefs/managing-the-shadefs-cache) ## **Répertoire du cache** Pour modifier le répertoire de votre cache, ouvrez **Paramètres > ShadeFS > Gestion du cache** dans l’application de bureau et cliquez sur le **répertoire du cache ShadeFS** (dans la version 2.3.21 et antérieure de l’application de bureau, ce réglage se trouve sous **Paramètres > ShadeFS > Configuration**). Vous pouvez ici sélectionner n’importe quel dossier sur votre ordinateur ou un disque externe comme emplacement du cache. Nous recommandons particulièrement d’utiliser un SSD externe haute vitesse, comme un Samsung T7, pour des performances optimales. L’emplacement du cache doit se trouver sur un disque formaté en APFS (macOS), NTFS ou ReFS (Windows), ou ext4, XFS ou Btrfs (Linux). Les disques formatés en exFAT ou Mac OS étendu (HFS+) ne peuvent pas être utilisés pour le cache. ## **Directives d’utilisation de ShadeFS** ## **Autorisations** Les capacités d’accès et de montage de ShadeFS sont réservées aux contractants, membres et administrateurs de l’espace de travail. Lorsque plusieurs utilisateurs montent le même disque, ils voient tous une arborescence de fichiers identique, ce qui facilite une collaboration fluide entre équipes distantes. ## **Téléversements** Pour les téléversements à grande échelle dépassant 1000 éléments ou 100 Go, nous recommandons d’utiliser l’application web ou l’application de bureau plutôt que de téléverser via le disque monté. Nous avons optimisé le téléversement via l’interface de l’application pour les fichiers volumineux. Quelle que soit la méthode de téléversement choisie, le contenu sera automatiquement visible dans l’application web et l’application de bureau, déclenchant nos systèmes automatiques de génération de proxys et de traitement par IA. Les fichiers peuvent être déplacés d’un disque à l’autre en montant d’abord plusieurs disques, puis en déplaçant les fichiers via l’explorateur de fichiers de votre ordinateur entre les disques ## **Accès hors ligne** ShadeFS offre des capacités d’accès hors ligne grâce au **marquage**. Pour accéder à des fichiers ou dossiers spécifiques avec une connexion Internet faible (ou inexistante), faites simplement un clic droit sur les fichiers/dossiers dans l’application et sélectionnez « Épingler dans le cache ». Cette action télécharge une copie complète du contenu sélectionné dans votre cache local, le rendant pleinement accessible même hors ligne. Vous pouvez consulter les fichiers que vous avez épinglés via la page **Éléments épinglés** . Voir plus sur [Épingler des fichiers hors ligne](https://academy.shade.inc/shadefs/pinning-files-offline). ## **Optimisation des performances** Il existe plusieurs façons de maximiser les performances de ShadeFS. * Utilisez un SSD externe pour le stockage du cache afin d’améliorer considérablement les vitesses d’accès et la réactivité globale du système * Nous vous recommandons de configurer la taille du cache en fonction de votre charge de travail habituelle afin de garantir que les fichiers fréquemment consultés restent facilement disponibles * Bien que ShadeFS soit conçu pour fonctionner efficacement avec la bande passante disponible, essayez de maintenir une connexion Internet stable pendant que vous utilisez le montage * Pour les utilisateurs travaillant avec du contenu haute résolution sur une bande passante limitée, nous recommandons de créer des fichiers proxy ## **Intégration avec l’écosystème Shade** Contrairement à d’autres outils de diffusion de fichiers, ShadeFS est profondément intégré à l’application web et à l’application de bureau. Lorsque vous téléversez des fichiers via un disque monté, ils sont automatiquement indexés dans le système Shade, où ils sont immédiatement visibles dans les applications web et de bureau. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://academy.shade.inc/shade-academy/shade-academy-fr/shadefs/introduction-to-shadefs.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.