> 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/byos/connecting-shade-to-backblaze.md).

# Conectar Shade a Backblaze

Shade admite Bring-Your-Own-S3 (BYOS3) con múltiples proveedores como AWS, GCP, MinIO, Wasabi, Backblaze y más. Así es como conectar Shade con su cuenta de Backblaze existente.

### Aprovisionamiento de un nuevo bucket en Backblaze

{% hint style="info" %}
Aunque aprovisionar un nuevo bucket no es estrictamente necesario, recomendamos encarecidamente aprovisionar un nuevo bucket para Shade. Shade no puede usar archivos en buckets existentes debido a la naturaleza de ShadeFS. Shade creará dos nuevas carpetas `blobs` y `chunks` en cualquier bucket que conectes a él.
{% endhint %}

Si aún no tiene una cuenta de Backblaze, puede crear una cuenta [aquí](https://www.backblaze.com/get-started). Para crear un nuevo bucket en Backblaze, inicie sesión en su cuenta, vaya a Buckets y haga clic en “Create Bucket”.

{% hint style="warning" %}
Al nombrar los buckets, evite usar prefijos numéricos, ya que esto puede hacer que las cargas fallen.
{% endhint %}

<figure><img src="https://440362858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FwiyUqp1EMe9kxmzqUY0s%2FScreenshot%202025-07-21%20at%2010.05.57%E2%80%AFPM.png?alt=media&amp;token=a6a9688c-8ea3-48b0-a0c0-5949c2142adc" alt=""><figcaption></figcaption></figure>

Siguiendo los pasos e indicaciones, asegúrate de llevar un registro de tu **nombre del bucket**, y de tu **región del bucket** (ya que estos son importantes y se usarán en un paso posterior). *En este caso, el nombre de nuestro bucket es “shade-new-bucket” y la región (no mostrada) es us-east-005.*

<figure><img src="https://440362858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FrfYsy1OGqFNgpTNZehUj%2FScreenshot%202025-07-21%20at%2010.06.34%E2%80%AFPM.png?alt=media&amp;token=a4e6a64b-f14e-47aa-b22a-69a1ba4ca246" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
ShadeFS no requiere que se configure ninguna otra propiedad específica en el bucket. Puedes optar por replicar datos, registrar eventos o configurar el versionado como prefieras para tu negocio.
{% endhint %}

### Configuración de CORS (opción más fácil, pero no siempre funciona)

Cross-Origin Resource Sharing es una característica importante que permite que los buckets sean accesibles desde otros orígenes (como <https://app.shade.inc>). Esto es fundamental para que Shade acceda y descargue el medio original para usted desde nuestra app. Backblaze facilita compartir este origen. Recomendamos permitir todos los orígenes. Sin embargo, si prefiere un origen más restringido, es necesario incluir en la lista blanca `*.shade.inc` como un origen permitido.

<figure><img src="https://440362858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FK04PmQnY9OPDkeiPt7cg%2FScreenshot%202025-07-21%20at%2010.07.19%E2%80%AFPM.png?alt=media&amp;token=98cdf9fc-04b7-46a0-a2ea-862615faa11f" alt=""><figcaption></figcaption></figure>

### Opción segura para actualizar CORS

B2 parece tener a veces algunos problemas al actualizar CORS directamente desde la interfaz de usuario. Para actualizar con total seguridad su bucket b2, puede usar la [b2 cli](https://www.backblaze.com/docs/cloud-storage-command-line-tools).

#### Crear un cors.json

Primero, cree un `cors.json` archivo con el siguiente contenido.

```json
[

  {

    "corsRuleName": "web-any-origin",

    "allowedOrigins": ["*"],

    "allowedHeaders": ["*"],

    "allowedOperations": [

      "b2_download_file_by_id",

      "b2_download_file_by_name",

      "b2_upload_file",

      "b2_upload_part",

      "s3_get",

      "s3_put",

      "s3_delete",

      "s3_head"

    ],

    "maxAgeSeconds": 3000

  }

]
```

Luego, abra una terminal en su máquina y actualice:

```
b2 bucket update --cors-rules "/path/to/cors.json" your-bucket-name-here allPublic
```

Debería responder con un resultado aquí:

```json
{

    "accountId": "---------",
    "bucketId": "---------",
    "bucketInfo": {},
    "bucketName": "---------",
    "bucketType": "allPublic",
    "corsRules": [
        {
            "allowedHeaders": [
                "*"
            ],
            "allowedOperations": [
                "s3_head",
                "b2_download_file_by_id",
                "b2_upload_part",
                "b2_upload_file",
                "s3_put",
                "b2_download_file_by_name",
                "s3_delete",
                "s3_get"
            ],
            "allowedOrigins": [
                "*"
            ],
            "corsRuleName": "web-any-origin",
            "exposeHeaders": null,
            "maxAgeSeconds": 3000
        }
    ],
    "defaultRetention": {
        "mode": null
    },
    "defaultServerSideEncryption": {
        "mode": "none"
    },
    "isFileLockEnabled": false,
    "lifecycleRules": [],
    "options": [
        "s3"
    ],
    "replication": {
        "asReplicationDestination": null,
        "asReplicationSource": null
    },
    "revision": 5
}
```

### Creación de claves de acceso

Shade accede a los buckets de Backblaze mediante el protocolo S3; esto significa que Shade requiere un nombre de bucket, una región de bucket, una clave de acceso y una clave secreta para acceder a este bucket.

Vaya a Claves de acceso > Crear clave de acceso y aprovisione una clave maestra o una clave de aplicación. Aquí aprovisionamos una clave de aplicación específicamente para nuestro bucket.

<figure><img src="https://440362858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FhkdgNx8GCyRFeqHHgTs2%2FScreenshot%202025-07-21%20at%2010.08.44%E2%80%AFPM.png?alt=media&amp;token=26b59ca3-1bd6-4be4-ab52-14241865fa0c" alt=""><figcaption></figcaption></figure>

**Asegúrese de tener activadas las opciones de lectura y escritura.**

Una vez que cree una nueva clave, copie el ID de la clave creada (clave de acceso para Shade) y applicationKey (clave secreta para Shade) en su portapapeles y guárdelos para los próximos pasos.

<figure><img src="https://440362858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FjCM2LtFyqhnxN6JRrCgW%2FScreenshot%202025-07-21%20at%2010.08.53%E2%80%AFPM.png?alt=media&amp;token=ed030828-3246-4654-a835-eb04e247abeb" alt=""><figcaption></figcaption></figure>

### Creación de una unidad BYOS en Shade

Al llegar a este punto, deberías haber obtenido correctamente los siguientes elementos:

1. Espacio de trabajo de Shade
2. Nombre del bucket
3. Región del bucket
4. KeyID (clave de acceso)
5. applicationKey (clave secreta)

Si aún no tienes un espacio de trabajo, puedes crear uno [aquí](https://app.shade.inc).

Dentro de tu espacio de trabajo de Shade, ahora puedes crear una unidad. Selecciona el botón más junto a “My drives” > BYOS drive.

<figure><img src="https://440362858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FjqzLgveMAH1u4Jue0PBb%2FScreenshot%202025-07-21%20at%209.43.17%E2%80%AFPM.png?alt=media&amp;token=f29ba862-4ea3-454a-9b60-6a14622fa1e5" alt=""><figcaption></figcaption></figure>

#### Selecciona una plantilla

<figure><img src="https://440362858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FPE80uq4lWAvyvhx7ZpEn%2FScreenshot%202025-07-21%20at%209.43.25%E2%80%AFPM.png?alt=media&amp;token=72b36257-7e12-4c7e-95b5-7d8e29632adc" alt=""><figcaption></figcaption></figure>

Nuestras plantillas te ayudan a configurarte rápidamente con Shade, con metadatos y vistas adicionales que te ayudan a organizar tus archivos y recursos. Para obtener más información sobre nuestra IA, puedes consultar nuestra [academia](https://academy.shade.inc/ai-tools/custom-and-automated-metadata). En este caso, hemos seleccionado Producción de video.

#### Creando nuestra unidad de Backblaze

A continuación, decidimos el nombre de nuestra unidad y seleccionamos a nuestro proveedor Backblaze.

<figure><img src="https://440362858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FezRZIfHFnkZVjRuVh25l%2FScreenshot%202025-07-21%20at%2010.10.54%E2%80%AFPM.png?alt=media&amp;token=5be8cf69-5647-4b62-a801-425bf4b2d7b6" alt=""><figcaption></figcaption></figure>

#### Añadiendo nuestras credenciales de Backblaze

A partir de los pasos anteriores, añadimos nuestras credenciales de Backblaze, incluido el nombre de nuestro bucket, la región, la clave de acceso y la clave secreta.

{% hint style="info" %}
Este tiene que ser el nombre del bucket que creó en Backblaze. No es el mismo que el nombre de la unidad que creó en la pantalla anterior.
{% endhint %}

<figure><img src="https://440362858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FIlbsTBemKdmX7GejHN7u%2FScreenshot%202025-07-21%20at%2010.12.23%E2%80%AFPM.png?alt=media&amp;token=080e27e4-5b92-4274-b99e-32a2b91b9825" alt=""><figcaption></figcaption></figure>

### Subiendo tu primer archivo

Una vez que hayas seguido los pasos anteriores, ya podrás subir tu primer archivo a tu unidad de Shade. Si se configuró correctamente, deberías poder subir tu archivo y montar la unidad de Shade en tu ordenador desde la [Aplicación de escritorio de Shade](https://shade.inc/download)

<figure><img src="https://440362858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2F7LzkoI92nHxn2cWLxpdi%2FScreenshot%202025-07-21%20at%2010.20.30%E2%80%AFPM.png?alt=media&amp;token=068a3ab2-bf9a-4773-a5cf-3445643b121c" alt=""><figcaption></figcaption></figure>

### Consejos de solución de problemas

Si tienes más preguntas, no dudes en contactarnos en <support@shade.inc> o unirte a nuestro [Discord](https://discord.gg/h8wqFMJ4vK).

#### No puedo subir, ¿qué está pasando?

Si no puedes subir archivos, revisa la configuración de CORS de tu bucket o tus claves secreta/de acceso y los permisos asociados.


---

# 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/byos/connecting-shade-to-backblaze.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.
