File Manager — Guía del usuario | YoBench

Para qué sirve el módulo «File Manager»

File Manager es un explorador único para archivos en tu ordenador y en almacenamiento en la nube. En lugar de hacer malabares con Finder/Explorer, un cliente FTP, una consola de S3 y WinSCP, obtienes una sola ventana donde puedes abrir hasta cuatro carpetas en paralelo, arrastrar archivos entre ellas y vigilar las copias largas mediante la cola de transferencias.

Lo que obtienes:

• Cuatro tipos de conexión — disco local, FTP, SFTP y almacenamiento compatible con S3 (Amazon S3, MinIO, Yandex Cloud, Backblaze B2, Cloudflare R2 y otros).
• Hasta cuatro carpetas en paralelo — un explorador de dos, tres o cuatro paneles con navegación, ordenación y filtros independientes por columna.
• Cola de transferencias — las copias y los movimientos son visibles en un panel aparte con progreso por archivo y por bytes, con pausa, reanudación y cancelación.
• Subidas reanudables — los archivos grandes en S3 se dividen en partes de 8 MB; si se cae la conexión, la transferencia continúa desde la última parte completada.
• Resolución de conflictos — cuando los nombres chocan puedes saltar, sobrescribir o auto-renombrar, con la opción «aplicar a todos».
• Inspector — vista previa para imágenes, texto, PDFs, vídeo y audio, además de las propiedades del archivo y el hash SHA256 bajo demanda.
• Archivos ZIP — crea y extrae directamente desde el explorador.
• Restauración de sesión — las carpetas y los paneles abiertos vuelven al reiniciar la app.
• Credenciales cifradas — las contraseñas FTP, las claves SSH y las claves de acceso a la nube se guardan cifradas.

Conexiones soportadas y sus parámetros

Local

• Folder — ruta a la carpeta. El botón Choose abre el selector del sistema.

FTP

• Host — dirección del servidor.
• Port — por defecto 21.
• Username y Password.
• Root path — se usa como «raíz» de la conexión, por defecto /.
• Use TLS — casilla para FTPS, desactivada por defecto.
• La conexión funciona en modo pasivo.

SFTP

• Host y Port (por defecto 22).
• Username.
• Password — para autenticación con contraseña (opcional).
• Private Key — el texto de la clave privada SSH (-----BEGIN OPENSSH PRIVATE KEY-----…). Opcional.
• Passphrase — si la clave está protegida con una passphrase.
• Host Fingerprint — huella del servidor en formato SHA256:… para validación trust-on-first-use. Opcional.
• Root path — por defecto /.

Puedes usar contraseña, clave o ambas a la vez.

Almacenamiento compatible con S3

• S3 Endpoint — URL del proveedor. Déjalo vacío para AWS S3. Ejemplos: https://storage.yandexcloud.net, https://s3.us-west-002.backblazeb2.com, https://<account>.r2.cloudflarestorage.com, http://localhost:9000 para MinIO.
• S3 Region — por defecto us-east-1.
• S3 Bucket — obligatorio.
• S3 Prefix — prefijo opcional dentro del bucket, se usa como «raíz» de la conexión.
• S3 Access Key y S3 Secret Key.
• Force Path Style — casilla para proveedores que requieren URLs path-style en lugar de virtual-hosted (como MinIO). Desactivada por defecto.

Para archivos grandes, la subida multipart se activa automáticamente con un tamaño de parte de 8 MB.

Cómo está organizada la ventana

File Manager tiene hasta cuatro columnas simultáneas. Cada columna muestra:

• Barra de direcciones — la ruta actual; haz clic para editar (o pulsa Cmd/Ctrl+L).
• Lista de archivos — ordenable por nombre, tamaño, fecha de modificación o tipo.
• Buscador / filtro — filtra la lista por subcadena.
• Toggle de archivos ocultos — muestra u oculta los dotfiles.

Las columnas se pueden añadir y quitar. Cuando hay menos de cuatro abiertas, aparece a la derecha un botón + Add column. Cambia entre columnas con Tab / Shift+Tab o salta directamente con Cmd/Ctrl+1..4.

A la derecha puedes abrir el inspector — un panel lateral con tres pestañas:

• Preview — vista previa del archivo seleccionado. Soporta imágenes, texto (hasta 100 000 caracteres), PDFs, vídeo y audio. Para archivos comprimidos y binarios solo se muestran los metadatos.
• Properties — tamaño, fecha de modificación, ruta completa.
• Hash — SHA256 calculado bajo demanda.

El ancho del inspector se ajusta con el ratón (entre 280 y 720 píxeles).

Cola de transferencias

Todas las operaciones largas (copia, movimiento, subida, descarga) aterrizan en el panel de transferencias en la parte inferior de la ventana. Lo puedes ocultar y volver a mostrar.

Cada tarea muestra:

• Tipo de operación (copia, movimiento, subida).
• Progreso — archivos completados sobre el total.
• Estado — en ejecución, pausada, completada, cancelada o fallida.
• Progreso por bytes.

Acciones disponibles:

• Pause (‖) — pausa una tarea en ejecución.
• Resume (▶) — continúa una tarea pausada o fallida.
• Cancel (×) — cancela una tarea en cualquier estado.
• Clear finished — elimina las tareas completadas de la lista.

Si ya existe un archivo con el mismo nombre en el destino, se abre el diálogo de resolución de conflictos:

• Skip — salta este archivo.
• Overwrite — reemplaza el existente.
• Rename — añade (1), (2), etc.
• Apply to all remaining conflicts — aplica tu elección a los conflictos restantes de esta tarea.
• Cancel job — cancela toda la operación.

Archivos comprimidos

El menú contextual de un archivo o carpeta tiene los elementos Create archive y Extract archive:

• Formato soportado: ZIP.
• Los archivos comprimidos se pueden construir desde archivos seleccionados en cualquier columna (por ejemplo, empaquetar una carpeta local y subir el ZIP directamente a S3).
• Se pueden extraer en cualquier carpeta de cualquier conexión.
• Protección contra zip-bombs: la extracción está limitada a 10 GB de datos descomprimidos.

Restauración de sesión

Tras reiniciar la app se restaura lo siguiente:

• Qué columnas estaban abiertas y sus anchos.
• La conexión y la carpeta actual de cada columna.
• Ordenación, filtro y el toggle de archivos ocultos.
• La columna activa y el ancho del inspector.

La conexión en sí se guarda aparte y nunca se pierde. La sesión se guarda automáticamente con un debounce de 0,5 segundos tras los cambios.

Actualización en vivo de carpetas

Para las carpetas locales File Manager observa el sistema de archivos y refresca la lista por su cuenta — añade o elimina un archivo en Finder/Explorer y la columna se actualiza al instante. Para las conexiones remotas (FTP, SFTP, S3) el refresco automático no está disponible — pulsa Cmd/Ctrl+R o el botón Refresh para releer la carpeta.

Seguridad

• Las contraseñas FTP, las claves SSH, las passphrases y las credenciales S3 se guardan cifradas en la base de datos local de la app.
• El renderer (proceso de UI) nunca ve los secretos en bruto — solo flags «password set» / «key set».
• El botón Show password está limitado a cinco revelaciones por hora y por proceso.
• Para SFTP puedes fijar la huella del servidor (SHA256:…); la próxima vez que conectes, la app la verificará — protegiéndote contra suplantaciones del servidor en la red.

Atajos de teclado

Ajustes

Los ajustes de File Manager tienen cuatro secciones:

• Sources — CRUD completo de las conexiones guardadas, con botones Test, ocultar y eliminar.
• Behaviour — valores por defecto: si mostrar archivos ocultos, comportamiento de drag-and-drop, etc.
• Hotkeys — tabla de referencia de atajos de teclado.
• About — información del módulo.

Flujo de uso

1. Conecta a una carpeta local

1. Abre File Manager en la barra lateral.
2. Settings → Sources → New source.
3. Tipo — Local.
4. Nombre (por ejemplo, «Documentos») y la ruta.
5. Guarda.
6. En el explorador, pulsa + Add column y elige la nueva conexión.

2. Conecta a S3

1. Settings → Sources → New source → tipo S3.
2. Rellena Endpoint (o déjalo vacío para AWS), Region, Bucket, Access Key, Secret Key.
3. Si tu proveedor necesita URLs path-style (como MinIO), activa Force Path Style.
4. Test — la conexión debería listar objetos correctamente.
5. Guarda.

3. Copia archivos entre proveedores

1. Abre dos columnas — una con la carpeta local, la otra con S3 (o FTP).
2. Selecciona archivos en la columna de origen (Cmd/Ctrl+A, Shift+click, Cmd/Ctrl+click).
3. Arrastra la selección a la columna de destino — o pulsa F5 (copiar) / F6 (mover).
4. La transferencia aparece en el panel de transferencias inferior. Si los archivos ya existen, se abre el diálogo de conflictos.
5. Cierra la ventana o sigue trabajando — la transferencia corre en segundo plano. Puedes pausarla y reanudarla más tarde, incluso entre reinicios de la app.

4. Extrae un archivo de la nube en tu ordenador

1. Abre dos columnas: S3 (o FTP) y una carpeta local.
2. Localiza el archivo ZIP en la columna remota.
3. Clic derecho sobre el archivo → Extract archive.
4. Elige la carpeta destino — incluso directamente en la columna local.
5. La extracción corre en segundo plano como cualquier otra transferencia — con progreso y soporte de pausa.

Siguientes pasos

• DB Manager — programa backups de bases de datos directamente a S3 o a un servidor FTP.
• Scenarios — automatiza movimientos recurrentes de archivos y reutiliza las mismas conexiones.
• Settings — configura una contraseña maestra para proteger todas las conexiones guardadas.

Ayuda y comentarios

¿Algo no funciona o falta alguna función? Escríbenos a través del formulario de contacto.