> 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-es/cache-compartida/using-shared-cache.md).

# Uso de la caché compartida

Shared Cache es un servidor local que permite a los equipos compartir de forma segura archivos a los que han accedido otros miembros del equipo dentro de la misma LAN.

Como ejemplo:

1. **Miembro del equipo 1** accede `large_video.mp4` mientras está conectado a la caché compartida
2. ShadeFS comienza a servir ese archivo a **Miembro del equipo 1** desde la nube
3. En segundo plano, la caché compartida también comienza a almacenar en caché `large_video.mp4`
4. La caché compartida termina por completo de almacenar en caché `large_video.mp4`
5. **Miembro del equipo 2** ahora accede a `large_video.mp4` en ShadeFS
6. La caché compartida ejecuta comprobaciones de permisos para validar **Miembro del equipo 2** tiene acceso a `large_video.mp4`
7. `large_video.mp4` se sirve inmediatamente a la velocidad máxima de la LAN desde la caché compartida

En esta configuración, el segundo acceso se sirve a la velocidad máxima, lo que hace que la reproducción sea en gran medida instantánea y evita usar ancho de banda hacia la nube. Las instancias grandes de caché compartida pueden evitar casi por completo los viajes de ida y vuelta a la nube, excepto para el primer acceso.

## Descarga e instalación

Shared Cache es un ejecutable de terminal sin interfaz de usuario. Puedes obtener una versión para descargar si nos la pides. Los valores predeterminados suelen ser correctos para la mayoría de las configuraciones, lo que significa que para la mayoría de las personas normalmente basta con hacer doble clic para iniciarlo.

## Compatibilidad con S3

Shared Cache admite el uso tanto de un backend local (disco) como de un destino S3 local para almacenar datos en caché. Esto puede habilitarse pasando `--storage-backend s3` con el endpoint, bucket, región, acceso y secreto.

## Opciones de configuración

Las opciones se pasan como `--option value`. Las opciones no reconocidas se ignoran sin error, así que revisa la configuración que imprime Shared Cache cuando se inicia para confirmar que tus valores se aplicaron.

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

Opciones:
  --port <number>                          Puerto del servidor (predeterminado: 8003)
  --fs-ws-url <url>                        URL WebSocket de ShadeFS aguas arriba (predeterminado: wss://fs.shade.inc)
  --fs-api-url <url>                       URL de API de ShadeFS aguas arriba (predeterminado: https://fs.shade.inc)
  --local-cache-location <path>            Directorio de almacenamiento de la caché (predeterminado: ./cache)
  --database-location <path>               Ruta al archivo de base de datos SQLite (predeterminado: ./shared_cache.db)
  --max-cache-size-bytes <bytes>           Tamaño máximo de la caché en bytes (predeterminado: 500GB)
  --cache-check-interval-ms <ms>           Intervalo de limpieza de la caché en milisegundos (predeterminado: 300000)
  --storage-backend <type>                 Backend de almacenamiento: local o s3 (predeterminado: local)
  --discovery-server-name <name>           Nombre del servicio mDNS (predeterminado: Default Name)

  Opciones de almacenamiento S3 (cuando --storage-backend=s3):
  --s3-endpoint <url>                      URL del endpoint S3
  --s3-bucket <name>                       Nombre del bucket S3
  --s3-region <region>                     Región S3
  --s3-access-key-id <key>                 ID de la clave de acceso S3
  --s3-secret-access-key <secret>          Clave de acceso secreta S3
  --s3-path-prefix <prefix>                Prefijo de clave S3 (opcional)
  --s3-url-expiry-seconds <seconds>        Caducidad de la URL prefirmada (predeterminado: 86400)

  Opciones avanzadas:
  --download-worker-concurrent-chunks <n>  Fragmentos concurrentes por trabajador de descarga (predeterminado: 10)
  --download-worker-chunk-size <bytes>     Tamaño del fragmento de descarga en bytes (predeterminado: 128MB)
  --version, -v                            Mostrar información de la versión
  --help, -h                               Mostrar este mensaje de ayuda

Variables de entorno:
  Todas las opciones también pueden configurarse mediante variables de entorno usando SCREAMING_SNAKE_CASE.
  Ejemplo: PORT, FS_WS_URL, LOCAL_CACHE_LOCATION, MAX_CACHE_SIZE_BYTES, etc.

Ejemplos:
  ./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
```

## Unirse a la caché compartida

Como los permisos son gestionados por Shared Cache, unirse es increíblemente fácil y no requiere contraseña. La caché compartida se anuncia usando bonjour. En la mayoría de los casos, los clientes en la misma red la detectan y aparecerá una ventana modal preguntando si desean unirse.

Si no aparece ninguna ventana modal, se puede unir a la caché directamente yendo a Ajustes → Caché compartida → Conectar manualmente y escribiendo la dirección. Un ejemplo de entrada podría verse así `http://192.168.1.45:8003`

## ¿Shared Cache no funciona?

Si Shared Cache no funciona o no ves otros dispositivos en tu red:

1. Abre Ajustes del sistema → Privacidad y seguridad → Red local.
2. Asegúrate de que Shade esté habilitado.
3. Si estaba deshabilitado, actívalo y reinicia Shade antes de intentarlo de nuevo.


---

# 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-es/cache-compartida/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.
