> 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/shadefs/shadefs-troubleshooting-guide.md).

# Guía de solución de problemas de ShadeFS

### Problemas de rendimiento

#### 1. Optimizar la configuración de la caché

**Problema:** Acceso a archivos lento y rendimiento de reproducción deficiente

**Soluciones:**

* **Usar un SSD externo** - Conecte un SSD dedicado (se recomienda Samsung T7) para el almacenamiento de la caché en lugar de usar el almacenamiento interno
* **Aumentar el tamaño de la caché** - Los 26 GB predeterminados pueden ser insuficientes para proyectos más grandes. Asigne según el tamaño típico de su conjunto de trabajo. Recomendamos tener un tamaño de caché al menos tan grande como el archivo más grande con el que esté trabajando, porque ShadeFS elimina archivos completos cuando libera espacio. Una caché más pequeña significa que ese archivo se sigue eliminando y descargando de nuevo.
* **Comprobar el formato de la unidad** - Asegúrese de que su unidad de caché esté formateada como APFS (macOS), NTFS o ReFS (Windows), o ext4, XFS o Btrfs (Linux). No use exFAT ni Mac OS Extended (HFS+)

#### 2. Comprobar los requisitos de red

**Problema:** Reproducción entrecortada o carga lenta de archivos

**Soluciones:**

* **Verificar la velocidad de Internet** - Se recomienda una velocidad mínima de descarga de 500 Mbps para contenido 4K
* **Usar una conexión por cable** - Cambie de WiFi a Ethernet al editar recursos no proxificados
* **Probar la estabilidad de la conexión** - Asegúrese de que no haya pérdida de paquetes ni desconexiones intermitentes durante las sesiones activas

#### 3. Usar flujos de trabajo con proxies

**Problema:** El contenido de alta resolución rinde mal

**Soluciones:**

* **Habilitar archivos proxy** - Trabaje con proxies en lugar de archivos originales de alta resolución, especialmente para contenido 4K+
* **Ideal para ancho de banda limitado** - Mejora significativamente el rendimiento si la conexión es inferior a 500 Mbps

#### 4. Gestionar el anclaje y el uso del montaje

**Problema:** El anclaje es lento durante el trabajo activo

**Soluciones:**

* **Espere que el anclaje ceda prioridad a la reproducción** - Los archivos que abre a través de la unidad montada siempre se descargan antes que los archivos anclados. Anclar mientras edita no ralentizará la reproducción, pero el anclaje tardará más en finalizar.
* **Anclar con antelación** - Si necesita material sin conexión antes de una fecha límite, comience a anclar cuando no esté reproduciendo contenido activamente para que obtenga toda la conexión

#### 5. Supervisar el espacio de la unidad de caché

**Problema:** Degradación inesperada del rendimiento, o las tareas de guardar y copiar en la unidad montada se detienen

**Soluciones:**

* **Comprobar el espacio libre** - Asegúrese de que haya suficiente espacio disponible en su unidad de caché. Cuando la unidad de caché está casi llena, las escrituras en la unidad montada se pausan hasta que se libera espacio, y es posible que los archivos que no estén en caché no se abran
* **Esté atento a las alertas de espacio** - La aplicación de escritorio le avisa cuando su caché o su unidad de caché están casi llenas. Haga clic en la notificación para abrir **Configuración > ShadeFS > Gestión de caché**
* **Revise sus anclajes** - Los archivos anclados no cuentan para el tamaño de su caché, por lo que anclar carpetas grandes puede llenar el disco incluso cuando el tamaño de su caché parece correcto. Desancle lo que ya no necesite de **Gestión de caché**
* **Ajustar la asignación al tamaño adecuado** - Adapte el tamaño de la caché a las necesidades reales de su conjunto de trabajo

### Obtener ayuda adicional

Si los problemas persisten después de probar estos pasos:

1. Vaya a Configuración en la aplicación ShadeFS
2. Exportar “ShadeFS Logs”
3. Comparta los registros con soporte para su investigación


---

# 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/shadefs/shadefs-troubleshooting-guide.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.