> 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/introduction-to-shadefs.md).

# Introducción a ShadeFS

## **Descripción general**

ShadeFS es una solución para montar unidades en la nube que cambia por completo la forma en que interactúas con archivos multimedia almacenados en la nube. A diferencia de las soluciones de almacenamiento en la nube tradicionales que requieren la descarga completa de los archivos antes de poder acceder a ellos (ejem, Dropbox), ShadeFS transmite en tiempo real los segmentos que necesitas, de forma similar a cómo YouTube entrega contenido de video. Este enfoque te brinda acceso inmediato a tus medios mientras optimiza el uso del ancho de banda.

## **Características clave**

* ShadeFS convierte tu unidad en la nube en una carpeta local accesible de forma predeterminada a través de la carpeta “/Volumes”
* Cuando montas una unidad, aparece en tu sistema de archivos local igual que un disco duro físico, pero con la ventaja adicional de la transmisión y el almacenamiento en caché inteligentes
* El sistema sincroniza automáticamente los árboles de archivos entre todos los usuarios, asegurando que todos en tu equipo trabajen con la misma estructura de contenido sin importar dónde se encuentren.
* Los archivos subidos se canalizan automáticamente a través de nuestros flujos de generación de proxies y análisis con IA

## **Requisitos del sistema**

ShadeFS tiene algunos requisitos para funcionar de forma óptima en tu equipo.

* Para trabajar con contenido de video 4K, recomendamos una velocidad mínima de descarga de internet de 500 Mbps
* Los usuarios con menor ancho de banda deberían considerar trabajar con archivos proxy o contenido con resolución inferior a 4K
* Tu dispositivo también debe tener suficiente espacio de almacenamiento para la caché, con un mínimo de 10 GB para las operaciones básicas

## **Primeros pasos**

Una vez que hayas descargado y abierto la aplicación de escritorio, puedes montar cualquier unidad navegando hasta ella en el panel izquierdo, haciendo clic en el menú "..." y seleccionando "Montar unidad". La unidad aparecerá en tu explorador de archivos local, tanto si usas Windows, macOS o Linux.

{% embed url="<https://youtu.be/Cl3A47wWuxY?si=BR8w6EY8fmBrkYZN>" %}

## **Ubicación de montaje**

De forma predeterminada, cada unidad se monta en la ubicación estándar de tu sistema operativo. Los propietarios del espacio de trabajo y los administradores pueden establecer una ubicación de montaje personalizada por unidad en la configuración de la unidad, en **General > Ruta de montaje personalizada**, usando los **campo de ruta de macOS**, **campo de ruta de Linux**, y **campo de ruta de Windows** campos. En Windows, puedes montar una unidad en una letra de unidad como `X:` o `Z:` (no se permiten las unidades del sistema C:, D: y E:). Deja un campo vacío para usar el valor predeterminado del sistema.

## **Backend de montaje (macOS)**

En macOS, ShadeFS monta las unidades a través de un servidor de archivos integrado en la aplicación de escritorio Shade, así que no necesitas instalar nada adicional. El servidor se ejecuta solo en tu Mac y las unidades montadas aparecen en `/Volumes` como cualquier otra unidad. Si prefieres macFUSE, instálalo y activa **Usar backend de macFUSE** en **Configuración > ShadeFS > Configuración**. Solo se puede montar una unidad a la vez con el backend de macFUSE, y ShadeFS se reinicia cuando activas o desactivas esta configuración.

## **Configuración de caché**

ShadeFS usa un sistema de caché para optimizar el rendimiento de tus archivos multimedia. De forma predeterminada, el sistema crea una caché de 26 GB en la **.shade** carpeta ubicada en el directorio raíz de tu usuario. Sin embargo, puedes personalizar tanto la ubicación como el tamaño de la caché en **Configuración > ShadeFS > Administración de caché** para adaptarlo mejor a tus necesidades.

[Administración de la caché de ShadeFS](https://academy.shade.inc/shadefs/managing-the-shadefs-cache)

## **Directorio de caché**

Para modificar tu directorio de caché, abre **Configuración > ShadeFS > Administración de caché** en la aplicación de escritorio y haz clic en el **directorio de caché de ShadeFS** campo (en la versión 2.3.21 y anteriores de la aplicación de escritorio, esta configuración está en **Configuración > ShadeFS > Configuración**). Aquí puedes seleccionar cualquier carpeta de tu computadora o una unidad externa como ubicación de la caché. Recomendamos especialmente usar un SSD externo de alta velocidad, como un Samsung T7, para un rendimiento óptimo.

La ubicación de la caché debe estar en una unidad formateada como APFS (macOS), NTFS o ReFS (Windows), o ext4, XFS o Btrfs (Linux). Las unidades formateadas como exFAT o Mac OS Extended (HFS+) no se pueden usar para la caché.

## **Pautas de uso de ShadeFS**

## **Permisos**

El acceso y las capacidades de montaje de ShadeFS están restringidos a contratistas, miembros y administradores del espacio de trabajo. Cuando varios usuarios montan la misma unidad, todos ven un árbol de archivos idéntico, lo que facilita una colaboración fluida entre equipos remotos.

## **Subidas**

Para cargas de gran escala que superen los 1000 activos o 100 GB, recomendamos usar la aplicación web o la aplicación de escritorio en lugar de subirlos a través de la unidad montada. Hemos optimizado la subida a través de la interfaz de la aplicación para archivos grandes. Cualquier método de carga que elijas hará que el contenido sea visible automáticamente tanto en la aplicación web como en la de escritorio, activando nuestros sistemas automáticos de generación de proxies y procesamiento de IA.

Los archivos pueden moverse entre unidades montando primero varias unidades y luego trasladando los archivos entre ellas mediante el explorador de archivos de tu computadora

## **Acceso sin conexión**

ShadeFS ofrece capacidades de acceso sin conexión mediante **fijación**. Para acceder a archivos o carpetas específicos con una conexión a internet débil (o sin ella), simplemente haz clic derecho sobre los archivos/carpetas en la app y selecciona "Fijar en la caché." Esta acción descarga una copia completa del contenido seleccionado a tu caché local, dejándolos totalmente accesibles incluso si estás desconectado. Puedes ver los archivos que has fijado en la **Elementos fijados** página.

Ver más en [Fijar archivos sin conexión](https://academy.shade.inc/shadefs/pinning-files-offline).

## **Optimización del rendimiento**

Hay varias formas de maximizar el rendimiento de ShadeFS.

* Usa un SSD externo para el almacenamiento de la caché para mejorar significativamente las velocidades de acceso y la respuesta general del sistema
* Recomendamos configurar el tamaño de la caché en función de tu conjunto de trabajo habitual para garantizar que los archivos a los que accedes con frecuencia permanezcan disponibles
* Aunque ShadeFS está diseñado para funcionar eficientemente con el ancho de banda disponible, intenta mantener una conexión a internet estable mientras uses el montaje
* Para los usuarios que trabajan con contenido de alta resolución con ancho de banda limitado, recomendamos crear archivos proxy

## **Integración con el ecosistema Shade**

A diferencia de otras herramientas de transmisión de archivos, ShadeFS está profundamente integrado con la aplicación web y la aplicación de escritorio. Cuando subes archivos a través de una unidad montada, se indexan automáticamente en el sistema Shade y son visibles de inmediato en las aplicaciones web y de escritorio.


---

# 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/introduction-to-shadefs.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.
