> 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é des fichiers auxquels d'autres membres de l'équipe ont accédé au sein du même réseau local.

Par exemple :

1. **Membre de l'équipe 1** accède à `large_video.mp4` lorsqu'il est connecté au cache partagé
2. ShadeFS commence à servir 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'autorisation 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 réseau local depuis le cache partagé

Dans cette configuration, le deuxième accès est à la fois 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 allers-retours vers le cloud, sauf pour le premier accès.

## Téléchargement et installation

Shared Cache est un exécutable terminal sans interface graphique. Vous pouvez obtenir une version à télécharger en nous le demandant. Les valeurs par défaut sont généralement correctes pour 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 S3

Shared Cache prend en charge l'utilisation à la fois d'un backend local (disque) et d'une cible S3 sur site pour mettre en cache les données. Cela peut être activé en passant `--storage-backend s3` avec le point de terminaison, le bucket, la région, la clé d'accès et le secret.

## Options de configuration

Les options sont passées sous la forme `--option value`. Les options non reconnues sont ignorées sans erreur ; vérifiez donc les paramètres affichés par Shared Cache au démarrage pour confirmer que vos valeurs ont bien été prises en compte.

```bash
Utilisation : shared-cache [options]

Options :
  --port <number>                          Port du serveur (par défaut : 8003)
  --fs-ws-url <url>                        URL WebSocket du ShadeFS amont (par défaut : wss://fs.shade.inc)
  --fs-api-url <url>                       URL de l'API ShadeFS amont (par défaut : https://fs.shade.inc)
  --local-cache-location <path>            Répertoire de stockage du cache (par défaut : ./cache)
  --database-location <path>               Chemin du fichier de base de données SQLite (par défaut : ./shared_cache.db)
  --max-cache-size-bytes <bytes>           Taille maximale du cache en octets (par défaut : 500 Go)
  --cache-check-interval-ms <ms>           Intervalle de nettoyage du cache en millisecondes (par défaut : 300000)
  --storage-backend <type>                 Backend de stockage : local ou s3 (par défaut : local)
  --discovery-server-name <name>           Nom du service mDNS (par défaut : Nom par défaut)

  Options de stockage S3 (lorsque --storage-backend=s3) :
  --s3-endpoint <url>                      URL du point de terminaison S3
  --s3-bucket <name>                       Nom du bucket S3
  --s3-region <region>                     Région S3
  --s3-access-key-id <key>                 ID de la clé d'accès S3
  --s3-secret-access-key <secret>          Clé d'accès secrète S3
  --s3-path-prefix <prefix>                Préfixe de clé S3 (facultatif)
  --s3-url-expiry-seconds <seconds>        Expiration de l'URL présignée (par défaut : 86400)

  Options avancées :
  --download-worker-concurrent-chunks <n>  Morceaux simultanés par worker de téléchargement (par défaut : 10)
  --download-worker-chunk-size <bytes>     Taille des morceaux téléchargés en octets (par défaut : 128 Mo)
  --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 le format SCREAMING_SNAKE_CASE.
  Exemple : PORT, FS_WS_URL, LOCAL_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 permissions sont gérées par le cache partagé, le rejoindre est incroyablement simple et ne nécessite aucun mot de passe. Le cache partagé se signale via Bonjour. Dans la plupart des cas, les clients sur le même réseau le détectent et une fenêtre modale apparaît pour demander s'ils souhaitent le rejoindre.

Si aucune fenêtre modale n'apparaît, le cache peut être rejoint directement en allant dans Réglages → 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 les 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 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/cache-partage/using-shared-cache.md?ask=<question>&goal=<user_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.