> 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/cache-partage/using-shared-cache.md). # Utilisation du cache partagé Shared Cache est un serveur sur site qui permet aux équipes de partager en toute sécurité les fichiers auxquels d’autres membres de l’équipe ont accédé au sein du même LAN. Par exemple : 1. **Membre de l’équipe 1** accède à `large_video.mp4` alors qu’il est connecté au cache partagé 2. ShadeFS commence à diffuser ce fichier à **Membre de l’équipe 1** depuis le cloud 3. En arrière-plan, le cache partagé commence également à mettre en cache `large_video.mp4` 4. Le cache partagé termine entièrement la mise en cache de `large_video.mp4` 5. **Membre de l’équipe 2** accède maintenant à `large_video.mp4` dans ShadeFS 6. Le cache partagé exécute des vérifications d’autorisations pour valider **Membre de l’équipe 2** a accès à `large_video.mp4` 7. `large_video.mp4` est immédiatement servi à la vitesse maximale du LAN depuis le cache partagé Dans cette configuration, le deuxième accès est servi à la vitesse maximale, ce qui rend la lecture largement instantanée et évite d’utiliser de la bande passante vers le cloud. Les grandes instances de cache partagé peuvent presque entièrement éviter les aller-retour vers le cloud, sauf pour le premier accès. ## Téléchargement et installation Shared Cache est un exécutable terminal sans interface utilisateur. Vous pouvez obtenir une version à télécharger en nous le demandant. Les valeurs par défaut conviennent généralement à la plupart des configurations, ce qui signifie que pour la plupart des gens, il suffit généralement d’un double-clic pour le lancer. ## Prise en charge de S3 Shared Cache prend en charge l’utilisation à la fois d’un backend local (disque) et d’une cible S3 sur site pour mettre les données en cache. Cela peut être activé en passant `--storage-backend=s3` avec l’endpoint, le bucket, la région, l’accès et le secret. ## Options de configuration ```bash Utilisation : shared-cache [options] Options : --port Port du serveur (par défaut : 8003) --fs-ws-url URL WebSocket ShadeFS en amont (par défaut : wss://fs.shade.inc) --fs-api-url URL API ShadeFS en amont (par défaut : https://fs.shade.inc) --local-cache-location Répertoire de stockage du cache (par défaut : ./cache) --database-location Chemin du fichier de base de données SQLite (par défaut : ./shared_cache.db) --max-cache-size Taille maximale du cache en octets (par défaut : 500GB) --cache-check-interval Intervalle de nettoyage du cache en millisecondes (par défaut : 300000) --storage-backend Backend de stockage : système de fichiers ou s3 (par défaut : filesystem) --discovery-server-name Nom du service mDNS (par défaut : Default Name) Options de stockage S3 (lorsque --storage-backend=s3) : --s3-endpoint URL du point de terminaison S3 --s3-bucket Nom du bucket S3 --s3-region Région S3 --s3-access-key-id ID de clé d’accès S3 --s3-secret-access-key Clé d’accès secrète S3 --s3-path-prefix Préfixe de clé S3 (facultatif) Options avancées : --download-worker-count Nombre de travailleurs de téléchargement (par défaut : 5) --download-concurrent-chunks Nombre de blocs simultanés par travailleur (par défaut : 4) --download-chunk-size Taille des blocs de téléchargement (par défaut : 128MB) --upload-concurrent-chunks Nombre de blocs simultanés d’envoi (par défaut : 4) --upload-chunk-size Taille des blocs d’envoi (par défaut : 64MB) --version, -v Afficher les informations de version --help, -h Afficher ce message d’aide Variables d’environnement : Toutes les options peuvent également être définies via des variables d’environnement en utilisant SCREAMING_SNAKE_CASE. Exemple : PORT, FS_WS_URL, CACHE_LOCATION, MAX_CACHE_SIZE_BYTES, etc. Exemples : ./shared-cache --port 8080 --local-cache-location /var/cache/shade ./shared-cache --storage-backend s3 --s3-bucket my-bucket --s3-region us-east-1 PORT=8080 LOCAL_CACHE_LOCATION=/var/cache/shade ./shared-cache ``` ## Rejoindre le cache partagé Comme les autorisations sont gérées par le cache partagé, rejoindre est incroyablement simple et ne nécessite aucun mot de passe. Le cache partagé diffuse sa présence via Bonjour. Dans la plupart des cas, les clients sur le même réseau le détectent et une fenêtre modale s’affiche pour demander s’ils souhaitent le rejoindre. Si aucune fenêtre modale n’apparaît, il est possible de rejoindre le cache directement en allant dans Paramètres → Cache partagé → Se connecter manuellement et en saisissant l’adresse. Un exemple de saisie pourrait ressembler à `http://192.168.1.45:8003` ## Le cache partagé ne fonctionne pas ? Si le cache partagé ne fonctionne pas ou si vous ne voyez pas d’autres appareils sur votre réseau : 1. Ouvrez Réglages système → Confidentialité et sécurité → Réseau local. 2. Assurez-vous que Shade est activé. 3. S’il était désactivé, activez-le et redémarrez Shade avant de réessayer. --- # 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://academy.shade.inc/shade-academy/shade-academy-fr/cache-partage/using-shared-cache.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.