> 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/guia-de-solucion-de-problemas-de-shadefs.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 y reproducción lentos

**Soluciones:**

* **Usar un SSD externo** - Conecte un SSD dedicado (se recomienda Samsung T7) para el almacenamiento de caché en lugar de usar el almacenamiento interno
* **Aumentar el tamaño de la caché** - Los 10 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 para asegurarse de que no haya expulsiones/descargas continuas
* **Comprobar el formato del disco** - Asegúrese de que la unidad de caché esté formateada como APFS (Mac) o NTFS (Windows). No use exFAT

#### 2. Comprobar los requisitos de red

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

**Soluciones:**

* **Verificar la velocidad de internet** - Se recomienda un mínimo de 500 Mbps de descarga para contenido 4K
* **Usar conexión por cable** - Cambie de WiFi a Ethernet al editar recursos no proxy
* **Probar la estabilidad de la conexión** - Asegúrese de que no haya pérdida de paquetes ni caídas intermitentes durante sesiones activas

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

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

**Soluciones:**

* **Habilitar archivos proxy** - Trabaje con proxies en lugar de los archivos originales de alta resolución, especialmente para contenido 4K o superior
* **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 falla o se ralentiza durante el trabajo activo

**Soluciones:**

* **Evitar operaciones simultáneas** - No ancle grandes cantidades de datos mientras accede activamente a archivos a través del montaje
* **Flujos de trabajo separados** - Complete las operaciones de anclaje antes de un uso intensivo del montaje
* **Nota:** Las actualizaciones recientes han corregido errores donde el anclaje podía fallar en intentos de reintento de red

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

**Problema:** Degradación del rendimiento inesperada

**Soluciones:**

* **Comprobar el espacio libre** - Asegúrese de tener espacio disponible suficiente en su unidad de caché
* **Asignación del tamaño adecuado** - Ajuste 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. Exporte “Registros de ShadeFS”
3. Comparta los registros con el 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://academy.shade.inc/shade-academy/shade-academy-es/shadefs/guia-de-solucion-de-problemas-de-shadefs.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.