Solucionar la corrupción del archivo de configuración de rclone y problemas de recuperación en RcloneView

6 de abril de 2026 · 6 min de lectura

Senior Engineer

Un archivo de configuración de rclone corrupto puede hacer que todos tus remotos en la nube desaparezcan. Esta guía explica por qué ocurre, cómo recuperarte y cómo evitar que vuelva a suceder.

Tu archivo de configuración de rclone (rclone.conf) almacena cada remoto que has configurado: credenciales de la nube, tokens, claves de cifrado y ajustes de conexión. Si este archivo se corrompe, pierdes el acceso a todos los remotos configurados hasta que los repares o los vuelvas a crear. RcloneView lee y escribe el mismo archivo de configuración que utiliza la CLI de rclone, por lo que la corrupción afecta a ambas herramientas por igual. A continuación se explica cómo diagnosticar y solucionar el problema.

Vista previa de la aplicación RcloneView

Gestiona y sincroniza todas tus nubes en un solo lugar

RcloneView es una GUI multiplataforma para rclone. Compara carpetas, transfiere o sincroniza archivos y automatiza flujos de trabajo multinube con una interfaz visual y limpia.

Trabajos con un clic: Copiar · Sincronizar · Comparar
Programadores e historial para una automatización fiable
Funciona con Google Drive, OneDrive, Dropbox, S3, WebDAV, SFTP y más

WindowsmacOSLinux

Empieza gratis →

Funciones principales gratis. Automatizaciones disponibles con Plus.

Síntomas de corrupción de la configuración

Es posible que tengas un archivo de configuración corrupto si experimentas alguno de los siguientes síntomas:

Los remotos desaparecen de la lista de remotos de RcloneView o rclone listremotes no devuelve nada.
Aparecen errores de análisis al iniciar, como Failed to load config file o invalid character.
La autenticación falla en remotos que antes funcionaban, con errores de token o discrepancias de credenciales.
Entradas de remotos parciales: algunos remotos se cargan pero otros faltan o tienen ajustes incompletos.
Texto ilegible al abrir rclone.conf en un editor de texto: caracteres irreconocibles en lugar de secciones en formato INI.

Check RcloneView job history for config-related errors

Causas comunes

Guardados de configuración interrumpidos

La causa más frecuente es una operación de escritura que se interrumpió antes de completarse. Esto puede ocurrir cuando:

El sistema falla o pierde energía mientras rclone está guardando la actualización de un token.
Fuerzas el cierre de RcloneView o rclone mientras actualiza la configuración.
Una escritura en disco falla por falta de espacio o un error del sistema de archivos.

Errores de disco y del sistema de archivos

Los problemas de almacenamiento subyacente pueden corromper silenciosamente cualquier archivo, incluida tu configuración:

Sectores defectuosos en un disco duro.
Corrupción del sistema de archivos tras un apagado incorrecto.
Latencia del sistema de archivos de red (NFS/SMB) que provoca escrituras parciales.

Problemas con la clave de cifrado

Si tu configuración está cifrada con RCLONE_CONFIG_PASS, surgen problemas cuando:

La variable de entorno de contraseña no está definida o cambia entre sesiones.
La contraseña se almacenó en una entrada del llavero (keychain) que ha sido eliminada o restablecida.
Copiaste la configuración a otra máquina sin transferir también la contraseña.

Errores de edición manual

Abrir rclone.conf en un editor de texto e introducir accidentalmente errores de sintaxis (corchetes faltantes, encabezados de sección INI dañados o líneas eliminadas) corromperá la configuración para el analizador.

Localizar tu archivo de configuración

Antes de la recuperación, localiza tu archivo de configuración:

SO	Ubicación predeterminada
Windows	`%APPDATA%\rclone\rclone.conf`
macOS	`~/.config/rclone/rclone.conf`
Linux	`~/.config/rclone/rclone.conf`

También puedes comprobar la ruta de configuración activa ejecutando rclone config file en una terminal. RcloneView utiliza esta misma ruta de archivo.

Pasos de recuperación

Paso 1: Buscar copias de seguridad

Antes de realizar cualquier cambio, busca copias de seguridad automáticas o manuales:

Algunos sistemas crean archivos .bak en el mismo directorio. Comprueba si existe rclone.conf.bak.
Si utilizas una herramienta de copia de seguridad o sincronización en la nube en tu directorio personal, recupera el archivo desde una instantánea reciente.
Revisa la Papelera de reciclaje o Papelera de tu sistema: algunos editores crean copias temporales.

Paso 2: Validar la estructura del archivo

Abre rclone.conf en un editor de texto plano. Una configuración saludable se ve así:

[my-gdrive]
type = drive
client_id = ...
client_secret = ...
token = {"access_token":"...","token_type":"Bearer",...}

[my-s3]
type = s3
provider = AWS
access_key_id = AKIA...
secret_access_key = ...
region = us-east-1

Busca lo siguiente: encabezados [sección] faltantes, líneas truncadas, caracteres binarios o cadenas de tokens JSON incompletas.

Paso 3: Reparar la corrupción parcial

Si solo una parte del archivo está dañada:

Haz una copia de seguridad del archivo corrupto primero: cópialo como rclone.conf.corrupt.
Elimina la sección dañada: borra por completo la entrada del remoto dañado.
Vuelve a añadir el remoto en RcloneView usando el asistente de Nuevo remoto.

Re-add a cloud remote in RcloneView after config repair

Paso 4: Reconstruir desde cero

Si el archivo es completamente ilegible:

Cambia el nombre del archivo corrupto a rclone.conf.old.
Inicia RcloneView; comenzará con una configuración nueva y vacía.
Vuelve a añadir cada remoto usando el asistente de configuración. Para remotos basados en OAuth (Google Drive, OneDrive, Dropbox), deberás volver a autorizar el acceso.
Para remotos compatibles con S3, necesitarás tus claves de acceso y claves secretas.

RcloneView explorer after rebuilding remotes

Paso 5: Recuperar configuraciones cifradas

Si tu configuración estaba cifrada y tienes la contraseña:

Define RCLONE_CONFIG_PASS en tu entorno.
Ejecuta rclone config show para verificar que el descifrado funciona.
Si se descifra correctamente, la configuración no está corrupta; el problema era una contraseña faltante.

Si has perdido la contraseña de cifrado, la configuración no se puede descifrar. Deberás volver a crear todos los remotos desde cero.

Consejos de prevención

Haz copias de seguridad con regularidad: copia rclone.conf a una ubicación segura después de añadir o cambiar remotos. Un simple cp ~/.config/rclone/rclone.conf ~/.config/rclone/rclone.conf.backup es suficiente.
Almacena las credenciales por separado: guarda las claves de S3, los datos de SFTP y tu RCLONE_CONFIG_PASS en un gestor de contraseñas.
Nunca fuerces el cierre de RcloneView o rclone durante una actualización de token o un guardado de configuración.
Asegura suficiente espacio en disco en la unidad donde se almacena tu configuración.
Usa la interfaz gráfica para gestionar remotos en lugar de editar rclone.conf manualmente.