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

Utilisation : shared-cache [options]

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

  Options de stockage S3 (lorsque --storage-backend=s3) :
  --s3-endpoint <url>                URL du point de terminaison S3
  --s3-bucket <nom>                 Nom du bucket S3
  --s3-region <région>               Région S3
  --s3-access-key-id <clé>           ID de clé d’accès S3
  --s3-secret-access-key <secret>    Clé d’accès secrète S3
  --s3-path-prefix <préfixe>          Préfixe de clé S3 (facultatif)

  Options avancées :
  --download-worker-count <nombre>   Nombre de travailleurs de téléchargement (par défaut : 5)
  --download-concurrent-chunks <n>   Nombre de blocs simultanés par travailleur (par défaut : 4)
  --download-chunk-size <octets>      Taille des blocs de téléchargement (par défaut : 128MB)
  --upload-concurrent-chunks <n>     Nombre de blocs simultanés d’envoi (par défaut : 4)
  --upload-chunk-size <octets>        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.