Copias de seguridad y restauración

Instantáneas completas del servidor incluyendo canales, roles, permisos, emojis, stickers, reglas automod, configuración del servidor, mensajes y roles de los miembros. Programe copias de seguridad automáticas y restaure en cualquier servidor.

Visión general

Las copias de seguridad de Restore Hub capturan una instantánea completa de la estructura y el contenido de tu servidor de Discord. A diferencia de las simples exportaciones de listas de canales, Restore Hub realiza copias de seguridad de todo lo necesario para recrear completamente un servidor desde cero, incluidas las sobreescrituras de permisos, las reglas de automodificación y el historial de mensajes (limitado por el plan).

Las copias de seguridad se almacenan de forma segura en la infraestructura de Restore Hub y pueden restaurarse en el mismo servidor o en uno completamente distinto. Esto las hace valiosas para la recuperación ante desastres, la migración de servidores y la creación de plantillas.

Lo que se guarda

Una copia de seguridad de Restore Hub incluye los siguientes datos, capturados a través de la API REST de Discord en el momento de la creación de la copia de seguridad:

• Canales - Todos los tipos de canal: texto, voz, anuncio, foro, escenario y categorías. Incluye el nombre del canal, el tema, la posición, la bandera NSFW, el límite de velocidad (slowmode), el bitrate (voz), el límite de usuarios (voz), la duración predeterminada del autoarchivado, las etiquetas disponibles (foro) y la categoría padre.
• Funciones - Cada rol en el servidor: nombre, color (hexadecimal), campo de bits de permisos, posición en la jerarquía, bandera izable (mostrada por separado), bandera mencionable e icono de rol (si lo hay).
• Los permisos se sobrescriben - Anulaciones de permisos de roles y miembros por canal. Para cada canal, la copia de seguridad almacena qué roles/miembros tienen sobreescrituras de permisos específicas de permitir/denegar.
• Emojis - Todos los emojis personalizados: nombre, bandera animada y URL CDN para la recreación. Al restaurar, los emojis se vuelven a cargar desde la URL CDN.
• Pegatinas - Todas las pegatinas personalizadas: nombre, descripción, tipo de formato (PNG/APNG/Lottie), etiquetas y URL de la imagen.
• Reglas Automod - Todas las reglas AutoMod: tipo de activación, metadatos de activación (listas de palabras clave, patrones regex, preajustes), acciones (bloqueo, alerta, tiempo de espera), roles exentos y canales exentos.
• Configuración del servidor - Nombre del servidor, URL del icono, URL del banner, URL del splash, descripción, nivel de verificación, configuración de notificación por defecto, filtro de contenido explícito, canal AFK, tiempo de espera AFK, canal del sistema y banderas del canal del sistema.
• Mensajes - Mensajes recientes de canales de texto (plan limitado). Cada mensaje almacena: contenido, información del autor (ID, nombre de usuario, avatar), archivos incrustados, URL de los archivos adjuntos, marca de tiempo y marca de tiempo de edición. Los mensajes se capturan en orden cronológico inverso hasta el límite del plan por canal.
• Funciones de los miembros - Una asignación de ID de usuario de Discord a una matriz de ID de rol. Esto registra qué miembros tenían qué roles en el momento de la copia de seguridad, lo que permite la restauración de roles durante una operación de restauración.

Consejo: Las copias de seguridad son instantáneas puntuales. Capturan el estado del servidor en el momento exacto en que se ejecuta la copia de seguridad. Los cambios realizados después de la copia de seguridad no se incluyen.

Crear una copia de seguridad

1. Desde el salpicadero - Vaya a su servidor en el panel de control. Haga clic en "Copias de seguridad" en la barra lateral y, a continuación, en "Crear copia de seguridad". La copia de seguridad se pone en cola y es procesada en segundo plano por el trabajador de copias de seguridad. Verá la actualización del estado en tiempo real.
2. Desde Discord (Premium+) - Utiliza el comando /backup en tu servidor Discord. El bot confirmará que la copia de seguridad se ha puesto en cola y te enviará un mensaje cuando se haya completado.
3. A través de la API - Envíe una solicitud POST a /api/v1/servers/:id/backups. La respuesta incluye el ID de la copia de seguridad y el estado "en cola". Sondee GET /api/v1/servers/:id/backups para comprobar el progreso.

El trabajador de copia de seguridad se ejecuta de forma asíncrona. Para un servidor grande con muchos canales y mensajes, una copia de seguridad puede tardar desde unos segundos hasta varios minutos. El trabajador obtiene todos los datos de la API REST de Discord, respetando los límites de velocidad.

Copias de seguridad programadas (Premium+)

A partir de Premium, puedes programar copias de seguridad automáticas a intervalos regulares. El programador se ejecuta de forma independiente y crea copias de seguridad sin intervención manual.

| Configuración Descripción Por defecto
|---|---|---|
| Intervalo (días) | Frecuencia con la que se crea una copia de seguridad (por ejemplo, cada 1 día, cada 7 días) | 1 día | Máximas copias de seguridad | Número máximo de copias programadas
| Número máximo de copias de seguridad programadas. Las más antiguas se eliminan automáticamente. | 5 |
| Activo | Si la programación se está ejecutando en ese momento | Sí | Sí

Consejo: La eliminación automática sólo afecta a las copias de seguridad programadas. Las copias de seguridad manuales nunca se eliminan automáticamente. Si tiene 5 copias de seguridad programadas y el máximo es 5, la copia de seguridad programada más antigua se elimina cuando se crea una nueva.

Límites del plan

| Plan | Copias de seguridad máximas | Mensajes por canal | Copias de seguridad programadas | Plan | Copias de seguridad máximas | Mensajes por canal | Copias de seguridad programadas
|---|---|---|---|
| Gratis 3 50 No
| Premium 10 200 Sí
| Business 30 500 Sí
| Enterprise 50 2.000 Sí

Atención: El límite de mensajes es por canal, no por copia de seguridad. Una copia de seguridad del plan Free de un servidor con 20 canales de texto captura hasta 50 mensajes de cada canal (1.000 mensajes en total).

Restaurar una copia de seguridad

La restauración reconstruye la estructura de un servidor a partir de una instantánea de la copia de seguridad. Puede restaurar en el mismo servidor (para revertir los cambios) o en un servidor diferente (para clonar o migrar).

1. Seleccione la copia de seguridad - En el panel de control, ve a Copias de seguridad y haz clic en "Restaurar" en la copia de seguridad que quieras restaurar. O utiliza el comando /restore en Discord, o POST a /api/v1/servers/:id/backups/:backupId/restore.
2. Elija un servidor de destino - Por defecto, la copia de seguridad se restaura en el mismo servidor. Opcionalmente, puede especificar un ID de servidor de destino diferente. El bot debe estar en el servidor de destino con los permisos necesarios.
3. Elija qué restaurar - Puede restaurar selectivamente: canales (activado por defecto), roles (activado por defecto), sobrescritura de permisos (activado por defecto), emojis (desactivado por defecto), configuración del servidor (desactivado por defecto) y roles de los miembros (desactivado por defecto).
4. Confirmar y ejecutar - El trabajo de restauración se pone en cola y es procesado por el trabajador de copias de seguridad. Restore Hub crea primero los roles (para establecer la jerarquía), luego los canales con sus permisos de sobreescritura, luego los emojis/pegatinas, luego la configuración del servidor.

Advertencia: La restauración de canales ELIMINA todos los canales existentes en el servidor de destino y los recrea a partir de la copia de seguridad. Esto es destructivo y no puede deshacerse. La restauración de los roles de los miembros sólo funciona para los miembros que están actualmente en el servidor.

Cómo gestiona Restore los identificadores de función

Cuando se crea una copia de seguridad, los ID de rol se capturan tal y como existen en ese momento. Al restaurar en un servidor diferente, esos ID de rol no existen. Restore Hub gestiona esta situación creando nuevos roles con el mismo nombre, color y permisos, y asignando internamente los antiguos ID de rol a los nuevos ID de rol.

Esta asignación de ID de rol se utiliza para: sobrescribir permisos (los permisos de canal hacen referencia a los roles por ID), restaurar roles de miembros (reasignar roles a miembros) y anular permisos a nivel de canal.

Uso de copias de seguridad en distintos servidores

Las copias de seguridad no están bloqueadas en el servidor desde el que se crearon. Puedes restaurar cualquier copia de seguridad en cualquier servidor donde tu bot tenga los permisos necesarios. Casos de uso comunes:

• Plantillas de servidor - Cree una copia de seguridad de un servidor perfectamente configurado y restáurela en los nuevos servidores como punto de partida.
• Migración - Haz una copia de seguridad de tu antiguo servidor, crea uno nuevo y restaura toda la estructura.
• Recuperación en caso de catástrofe - Si tu servidor está en peligro, restaura desde la copia de seguridad más reciente.
• Pruebas - Restaure en un servidor de prueba para experimentar con los cambios sin afectar a su servidor activo.

El trabajador de apoyo

Las copias de seguridad y las restauraciones se ejecutan de forma asíncrona a través de un trabajador en segundo plano (cola de trabajos BullMQ). Cuando se crea una copia de seguridad o una restauración, se añade un trabajo a la cola. El trabajador lo recoge, lo procesa (obteniendo datos de Discord o creando recursos) y actualiza el registro de la copia de seguridad en la base de datos.

El trabajador respeta los límites de velocidad de la API REST de Discord. Para servidores grandes, el trabajador puede tardar varios minutos en completarse. Puedes supervisar el progreso a través del panel de control, que sondea las actualizaciones de estado.