> 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/guides/guides-es/configuracion-y-migracion/migracion-masiva-de-datos-a-shade-mediante-rclone.md).

# Migración masiva de datos a Shade mediante Rclone

Cómo migrar datos a Shade mediante Rclone

### Gestión eficiente de la migración y transferencia de datos

Esta guía explica cómo migrar grandes cantidades de datos hacia o desde tu unidad de Shade con rclone, una potente herramienta de código abierto compatible con muchas fuentes distintas.

### Descargar rclone

El backend de Shade ya está disponible de forma nativa en rclone. Puedes descargar rclone desde la [página oficial de descargas de rclone](https://rclone.org/downloads/).

### Acerca de rclone

[rclone](https://rclone.org/) es un potente programa de línea de comandos para gestionar archivos en servicios de almacenamiento en la nube. A menudo se describe como «rsync para el almacenamiento en la nube» y es compatible con más de 70 proveedores de almacenamiento en la nube.

Entre los usos habituales de rclone se incluyen:

* **Sincronizar y crear copias de seguridad de** archivos entre tu sistema local y el almacenamiento en la nube
* **Migrar datos** de un proveedor de almacenamiento en la nube a otro
* **Automatizar flujos de trabajo** con sincronizaciones y copias de seguridad programadas
* **Gestionar transferencias de archivos grandes** con capacidad para reanudar transferencias y controlar el ancho de banda
* **Operaciones por lotes** para copiar, mover o eliminar archivos entre servicios en la nube

Con el backend de rclone de Shade, puedes aprovechar todas las potentes funciones de rclone para interactuar con tus unidades de Shade directamente desde la línea de comandos.

### Configuración

A continuación, se muestra un ejemplo de cómo configurar Shade.

Primero, [crea una cuenta gratuita](https://app.shade.inc/) y elige un plan.

Tendrás que iniciar sesión y obtener la `API Key` y el `Drive ID` de tu cuenta en la sección de configuración de la cuenta y de la unidad que creaste, respectivamente.

Ahora, abre un símbolo del sistema o una terminal, ve a la ubicación donde descargaste el archivo y ejecuta

`./rclone config`\
\
(Si usas una Mac, tendrás que indicar al equipo que este archivo se puede ejecutar. Para ello, ejecuta

`chmod +x rclone` )

A continuación, sigue este proceso interactivo:

```
e) Editar remoto existente
n) Nuevo remoto
d) Eliminar remoto
r) Cambiar el nombre del remoto
c) Copiar remoto
s) Establecer contraseña de configuración
q) Salir de la configuración
e/n/d/r/c/s/q> n

Introduce un nombre para el nuevo remoto.
name> Shade

Opción Storage.
Tipo de almacenamiento que se va a configurar.
Elige un número de la lista o introduce tu propio valor.
(Desplázate por la lista hasta encontrar la opción Shade. A fecha de 11/5/25, es la 52.)
[OTRAS OPCIONES]
xx / Shade FS
   \ (shade)
[OTRAS OPCIONES]
Almacenamiento> xx

Opción drive_id.
El ID de tu unidad; puedes consultarlo en la configuración de la unidad. Debes crear configuraciones individuales de rclone para cada unidad.
Introduce un valor.
drive_id> [YOUR_ID]

Opción api_key.
Una clave de API para tu cuenta.
Introduce un valor.
api_key> [YOUR_API_KEY]

¿Editar la configuración avanzada?
y) Sí
n) No (predeterminado)
y/n> n

Configuración completada.
Opciones:
- type: shade
- drive_id: [YOUR_ID]
- api_key: [YOUR_API_KEY]
¿Conservar este remoto de «Shade»?
y) Sí, está bien (predeterminado)
e) Editar este remoto
d) Eliminar este remoto
y/e/d> y

```

### Ejemplo de flujo de trabajo: copiar archivos a Shade

Una vez que hayas configurado el remoto de Shade, puedes copiar fácilmente archivos de tu sistema de archivos local a Shade. Este es un flujo de trabajo habitual:

#### Copiar una carpeta local a Shade

Para copiar una carpeta de tu sistema local a tu unidad de Shade:

```bash
./rclone copy /path/to/local/folder Shade:/destination/folder
```

Por ejemplo, para copiar tu carpeta «Projects» a Shade:

```bash
./rclone copy ~/Projects Shade:/Projects
```

Este comando hará lo siguiente:

* Copiar todos los archivos de la carpeta local Projects a Shade
* Conservar la estructura de carpetas
* Omitir los archivos que ya existen y no han cambiado
* Mostrar el progreso durante la transferencia

#### Otros comandos útiles

**Sincronizar una carpeta** (hace que el destino sea idéntico al origen, incluidas las eliminaciones):

```bash
./rclone sync ~/Projects Shade:/Projects
```

**Comprobar qué archivos se copiarían** sin copiarlos realmente:

```bash
./rclone copy ~/Projects Shade:/Projects --dry-run
```

**Copiar con información de progreso y estadísticas**:

```bash
./rclone copy ~/Projects Shade:/Projects --progress --stats 1s
```

**Mostrar una lista de los archivos de tu unidad de Shade**:

```bash
./rclone ls Shade:/
```

### Alternativa: usar el backend S3 de rclone

Si usas rclone con Shade, te recomendamos el [backend nativo de Shade](https://rclone.org/shade/) para disfrutar de la mejor experiencia. También se admite el backend S3 genérico de rclone si ya tienes scripts o flujos de trabajo basados en S3, pero no es la conexión recomendada para rclone.

1. Para saber cómo generar una clave S3 y obtener su ID de clave de acceso y su clave de acceso secreta, consulta [Uso de la API S3 de Shade](https://academy.shade.inc/developers/using-shades-s3-api).
2. Añade un remoto a tu archivo de configuración de rclone (ejecuta `./rclone config file` para encontrarlo):

```
[ShadeS3]
type = s3
provider = Other
access_key_id = YOUR_ACCESS_KEY_ID
secret_access_key = YOUR_SECRET_ACCESS_KEY
endpoint = https://s3.shade.inc
region = us-east-1
no_check_bucket = true
```

3. Usa el ID de tu unidad como nombre del bucket:

```bash
./rclone copy ~/Projects ShadeS3:YOUR_DRIVE_ID/Projects --progress
```

Cada bucket corresponde a una unidad de Shade existente, así que no intentes crear ni eliminar buckets.

### Opciones estándar

Estas son las opciones estándar específicas de shade (Shade FS).

**Nota:** En la mayoría de los casos, solo tienes que configurar `drive_id` y `api_key`. Las opciones avanzadas que aparecen a continuación están destinadas a casos de uso específicos y pueden dejarse con sus valores predeterminados.

#### --shade-drive-id

El ID de tu unidad; puedes consultarlo en la configuración de la unidad. Debes crear configuraciones individuales de rclone para cada unidad.

Propiedades:

* Configuración: drive\_id
* Variable de entorno: RCLONE\_SHADE\_DRIVE\_ID
* Tipo: string
* Obligatorio: sí

#### --shade-api-key

Una clave de API para tu cuenta. Puedes encontrarla en Configuración > Claves de API

Propiedades:

* Configuración: api\_key
* Variable de entorno: RCLONE\_SHADE\_API\_KEY
* Tipo: string
* Obligatorio: sí

### Opciones avanzadas

Estas son las opciones avanzadas específicas de shade (Shade FS).

#### --shade-endpoint

Endpoint del servicio.

Normalmente, déjalo en blanco.

Propiedades:

* Configuración: endpoint
* Variable de entorno: RCLONE\_SHADE\_ENDPOINT
* Tipo: string
* Obligatorio: no

#### --shade-chunk-size

Tamaño de bloque que se usará para subir archivos.

Los archivos que superen este tamaño se subirán en bloques de este tamaño.

Ten en cuenta que este valor se almacena en memoria por transferencia, por lo que aumentarlo incrementará el uso de memoria.

El mínimo es 5 MB y el máximo, 5 GB.

Propiedades:

* Configuración: chunk\_size
* Variable de entorno: RCLONE\_SHADE\_CHUNK\_SIZE
* Tipo: SizeSuffix
* Valor predeterminado: 64Mi

#### --shade-encoding

La codificación del backend.

Consulta la [sección sobre codificación en la descripción general](https://github.com/shade-labs/docs/blob/main/overview/README.md#encoding) para obtener más información.

Propiedades:

* Configuración: encoding
* Variable de entorno: RCLONE\_SHADE\_ENCODING
* Tipo: Encoding
* Valor predeterminado: Slash,BackSlash,Del,Ctl,InvalidUtf8,Dot

#### --shade-description

Descripción del remoto.

Propiedades:

* Configuración: description
* Variable de entorno: RCLONE\_SHADE\_DESCRIPTION
* Tipo: string
* Obligatorio: no

### Rutas de la API utilizadas por la integración de rclone

La integración de rclone utiliza las siguientes rutas para interactuar directamente con el sistema de archivos Shade. Si quieres usar estas rutas directamente en tus propias aplicaciones, primero tendrás que obtener un token de usuario llamando a la ruta adecuada de la sección «Users» en la sección «Using the API» de nuestra documentación. Una vez que tengas el token de usuario, pásalo como token bearer en tus solicitudes en lugar de tu clave de API.

**Nota:** El backend de rclone gestiona la autenticación automáticamente mediante tu clave de API; solo tendrás que preocuparte por los tokens de usuario si estás creando integraciones personalizadas fuera de rclone.

## GET /{drive-id}/fs/listdir

> List directory contents for a given drive path

```json
{"openapi":"3.1.1","info":{"title":"Shade Rclone Routes","version":"0.0.0"},"paths":{"/{drive-id}/fs/listdir":{"get":{"tags":["drives"],"parameters":[{"name":"drive","in":"path","required":true,"schema":{"type":"string"}},{"name":"path","in":"query","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"getByDriveFsListdir","summary":"List directory contents for a given drive path"}}}}
```

## GET /{drive-id}/fs/attr

> Get file or directory attributes/metadata

```json
{"openapi":"3.1.1","info":{"title":"Shade Rclone Routes","version":"0.0.0"},"paths":{"/{drive-id}/fs/attr":{"get":{"tags":["drives"],"parameters":[{"name":"drive","in":"path","required":true,"schema":{"type":"string"}},{"name":"path","in":"query","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"getByDriveFsAttr","summary":"Get file or directory attributes/metadata"}}}}
```

## GET /{drive-id}/fs/download

> Download a file with optional content disposition

```json
{"openapi":"3.1.1","info":{"title":"Shade Rclone Routes","version":"0.0.0"},"paths":{"/{drive-id}/fs/download":{"get":{"tags":["drives"],"parameters":[{"name":"drive","in":"path","required":true,"schema":{"type":"string"}},{"name":"path","in":"query","required":true,"schema":{"type":"string"}},{"name":"disposition_type","in":"query","required":true,"schema":{"default":"attachment","type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"getByDriveFsDownload","summary":"Download a file with optional content disposition"}}}}
```

## POST /{drive-id}/fs/mkdir

> Create a directory at the specified path

```json
{"openapi":"3.1.1","info":{"title":"Shade Rclone Routes","version":"0.0.0"},"paths":{"/{drive-id}/fs/mkdir":{"post":{"tags":["drives"],"parameters":[{"name":"drive","in":"path","required":true,"schema":{"type":"string"}},{"name":"path","in":"query","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"postByDriveFsMkdir","summary":"Create a directory at the specified path"}}}}
```

## POST /{drive-id}/fs/mkdir/batch

> Create multiple directories in a single request

```json
{"openapi":"3.1.1","info":{"title":"Shade Rclone Routes","version":"0.0.0"},"paths":{"/{drive-id}/fs/mkdir/batch":{"post":{"tags":["drives"],"parameters":[{"name":"drive","in":"path","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{},"required":true},"operationId":"postByDriveFsMkdirBatch","summary":"Create multiple directories in a single request"}}}}
```

## POST /{drive-id}/fs/copy-file

> Copy a file from one path to another

```json
{"openapi":"3.1.1","info":{"title":"Shade Rclone Routes","version":"0.0.0"},"paths":{"/{drive-id}/fs/copy-file":{"post":{"tags":["drives"],"parameters":[{"name":"drive","in":"path","required":true,"schema":{"type":"string"}},{"name":"from","in":"query","required":true,"schema":{"type":"string"}},{"name":"to","in":"query","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"postByDriveFsCopy-file","summary":"Copy a file from one path to another"}}}}
```

## POST /{drive-id}/fs/move

> Move or rename a file or directory

```json
{"openapi":"3.1.1","info":{"title":"Shade Rclone Routes","version":"0.0.0"},"paths":{"/{drive-id}/fs/move":{"post":{"tags":["drives"],"parameters":[{"name":"drive","in":"path","required":true,"schema":{"type":"string"}},{"name":"from","in":"query","required":true,"schema":{"type":"string"}},{"name":"to","in":"query","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"postByDriveFsMove","summary":"Move or rename a file or directory"}}}}
```

## POST /{drive-id}/fs/delete

> Delete a file or directory at the specified path

```json
{"openapi":"3.1.1","info":{"title":"Shade Rclone Routes","version":"0.0.0"},"paths":{"/{drive-id}/fs/delete":{"post":{"tags":["drives"],"parameters":[{"name":"drive","in":"path","required":true,"schema":{"type":"string"}},{"name":"path","in":"query","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"postByDriveFsDelete","summary":"Delete a file or directory at the specified path"}}}}
```

## GET /{drive-id}/info/storage

> Fetch overall storage usage and limits

```json
{"openapi":"3.1.1","info":{"title":"Shade Rclone Routes","version":"0.0.0"},"paths":{"/{drive-id}/info/storage":{"get":{"tags":["drives"],"parameters":[{"name":"drive","in":"path","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"getByDriveInfoStorage","summary":"Fetch overall storage usage and limits"}}}}
```

## GET /{drive-id}/info/upload

> Fetch upload configuration and constraints

```json
{"openapi":"3.1.1","info":{"title":"Shade Rclone Routes","version":"0.0.0"},"paths":{"/{drive-id}/info/upload":{"get":{"tags":["drives"],"parameters":[{"name":"drive","in":"path","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"getByDriveInfoUpload","summary":"Fetch upload configuration and constraints"}}}}
```

## POST /{drive-id}/upload/multipart/part/{partNumber}

> Upload a specific part of a multipart upload

```json
{"openapi":"3.1.1","info":{"title":"Shade Rclone Routes","version":"0.0.0"},"paths":{"/{drive-id}/upload/multipart/part/{partNumber}":{"post":{"tags":["drives"],"parameters":[{"name":"drive","in":"path","required":true,"schema":{"type":"string"}},{"name":"partNumber","in":"path","required":true,"schema":{"type":"number"}},{"name":"token","in":"query","required":true,"schema":{"type":"string"}},{"name":"signAllEndpoints","in":"query","required":false,"schema":{"type":"string"}}],"operationId":"postByDriveUploadMultipartPartByPartNumber","summary":"Upload a specific part of a multipart upload"}}}}
```

## POST /{drive-id}/upload/multipart

> Initiate a multipart upload session

```json
{"openapi":"3.1.1","info":{"title":"Shade Rclone Routes","version":"0.0.0"},"paths":{"/{drive-id}/upload/multipart":{"post":{"tags":["drives"],"parameters":[{"name":"drive","in":"path","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{},"required":true},"operationId":"postByDriveUploadMultipart","summary":"Initiate a multipart upload session"}}}}
```

## POST /{drive-id}/upload/multipart/complete

> Complete a multipart upload by finalizing parts

```json
{"openapi":"3.1.1","info":{"title":"Shade Rclone Routes","version":"0.0.0"},"paths":{"/{drive-id}/upload/multipart/complete":{"post":{"tags":["drives"],"parameters":[{"name":"drive","in":"path","required":true,"schema":{"type":"string"}},{"name":"token","in":"query","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{},"required":true},"operationId":"postByDriveUploadMultipartComplete","summary":"Complete a multipart upload by finalizing parts"}}}}
```


---

# 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/guides/guides-es/configuracion-y-migracion/migracion-masiva-de-datos-a-shade-mediante-rclone.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.
