Capítulo 6: Sistemas de archivos virtuales y red¶

La gestión de archivos moderna rara vez se detiene en el límite de un único disco duro físico. Los desarrolladores de software mantienen entornos de preparación remotos a través de SFTP; los administradores de sistemas gestionan los archivos compartidos empresariales a través de SMB/CIFS; los creadores de contenido acceden al almacenamiento en la nube y a los servidores multimedia a través de WebDAV; y los usuarios avanzados inspeccionan, editan y empaquetan rutinariamente archivos comprimidos a escala de gigabytes.

Los entornos de escritorio tradicionales obligan a los usuarios a hacer malabarismos con aplicaciones inconexas: una utilidad de archivo independiente para descomprimir y volver a comprimir archivos zip, un cliente FTP/SFTP externo para administrar los activos del servidor y cuadros de diálogo de montaje del sistema operativo que distribuyen volúmenes remotos en ventanas desconectadas del Finder.

ATBCmder elimina esta fragmentación a través de su motor Virtual File System (VFS). Construido sobre una capa de abstracción URI vfs:// unificada, ATBCmder trata los servidores remotos y los archivos comprimidos exactamente como carpetas locales estándar. Puede navegar a un archivo .tar.gz, obtener una vista previa de los archivos de código con F3, editar un archivo de configuración anidado con F4 (con reempaquetado automático en vivo al guardar) y copiar activos directamente a través de una sesión SFTP segura a un NAS SMB local usando la clave estándar F5, todo sin extraer archivos intermedios a disco o cambiar entre herramientas separadas.

1. Inicio rápido visual: arquitectura VFS y matriz de comandos¶

ATBCmder enruta todo el acceso al sistema de archivos a través de una capa de abstracción unificada. Ya sea que una ruta apunte a una partición SSD APFS de Apple, un miembro dentro de un archivo anidado .zip o un directorio remoto alojado en un servidor SFTP de Linux al otro lado del mundo, la interfaz de panel dual proporciona un modelo operativo idéntico.

┌────────────────────────────────────────────────────────────────────────────────────────┐
│                              ATBCMDER DUAL-PANEL GUI                                   │
│            Left Panel (Active)                  Right Panel (Inactive / Target)        │
├────────────────────────────────────────────────────────────────────────────────────────┤
│                                          │                                             │
│  [1] Local File System                   │  [2] Archive Virtual File System (VFS)      │
│      file:///Users/brain/projects/       │      vfs:///Users/brain/backup.tar.gz/src/  │
│      Direct POSIX / APFS access          │      In-place browse, F3 view, F4 live edit │
│                                          │                                             │
│  [3] Remote Network VFS (SFTP/SSH)       │  [4] Remote Storage VFS (SMB / WebDAV)      │
│      vfs://sftp://deploy@aws.prod/app/   │      vfs://smb://admin@truenas/Pool/Media/  │
│      Paramiko / SSH Keys / Keychain      │      Kernel mount_smbfs / WebDAVClient3     │
│                                          │                                             │
├────────────────────────────────────────────────────────────────────────────────────────┤
│                          UNIFIED VFS DISPATCH ENGINE (vfs://)                          │
│     FileSystemModel ➔ VFSManager ➔ SessionCache ➔ StreamCopyWorker / RepackWorker      │
└────────────────────────────────────────────────────────────────────────────────────────┘

Hoja de trucos de red y VFS de matriz dual¶

2. La abstracción de URI unificada vfs://¶

Los administradores de archivos tradicionales tratan a los servidores y archivos remotos como ciudadanos de segunda clase, que requieren utilidades de montaje externas, carpetas de extracción temporales o clientes de transferencia de terceros. ATBCmder unifica cada origen de archivo bajo una única especificación de URI bien definida:

vfs://[protocol]://[user]@[host]:[port]/[remote_path]

2.1 Anatomía de los caminos virtuales¶

Dependiendo del dominio operativo, los vfs:// URI toman una de dos formas estándar:

1. Archivar rutas virtuales:

   vfs:///Users/brain/Documents/release_v1.7.zip/src/main.py
   

2. Prefijo externo: vfs:// indica a FileSystemModel que intercepte el recorrido de la ruta.

3. Ruta del contenedor: /Users/brain/Documents/release_v1.7.zip identifica el archivo del contenedor físico en el almacenamiento local.

4. Miembro interno: src/main.py señala el recurso virtual anidado dentro del archivo.

5. Rutas del servidor de red:

   vfs://sftp://developer@staging.internal.net:2222/var/www/html/index.php
   vfs://smb://admin@192.168.1.50/StoragePool/Backups/2026/
   vfs://webdavs://user@cloud.mycompany.com:443/remote.php/dav/files/user/
   

6. Especificador de esquema: Identifica al conductor del transporte (sftp, ftp, ftps, smb, webdav, webdavs, gdrive, dropbox).

7. Autenticación: Codifica las credenciales del usuario y el puerto de destino.
8. Destino remoto: resuelve directorios absolutos y rutas de archivos en el host remoto.

┌────────────────────────────────────────────────────────────────────────────────────────┐
│                              VFS URI ROUTING IN ACTION                                 │
├────────────────────────────────────────────────────────────────────────────────────────┤
│                                                                                        │
│   Input URI: vfs://sftp://deploy@aws.infra:22/var/log/nginx/access.log                 │
│                 │      │        │        │   └────────────────────► Remote Path        │
│                 │      │        │        └────────────────────────► Port (Default 22)  │
│                 │      │        └─────────────────────────────────► Host / Server      │
│                 │      └──────────────────────────────────────────► Username           │
│                 └─────────────────────────────────────────────────► Protocol Scheme    │
│                                                                                        │
│   Input URI: vfs:///Volumes/Data/Archive.zip/docs/manual.pdf                           │
│                 │                      │        └─────────────────► Archive Member     │
│                 │                      └──────────────────────────► Physical Archive   │
│                 └─────────────────────────────────────────────────► Virtual Scheme     │
└────────────────────────────────────────────────────────────────────────────────────────┘

2.2 Integración perfecta de panel dual¶

Debido a que las rutas virtuales se ajustan a las estructuras de directorios estándar dentro de ATBCmder, usted disfruta de una paridad total de panel dual:

• Espacios de trabajo virtuales con pestañas: abra una carpeta SFTP remota en la pestaña 1, un archivo ZIP local cifrado en la pestaña 2 y su carpeta local ~/Downloads en la pestaña 3.
• Copia direccional (F5): seleccione archivos en su panel activo local y presione F5 para cargarlos directamente en el servidor remoto o en el archivo comprimido que se muestra en el panel inactivo.
• Interoperabilidad de arrastrar y soltar: arrastre elementos a través de paneles entre discos locales, recursos compartidos de red y jerarquías de archivos sin preparación intermedia.
• Barra de ruta de navegación interactiva: la barra de ruta de navegación analiza los URI virtuales en segmentos en los que se puede hacer clic. Haga clic en cualquier carpeta principal o en la insignia del servidor raíz para saltar al árbol al instante.

3. Archivar VFS: navegación e inspección in situ¶

Abrir un archivo en ATBCmder no requiere extracción manual ni herramienta de descompresión de terceros. Simplemente resalte cualquier archivo admitido y presione Enter (o haga doble clic). ATBCmder monta el archivo in situ, transformando el panel en un navegador de directorio virtual de alta velocidad.

Figura 6.1: Navegando dentro de un archivo comprimido multianidado como una carpeta virtual, mostrando tamaños, marcas de tiempo y subdirectorios sin comprimir.

3.1 Formatos de archivo admitidos¶

ATBCmder cuenta con controladores integrados para todos los formatos de compresión y archivo estándar de la industria:

3.2 Flujos de trabajo de navegación local¶

Al navegar dentro de un archivo:

1. Ingrese subdirectorios: presione Enter en cualquier carpeta dentro del archivo para explorar árboles anidados.
2. Ascender a Padre (..): Presione Backspace (⌫) o haga doble clic en la entrada .. [Parent Directory] para ascender. Una vez que llegue a la raíz del archivo, al presionar Backspace regresará limpiamente al directorio físico que contiene el archivo.
3. Vista previa instantánea (F3 / Fn+F3): resalte cualquier documento, imagen o archivo fuente dentro del archivo y presione F3. ATBCmder extrae automáticamente el archivo de destino a un entorno limitado temporal seguro y lo procesa dentro de Universal Lister.
4. Copia selectiva (F5 / Fn+F5): en lugar de descomprimir un archivo completo de varios gigabytes solo para recuperar uno o dos archivos, seleccione los miembros específicos que necesita y presione F5. ATBCmder descomprime solo los elementos elegidos directamente en el panel inactivo.

4. Reempaquetado en vivo: edición in situ dentro de archivos¶

Uno de los flujos de trabajo más potentes de ATBCmder es Live Repacking. Históricamente, modificar un único archivo anidado dentro de un archivo comprimido requería una tediosa secuencia de seis pasos: extraer el archivo completo, localizar el archivo de destino, editarlo y guardarlo, volver a comprimir el directorio en un nuevo archivo, eliminar el archivo original y limpiar las carpetas temporales.

ATBCmder hace que editar archivos dentro de archivos sea tan sencillo como editar archivos locales estándar.

┌────────────────────────────────────────────────────────────────────────────────────────┐
│                              LIVE REPACKING LIFECYCLE                                  │
├────────────────────────────────────────────────────────────────────────────────────────┤
│                                                                                        │
│  1. User presses F4 on "config.json" inside "package.zip"                              │
│     │                                                                                  │
│     ├──► ATBCmder extracts "config.json" to sandbox: /tmp/dc_repack_xyz/config.json    │
│     └──► Opens internal EditorDialog with window title: "config.json — Editor"         │
│                                                                                        │
│  2. User modifies file and presses Cmd+S (Save)                                        │
│     │                                                                                  │
│     ├──► Editor emits file_saved signal                                                │
│     └──► RepackWorker checks original archive size vs ArchiveRepackWarningMB threshold │
│                                                                                        │
│  3. Atomic Repack Execution                                                            │
│     │                                                                                  │
│     ├──► Writes modified stream to staging archive: /tmp/package.zip.tmp               │
│     ├──► Validates container integrity via archive driver                              │
│     ├──► Atomic swap: os.replace("/tmp/package.zip.tmp", "/original/package.zip")      │
│     └──► Refreshes active file panel and cleans up sandbox /tmp/dc_repack_xyz/         │
│                                                                                        │
└────────────────────────────────────────────────────────────────────────────────────────┘

4.1 Paso a paso: edición de un archivo de configuración archivado¶

1. Navegue hasta el archivo (por ejemplo, application_bundle.zip) presionando Enter.
2. Localice el archivo que desea modificar (por ejemplo, settings.yaml).
3. Presione F4 (Fn+F4). ATBCmder extrae el archivo en un caché temporal e inicia el editor integrado.
4. Realice sus modificaciones en el editor.
5. Presione Cmd+S (⌘S) para guardar.
6. Cierre el editor con Cmd+W (⌘W) o Esc.
7. RepackWorker de ATBCmder actualiza automáticamente el miembro interno, comprime la estructura actualizada en un archivo temporal, reemplaza atómicamente el archivo original y actualiza la vista del panel.

5. Creación y extracción de archivos (Alt+F5 / Alt+F9)¶

ATBCmder proporciona trabajadores en segundo plano dedicados para crear y extraer archivos, lo que garantiza que sus paneles de archivos sigan respondiendo incluso durante trabajos de compresión de larga duración.

Figura 6.2: El cuadro de diálogo Parámetros de archivo (Alt+F5 / cm_PackFiles) que muestra la ruta de destino, la selección de formato, los niveles de compresión y el cifrado de contraseña.

5.1 Comprimir archivos (Alt+F5 / ⌥F5 / cm_PackFiles)¶

Para crear un nuevo archivo:

1. En el panel activo, seleccione los archivos o directorios que desea agrupar.
2. Presione Alt+F5 (⌥F5) o elija Archivos ➔ Empaquetar... en la barra de menú.
3. Aparece el cuadro de diálogo Empaquetar archivos:
4. Crear archivo comprimido: ruta del archivo de destino. De forma predeterminada, ATBCmder sugiere colocar el archivo en el directorio del panel inactivo, que lleva el nombre del elemento enfocado.
5. Formato de archivo: elija entre ZIP, TAR, TAR.GZ, TAR.BZ2, TAR.XZ o 7Z.
6. Nivel de compresión:
7. Store: Compresión cero; Embalaje instantáneo para medios precomprimidos (MP4, JPEG).
8. Fast: Baja sobrecarga de CPU; ideal para traslados rápidos.
9. Normal (Deflated): Velocidad y relación de compresión equilibradas (recomendado para uso general).
10. Maximum: compresión de mayor densidad (utiliza LZMA/Bzip2 cuando corresponda).
11. Contraseña (solo ZIP): ingrese una frase de contraseña secreta para cifrar el archivo.
12. Haga clic en Iniciar (o presione Enter). La operación se ejecuta en un hilo en segundo plano sin bloqueo con una barra de progreso y un indicador de estado archivo por archivo.

Cifrado de contraseña AES-256 de grado militar¶

El cifrado ZIP estándar (ZipCrypto heredado) está criptográficamente roto y es vulnerable a ataques de diccionario de texto sin formato. Cuando especifica una contraseña para un archivo ZIP, ATBCmder utiliza cifrado AES-256 impulsado por pyzipper (pyzipper.AESZipFile con el estándar WZ_AES). Esto garantiza la compatibilidad con macOS, WinZip y 7-Zip al tiempo que protege los datos confidenciales contra el descifrado por fuerza bruta.

División de archivos enormes en conjuntos de varios volúmenes¶

Si necesita distribuir un archivo entre archivos adjuntos de correo electrónico, unidades FAT32 o límites de carga en la nube con límites de tamaño de archivo:

1. Agrupe sus archivos usando Alt+F5 (cm_PackFiles).
2. Resalte el archivo resultante .zip o .tar y active el divisor de archivos mediante Alt+F6 (cm_FileSpliter).
3. Seleccione un tamaño de división preestablecido (por ejemplo, 100 MB, 4.7 GB DVD, CD 700 MB o un tamaño de byte personalizado).
4. ATBCmder genera piezas divididas numeradas (archive.zip.001, archive.zip.002, etc.) junto con un manifiesto de verificación CRC32. Los destinatarios pueden volver a ensamblar el contenedor original en cualquier momento usando cm_FileLinker (cm_Combine).

5.2 Extracción de archivos (Alt+F9 / ⌥F9 / cm_ExtractFiles)¶

Para extraer archivos al disco:

1. Resalte uno o más archivos en el panel activo.
2. Presione Alt+F9 (⌥F9) o elija Archivos ➔ Extraer... en la barra de menú.
3. Aparece el cuadro de diálogo Extraer archivos:
4. Archivo para extraer: ruta de origen del contenedor seleccionado.
5. Extraer a directorio: Directorio de destino (por defecto, el panel inactivo).
6. Vista previa de contenido: un cuadro de lista interactivo que carga los miembros del archivo en tiempo real.
7. Contraseña: campo de entrada para archivos protegidos con contraseña.
8. Haga clic en Iniciar. Si ya existe algún archivo de destino en la carpeta de destino, ATBCmder pausa el trabajador y presenta un cuadro de diálogo de colisión interactivo:
9. Sobrescribir: reemplaza el archivo de destino en conflicto.
10. Omitir: deja el archivo existente intacto y pasa al siguiente elemento.
11. Sobrescribir todo: sobrescribe silenciosamente todos los conflictos posteriores.
12. Omitir todo: omite automáticamente todos los archivos de destino existentes.
13. Cancelar: Detiene de forma segura el proceso de extracción.

6. Red remota VFS: protocolos y almacenamiento remoto¶

ATBCmder incluye un motor de cliente de red multiprotocolo capaz de montar, explorar y manipular servidores remotos directamente dentro del espacio de trabajo de panel dual.

Figura 6.3: Exploración de directorios de servidores Linux remotos a través de SFTP seguro con atributos de archivos en vivo, permisos de propiedad y transferencia de panel dual.

Figura 6.4: Tipos de conexión de red admitidos: FTP/FTPS, SFTP seguro, almacenamiento en la nube WebDAV y recursos compartidos de red SMB.

6.1 Protocolos de red admitidos¶

6.2 Capacidades de protocolo y análisis profundo¶

SFTP (Protocolo de transferencia de archivos SSH)¶

Respaldado por el motor SSH estándar de la industria paramiko, el controlador SFTP de ATBCmder establece túneles cifrados a través del puerto 22:

• Seguridad de la clave del host (WarningPolicy): en cumplimiento de estrictos requisitos de seguridad, ATBCmder consulta automáticamente su archivo local ~/.ssh/known_hosts. Al conectarse a un host conocido, las claves del host se verifican criptográficamente. Si se encuentra un servidor desconocido, ATBCmder emite una advertencia de seguridad en lugar de confiar silenciosamente en claves públicas inesperadas.
• Autenticación de clave SSH: además de la autenticación de contraseña estándar, ATBCmder admite archivos de clave privada SSH (~/.ssh/id_rsa, ~/.ssh/id_ed25519).
• Asignación de atributos UNIX: conserva los modos de archivo octal remoto (chmod), cadenas de propiedad de usuario/grupo y marcas de tiempo exactas de modificación POSIX.

FTP y FTPS (SSL explícito/implícito)¶

Impulsado por ftplib de Python, el controlador FTP admite:

• Modo pasivo (PASV): habilitado de forma predeterminada para garantizar conexiones confiables a través de enrutadores NAT restrictivos y firewalls de consumo.
• Codificaciones configurables: resuelve problemas de visualización de nombres de archivos no ASCII al permitirle cambiar entre los conjuntos de caracteres UTF-8, ISO-8859-1, GB18030 y Windows-1252.

SMB/Samba (Windows compartidos y dispositivos NAS)¶

A diferencia de las bibliotecas Python SMB de espacio de usuario ingenuo que sufren velocidades de transferencia lentas, ATBCmder emplea una arquitectura híbrida:

• Aceleración del kernel nativo de macOS (mount_smbfs): en macOS, SambaMounter de ATBCmder aprovecha el subsistema nativo /sbin/mount_smbfs de Apple. Monta el recurso compartido remoto directamente en el árbol VFS de macOS (/Volumes/ o un directorio de montaje aislado), desbloqueando el rendimiento completo de lectura/escritura SMB3 acelerado por hardware.
• Detección de montaje existente: si macOS Finder o un script del sistema ya ha montado el recurso compartido SMB de destino, ATBCmder detecta automáticamente el punto de montaje activo de la tabla OS mount y navega hasta él instantáneamente, evitando conexiones de red redundantes.

WebDAV y WebDAVS (Nextcloud / Almacenamiento en la nube)¶

Creado sobre webdavclient3, este controlador proporciona sincronización de archivos bidireccional con soluciones modernas de almacenamiento en la nube:

• Verificación de certificados SSL: admite una validación estricta de certificados SSL para hosts WebDAVS públicos, con una opción de anulación para certificados autofirmados en configuraciones de laboratorio privado.
• Creación recursiva de directorio (makedirs): crea automáticamente rutas de directorio remotas anidadas faltantes durante las operaciones de carga masiva.

6.3 Almacenamiento en la nube de Google Drive: Guía paso a paso¶

Administrar Google Drive a través de un navegador web a menudo se siente lento al subir archivos grandes u organizar carpetas anidadas. Además, la aplicación oficial de escritorio de Google Drive suele intentar sincronizar estructuras de carpetas completas en su SSD local de Mac, consumiendo un valioso espacio de almacenamiento.

ATBCmder resuelve esto tratando a Google Drive como una unidad virtual activa (gdrive://). Puede explorar directamente sus carpetas remotas de Google Drive dentro de la interfaz de doble panel, previsualizar archivos de la nube con F3 y copiar archivos con F5 entre su Mac y Google Drive, sin descargar todo su almacenamiento en la nube a su computadora.

Figura 6.5: Conexión a Google Drive mediante el Administrador de conexiones con credenciales de cliente OAuth2 y navegación por archivos en la nube junto a carpetas locales en la vista de panel doble.

¿Por qué necesito un "Client ID" y un "Client Secret"?¶

Para proteger su privacidad y seguridad, Google no permite que aplicaciones de escritorio de terceros soliciten directamente la contraseña de su cuenta de Google. En su lugar, Google utiliza la autorización OAuth 2.0.

Al crear sus propias credenciales gratuitas de OAuth en Google Cloud Console:

• 100% privado y directo: Sus datos viajan directamente entre su Mac y los servidores oficiales de Google. Ningún tercero o servidor intermedio ve jamás sus archivos ni sus credenciales.
• Velocidad y cuota dedicadas: Obtiene su propio ancho de banda de API privado sin compartir límites de frecuencia con miles de otros usuarios.
• Revocable en cualquier momento: Mantiene el control total. Puede revocar el acceso de ATBCmder con un solo clic en el panel de seguridad de su cuenta de Google en cualquier momento.

¡Completar esta configuración toma menos de 3 minutos y solo debe realizarse una vez!

Paso 1: Crear credenciales gratuitas en Google Cloud (Toma 2 minutos)¶

1. Abra Google Cloud Console — Credenciales en su navegador web e inicie sesión con su cuenta de Google.
2. Seleccionar o crear un proyecto:
3. En la parte superior de la página, haga clic en el menú desplegable de organización / proyecto.
4. (Consejo para organizaciones: si tiene una organización de Google Workspace o Cloud Identity como aitobox.com, selecciónela para que el proyecto se cree bajo el dominio de su empresa).
5. Si aún no tiene un proyecto, haga clic en Nuevo proyecto, asígnele el nombre que desee (por ejemplo, ATBCmder) y haga clic en Crear.
6. Habilitar la API de Google Drive:
7. En la barra lateral izquierda o en la barra de búsqueda superior, vaya a APIs y servicios habilitados (o haga clic en + HABILITAR APIS Y SERVICIOS).
8. Busque Google Drive API, haga clic en ella y luego en el botón azul Habilitar.
9. Configurar la pantalla de consentimiento de OAuth (si se le solicita):
10. Si es la primera vez que crea credenciales, es posible que Google le solicite configurar la pantalla de consentimiento:
    • Seleccione Externo y haga clic en Crear.
    • Complete el Nombre de la aplicación (por ejemplo, ATBCmder) e ingrese su dirección de correo electrónico para soporte y contacto de desarrollador.
    • En Dominio de la aplicación, configure la Página principal de la aplicación en su sitio (por ejemplo, https://cmder.aitobox.com).
    • En Dominios autorizados, agregue su dominio raíz (por ejemplo, aitobox.com).
    • Haga clic en Guardar y continuar en las pantallas siguientes.
11. Crear credenciales para la aplicación de escritorio:
12. Regrese a APIs y servicios ➔ Credenciales.
13. Haga clic en + Crear credenciales en la parte superior y elija ID de cliente de OAuth.
14. En el menú desplegable Tipo de aplicación, seleccione App de escritorio (Desktop app).
15. En el campo Nombre, ingrese ATBCmder Desktop (o cualquier nombre descriptivo).
16. Haga clic en Crear.
17. Copiar sus claves:
18. Aparecerá un cuadro de diálogo con su ID de cliente (que termina en .apps.googleusercontent.com) y su Secreto de cliente.
19. Copie ambas cadenas (o mantenga la pestaña abierta).

Marca personalizada: Entendiendo "Acceso concedido a" (Access Granted To)¶

Cuando consulta las aplicaciones de terceros conectadas en el centro de seguridad de su cuenta de Google (myaccount.google.com/connections), Google muestra una tarjeta de detalles para ATBCmder:

• Nombre de la app: ATBCmder
• Acceso concedido a (Access granted to): p. ej., aitobox.com u oplist.org
• Página principal: https://cmder.aitobox.com

¿Por qué Google muestra un nombre de organización específico?¶

La línea "Acceso concedido a" (Access granted to) la determina Google automáticamente en función de la organización de Google Cloud (o cuenta de Google Workspace) propietaria del proyecto de GCP donde se generó su ID de cliente OAuth:

• Si su ID de cliente se creó en un proyecto de GCP bajo una organización externa (como oplist.org), Google mostrará ese dominio para notificar de quién es el cliente de API.
• Si el proyecto se creó con una cuenta personal de Google, Google muestra la identidad de contacto del desarrollador.

Cómo establecer la organización en su propio dominio (p. ej., aitobox.com)¶

Si desea que el panel de seguridad de Google muestre el dominio personalizado de su empresa (como aitobox.com):

1. Crear el proyecto bajo su organización de dominio:
2. Inicie sesión en Google Cloud Console con una cuenta de su dominio corporativo (p. ej., admin@aitobox.com).
3. En el selector superior, confirme que su dominio (p. ej., aitobox.com) esté seleccionado antes de crear el proyecto.
4. Configurar el dominio de la app en la pantalla de consentimiento de OAuth:
5. Vaya a APIs y servicios ➔ Pantalla de consentimiento de OAuth.
6. Configure la Página principal de la aplicación con su sitio oficial (p. ej., https://cmder.aitobox.com).
7. Registre su dominio raíz en Dominios autorizados (p. ej., aitobox.com).
8. Configure los correos de soporte y contacto con direcciones de su dominio.
9. Generar un nuevo ID de cliente de aplicación de escritorio:
10. Vaya a APIs y servicios ➔ Credenciales y cree un nuevo ID de cliente de OAuth de tipo App de escritorio.
11. Actualizar las claves en ATBCmder:
12. Pegue el nuevo ID de cliente y Secreto en el Administrador de conexiones de ATBCmder y haga clic en Volver a autorizar....
13. ¡Google ahora mostrará el dominio de su empresa (aitobox.com) como el destinatario autorizado!

Paso 2: Agregar Google Drive en ATBCmder¶

Una vez que tenga sus claves, agregarlo en ATBCmder requiere solo unos pocos clics:

1. En ATBCmder, abra Red ➔ Administrar conexiones... en la barra de menú superior (o presione cm_ManageConnections).
2. Haga clic en el botón + Nuevo en la esquina inferior izquierda.
3. En el formulario de Detalles de la conexión a la derecha:
4. Etiqueta: Ingrese un nombre descriptivo (p. ej., Mi Google Drive o Drive del Trabajo).
5. Protocolo: Seleccione gdrive en el menú desplegable.
6. ID de cliente: Pegue el Client ID copiado de Google Cloud.
7. Secreto de cliente: Pegue el Client Secret copiado de Google Cloud.
8. (Consejo: puede hacer clic en el enlace azul Create OAuth 2.0 credentials in Google Cloud Console para acceder en cualquier momento).
9. Haga clic en el botón Autorizar (o Volver a autorizar...):
10. ATBCmder abrirá automáticamente su navegador web predeterminado en la página de inicio de sesión oficial de Google.
11. Aviso de seguridad importante (Totalmente normal y esperado):
    Como está utilizando un Client ID privado creado en su propio proyecto de Google Cloud en lugar de una aplicación comercial de la tienda, Google mostrará una pantalla de advertencia que indica "Google no ha verificado esta app" / "Riesgo de seguridad".
    Esto es completamente normal y seguro. En su navegador, expanda las opciones (haga clic en Opciones avanzadas / Advanced) y seleccione "Ir a la app (no seguro) / Continuar de todos modos".
12. Seleccione su cuenta de Google y confirme los permisos solicitados (lectura/escritura en Google Drive).
13. Haga clic en Continuar / Permitir.
14. Tras la aprobación, el navegador confirmará el éxito. Al volver a ATBCmder, el estado se actualizará a:
    ✓ Authorized (your_account@gmail.com)!

1. Haga clic en 💾 Guardar para registrar la conexión y luego en 🔗 Conectar (o haga doble clic en el elemento en la lista izquierda).
2. Se abrirá una nueva pestaña en el panel activo que apunta a:

   vfs://gdrive://your_account@gmail.com//
   

   ¡Todos sus archivos y carpetas de Google Drive estarán listos frente a usted!

Paso 3: Trabajar con Google Drive como una unidad local¶

Una vez conectado, Google Drive se comporta exactamente como una carpeta local:

• Exploración y vista previa instantánea: Haga doble clic o presione Enter para abrir carpetas. Seleccione cualquier imagen, PDF, código o documento y presione F3 para examinarlo al instante en el Visor Universal sin descargarlo primero.
• Subir a la nube (F5): Seleccione archivos en su panel local (p. ej., Descargas) y presione F5 para subirlos directamente a la carpeta remota de Google Drive.
• Descargar al equipo (F5): Seleccione archivos en el panel de Google Drive y presione F5 para descargarlos en su carpeta local de destino.
• Arrastrar y soltar: Arrastre archivos y carpetas libremente con el mouse entre el panel local y el de Google Drive.
• Actualización instantánea (F9 / Ctrl+R): Si un compañero comparte un nuevo archivo o realiza cambios desde el teléfono, presione F9 para sincronizar de inmediato las últimas novedades de la nube.
• Indicador de cuota de almacenamiento en tiempo real: La cápsula de estado en la barra de herramientas superior derecha muestra el espacio restante en su Google Drive (p. ej., 259.7 GB free of 994.7 GB).
• Múltiples cuentas: Puede configurar varios perfiles de Google Drive en el Administrador de conexiones (p. ej., Drive Personal y Drive Laboral) e incluso transferir archivos directamente abriendo una cuenta en cada panel.
• Seguridad respaldada por Secure Enclave: El Secreto de cliente y los tokens de OAuth se almacenan cifrados directamente en el Llavero del sistema macOS (ATBCmder_VFS) protegido por el enclave seguro de Apple.

6.4 Almacenamiento en la nube de Dropbox: Guía paso a paso¶

Al igual que con Google Drive, acceder directamente a Dropbox en ATBCmder le brinda la libertad de explorar, cargar y organizar archivos en la nube sin tener que sincronizar cientos de gigabytes en su disco SSD local.

ATBCmder trata a Dropbox como una unidad virtual activa (dropbox://), lo que le permite previsualizar fotos y documentos con F3, transferir por streaming fragmentado con F5 y supervisar la cuota de almacenamiento en tiempo real en la barra de herramientas.

¿Por qué necesito una "App Key" y un "App Secret"?¶

Para proteger su privacidad y seguridad, Dropbox no permite que herramientas de escritorio de terceros soliciten o almacenen la contraseña de su cuenta. En su lugar, Dropbox utiliza la autorización OAuth 2.0.

Al crear su propia clave de aplicación y secreto gratuitos en Dropbox App Console:

• 100% privado y directo: Sus datos se transmiten directamente entre su Mac y los servidores oficiales de Dropbox sin ningún servidor intermediario.
• Velocidad y cuota dedicadas: Obtiene su propio ancho de banda de API privado sin compartir límites con otros usuarios.
• Revocable en cualquier momento: Mantiene el control total. Puede revocar el acceso de ATBCmder con un solo clic en la configuración de seguridad de su cuenta de Dropbox.

¡Completar la configuración toma menos de 2 minutos y es válida para siempre!

Paso 1: Crear una aplicación en Dropbox App Console¶

1. Abra Dropbox App Console en su navegador web e inicie sesión con su cuenta de Dropbox.
2. Haga clic en el botón azul Create app en la esquina superior derecha.
3. Configure su aplicación como se muestra a continuación:

Figura 6.6: Creación de una nueva aplicación en Dropbox App Console con Scoped access y acceso Full Dropbox.

• 1. Choose an API: Seleccione Scoped access.
• 2. Choose the type of access you need: Seleccione Full Dropbox (Acceso a todos los archivos y carpetas de su Dropbox).
  (Nota: si solo desea que ATBCmder acceda a una carpeta aislada, puede elegir "App folder").
• 3. Name your app: Ingrese un nombre único para su aplicación (p. ej., ATBCmder o ATBCmder-SuNombre).
• Marque la casilla I agree to Dropbox API Terms and Conditions.
• Haga clic en el botón azul Create app abajo a la derecha.

Paso 2: Configurar el URI de redirección y copiar las claves (Pestaña Settings)¶

Una vez creada la app, accederá a su panel. Haga clic en la pestaña Settings en la parte superior.

Figura 6.7: Configuración del URI de redirección local (http://127.0.0.1:53682/callback) y copia de App key y App secret.

1. Configurar el URI de redirección OAuth 2:
2. Desplácese hacia abajo hasta la sección OAuth 2.
3. Localice el campo Redirect URIs.

4. Escriba o pegue la siguiente URL exacta:

   http://127.0.0.1:53682/callback
   

5. Haga clic en el botón Add junto al cuadro de entrada.
   (Explicación: ATBCmder inicia un servicio de escucha loopback local seguro en el puerto 53682 durante la autorización. Registrar este URI permite que Dropbox devuelva la autorización de forma segura a ATBCmder con un solo clic).

6. Permitir clientes públicos (PKCE):
7. Asegúrese de que la opción Allow public clients (Implicit Grant & PKCE) esté configurada en Allow (o predeterminada).
8. Copiar su App Key y App Secret:
9. Cerca de la parte superior de la pestaña Settings, busque App key y cópiela.
10. Justo debajo, busque App secret, haga clic en Show y copie la clave secreta.
    (Mantenga esta ventana abierta o guarde las claves temporalmente).

Paso 3: Configurar los permisos requeridos (Pestaña Permissions)¶

A continuación, haga clic en la pestaña Permissions en la parte superior de la página de configuración.

Figura 6.8: Selección de los permisos necesarios en la pestaña Permissions, incluidos files.metadata.read/write y files.content.read/write.

1. En Account Info:
2. account_info.read: Ver información básica sobre su cuenta de Dropbox (marcado de forma predeterminada, permite a ATBCmder detectar y mostrar el correo electrónico de su cuenta).
3. En Files and folders, asegúrese de que las siguientes casillas estén marcadas:
4. files.metadata.write: Ver y editar información sobre sus archivos y carpetas de Dropbox.
5. files.content.write: Editar el contenido de sus archivos y carpetas de Dropbox (subir y modificar archivos).
6. files.content.read: Ver el contenido de sus archivos y carpetas de Dropbox (descargar y ver archivos).

Paso 4: Agregar Dropbox en ATBCmder y autorizar en un clic¶

Una vez configurada su aplicación de Dropbox, agregarla a ATBCmder toma solo unos instantes:

1. En ATBCmder, abra Red ➔ Administrar conexiones... en la barra superior (o presione cm_ManageConnections).
2. Haga clic en el botón + Nuevo en la esquina inferior izquierda.
3. En el formulario de Detalles de la conexión a la derecha:
4. Etiqueta: Ingrese un nombre descriptivo (p. ej., Mi Dropbox o Dropbox del Equipo).
5. Protocolo: Seleccione dropbox en el menú desplegable.
6. App Key: Pegue la App Key copiada de la pestaña Settings.
7. App Secret: Pegue el App Secret copiado de la pestaña Settings.
8. (Consejo: puede hacer clic en el enlace Create app in Dropbox App Console para ir a la consola).
9. Haga clic en el botón Iniciar sesión con el navegador... (o Autorizar):
10. ATBCmder abrirá automáticamente su navegador en la página oficial de consentimiento de Dropbox.
11. Revise los permisos solicitados y haga clic en Permitir (Allow).
12. Tras la aprobación, el navegador confirmará el éxito. En ATBCmder, el estado cambiará a:
    ✓ Authorized (your_account@email.com)!
13. Haga clic en 💾 Guardar para almacenar la conexión y luego en 🔗 Conectar (o haga doble clic en la lista izquierda).
14. Se abrirá una nueva pestaña en su panel activo que apunta a:

    vfs://dropbox://your_account@email.com//
    

    ¡Todos sus archivos y carpetas de Dropbox estarán disponibles de inmediato!

Problema común y solución de problemas¶

Paso 5: Trabajar con Dropbox como una unidad local¶

Una vez conectado, Dropbox funciona como una unidad local de alta velocidad:

• Copia de panel doble (F5): Seleccione archivos en su panel local (p. ej., Documentos o Descargas) y presione F5 para subirlos a Dropbox; o seleccione archivos remotos y presione F5 para descargarlos.
• Transferencias fragmentadas por streaming: Utiliza sesiones de streaming no bloqueantes con indicadores de progreso en tiempo real, administrando archivos de video o archivos comprimidos de varios gigabytes sin saturar la memoria del sistema.
• Vista previa instantánea (F3): Seleccione cualquier imagen, PDF, Markdown o archivo de texto en Dropbox y presione F3 para examinarlo en el Visor Universal sin guardarlo previamente en el disco.
• Creación de carpetas (F7): Presione F7 para crear nuevos directorios remotos, con creación recursiva automática de cualquier carpeta principal faltante.
• Arrastrar y soltar: Arrastre archivos y carpetas libremente con el mouse entre el panel local y el panel de Dropbox.
• Indicador de capacidad en vivo: El espacio restante en Dropbox se muestra en tiempo real en la barra de herramientas superior derecha (p. ej., 1.8 GB free of 2.0 GB).
• Actualización instantánea (F9 / Ctrl+R): Obtenga cambios remotos realizados en otros dispositivos con una sola tecla.
• Seguridad mediante Secure Enclave: Los tokens de OAuth y las credenciales se almacenan cifrados directamente en el Llavero del sistema macOS (ATBCmder_VFS) respaldado por el hardware de Apple.

6.3 Almacenamiento en la nube Sandbox de App Store (OneDrive, Google Drive, iCloud)¶

En las versiones sandbox de ATBCmder en Mac App Store, el acceso directo al sistema de archivos a directorios de sincronización en la nube de terceros (por ejemplo, Microsoft OneDrive, Google Drive para escritorio, Dropbox e iCloud Drive) está regulado por la arquitectura sandbox de Apple:

• Marcadores con ámbito de seguridad: los directorios de nube sincronizados que residen en ~/Library/CloudStorage/OneDrive-*, ~/Library/CloudStorage/GoogleDrive-* o ~/Library/Mobile Documents/com~apple~CloudDocs/ requieren tokens de acceso con ámbito de seguridad.
• Drive Switcher & Path Integration: ATBCmder descubre automáticamente directorios de nube locales configurados y los muestra en Drive Switcher (Alt+D / ⌥D), barras de botones de unidad y rutas de navegación.
• Concesiones de permisos persistentes: al abrir un directorio en la nube por primera vez, macOS presenta una hoja de autorización. Una vez seleccionado, ATBCmder almacena el marcador criptográfico con alcance de seguridad en las preferencias del usuario, otorgando acceso de lectura/escritura ininterrumpido y fluido durante los reinicios de la aplicación sin diálogos de autorización repetidos.

7. Conexión rápida frente a Administrador de conexiones¶

ATBCmder proporciona dos mecanismos flexibles para conectarse a hosts remotos: Conexión rápida para sesiones rápidas y temporales y Administrador de conexión para marcadores de servidor persistentes y categorizados.

7.1 Conexión rápida (cm_NetworkConnect)¶

Cuando necesita acceder rápidamente a un servidor sin saturar su configuración permanente:

1. Elija Red ➔ Conexión rápida... (o ejecute el comando cm_NetworkConnect).
2. Aparece el mensaje de conexión ligera:
3. Protocolo: Seleccione sftp, ftp, ftps, smb, webdav, webdavs, gdrive o dropbox.
4. Host y puerto: ingrese la dirección del servidor (el puerto completa automáticamente los valores predeterminados).
5. Nombre de usuario y contraseña: ingrese las credenciales de conexión.
6. Ruta remota: inicio del directorio remoto (predeterminado: /).
7. Recordar contraseña: déjelo sin marcar para una conexión efímera de sesión única.
8. Haga clic en Probar conexión para verificar el protocolo de enlace y las credenciales de la red antes de conectarse.
9. Haga clic en Conectar. ATBCmder abre inmediatamente una nueva pestaña en el panel activo que apunta al servidor remoto.

7.2 Administrador de conexiones (cm_ManageConnections)¶

Para los servidores a los que accede regularmente, Connection Manager proporciona un panel de configuración completo:

┌────────────────────────────────────────────────────────────────────────────────────────┐
│                              CONNECTION MANAGER DIALOG                                 │
├──────────────────────────────┬─────────────────────────────────────────────────────────┤
│  Saved Connections           │  Connection Details                                     │
│  ┌────────────────────────┐  │  Label:        [ Staging Web Server (AWS)             ] │
│  │ 🔐 AWS Staging Server  │  │  Protocol:     [ SFTP (port 22)                     ▼ ] │
│  │ 🖧 Synology Office NAS │  │  Host:         [ ec2-54-210-10-2.compute.amazonaws.com] │
│  │ 🌐 Nextcloud Personal  │  │  Port:         [ 22                                   ] │
│  │ 📂 Legacy Archive FTP  │  │  Username:     [ ubuntu                               ] │
│  │                        │  │  Password:     [ ••••••••••••••••••                   ] │
│  │                        │  │  Remote Path:  [ /var/www/production                  ] │
│  │                        │  │  [✓] Remember password in macOS Keychain                │
│  └────────────────────────┘  │                                                         │
│  [➕ New] [⧉ Dup] [🗑 Del]    │  [🔍 Test Connection]          [💾 Save]  [🔗 Connect] │
└──────────────────────────────┴─────────────────────────────────────────────────────────┘

Administrar perfiles de servidor¶

• Crear nuevo (➕ New): borra el formulario de la derecha para definir una nueva configuración de servidor.
• Duplicar (⧉ Duplicate): Clona el perfil de conexión seleccionado. Ideal para gestionar múltiples entornos (desarrollo, ensayo, producción) en configuraciones de host idénticas.
• Eliminar (🗑 Delete): elimina el perfil de conexión y elimina las credenciales asociadas del llavero del sistema.
• Probar conexión (🔍 Test Connection): envía un trabajador en segundo plano (ConnectionTestWorker) para conectarse, autenticarse y desconectarse correctamente, verificando la capacidad de respuesta del servidor sin tener que navegar.
• Conectar (🔗 Connect): guarda cualquier edición de campo pendiente, establece la sesión remota y carga el directorio remoto en una nueva pestaña del panel activo.

Menú de conexiones guardadas dinámicas¶

Las conexiones guardadas se integran automáticamente en la barra de menú superior en Red ➔ Conexiones guardadas. Puede montar cualquier servidor marcado con un solo clic:

• Network ➔ Saved Connections ➔ 🔐 AWS Staging Server
• Network ➔ Saved Connections ➔ 🖧 Synology Office NAS

8. Seguridad de credenciales e integración de llaveros¶

Los archivos de configuración del administrador de archivos son un objetivo principal para el malware de recolección de credenciales. Muchos administradores de archivos heredados almacenan contraseñas FTP/SFTP en archivos de configuración XML o INI de texto sin formato ubicados en el directorio de inicio del usuario.

ATBCmder garantiza cero almacenamiento de credenciales de texto sin cifrar.

8.1 La arquitectura de seguridad¶

┌────────────────────────────────────────────────────────────────────────────────────────┐
│                           CREDENTIAL STORAGE ARCHITECTURE                              │
├────────────────────────────────────────────────────────────────────────────────────────┤
│                                                                                        │
│   Connection Configuration XML                    Apple System Keychain                │
│   (~/.config/atbcmder/atbcmder.xml)               (service: "ATBCmder_VFS")            │
│   ┌─────────────────────────────────────┐         ┌──────────────────────────────────┐ │
│   │ <connection>                        │         │ Label: "AWS Staging Server"      │ │
│   │   <label>AWS Staging</label>        │         │ Key:   Encrypted Secret          │ │
│   │   <scheme>sftp</scheme>             │         │ Access: Controlled by macOS      │ │
│   │   <host>aws.infra.net</host>        │         │         Hardware Security Enclave│ │
│   │   <user>deploy</user>               │         └──────────────────────────────────┘ │
│   │   <password></password>             │                           ▲                  │
│   │ </connection>                       │                           │                  │
│   └─────────────────────────────────────┘                           │                  │
│         ▲                                                           │                  │
│         │ Password stripped on save                                 │ Stored via       │
│         └─────────────────── ConnectionManager ─────────────────────┘ Python keyring   │
│                                                                                        │
└────────────────────────────────────────────────────────────────────────────────────────┘

1. Borrado XML de texto sin cifrar: Siempre que los perfiles de conexión se serializan en el disco (atbcmder.xml), la rutina ConnectionManager.save() fuerza explícitamente d["password"] = "" antes de escribir. Incluso si una parte no autorizada inspecciona su XML de configuración, nunca se revelarán las contraseñas del servidor.
2. Cifrado del llavero del sistema macOS: cuando se selecciona la casilla Recordar contraseña, las contraseñas se guardan directamente en el llavero macOS a través de la API del sistema keyring bajo el identificador de servicio seguro ATBCmder_VFS. La derivación y el almacenamiento de claves están protegidos por el hardware Secure Enclave de Apple.
3. Sesiones efímeras en memoria: si "Recordar contraseña" no está marcado, las credenciales se mantienen estrictamente en la memoria dinámica (VFSSessionCache) durante el ciclo de vida actual de la aplicación y se borran en el momento en que finaliza ATBCmder.

9. ⚡ Consejos profesionales: operaciones remotas de alto rendimiento¶

Consejo 1: Cola de transferencia en segundo plano sin bloqueo (cm_OperationsPanel)¶

Al copiar directorios grandes en servidores remotos o descargar archivos ISO de varios gigabytes a través de SFTP, nunca congele su espacio de trabajo. Todas las operaciones de archivos de red en ATBCmder se integran automáticamente con la Cola de operaciones en segundo plano:

• Presione F5 para iniciar una transferencia, luego haga clic en Fondo (o déjelo en cola automáticamente).
• Abra el panel de operaciones a través de Mostrar ➔ Panel de operaciones (cm_OperationsPanel) para monitorear gráficos de ancho de banda en vivo, recuentos de bytes por archivo y estimaciones de transferencia restantes.
• Puede pausar, reanudar o reordenar las transferencias de red en cola mientras continúa explorando archivos locales en ambos paneles.

Consejo 2: Copia de secuencias a través de protocolos heterogéneos¶

El motor stream_copy_file de ATBCmder permite transmisión directa de servidor a servidor. Si arrastra una carpeta desde un servidor SFTP en el Panel izquierdo a un recurso compartido de red SMB en el Panel derecho:

• ATBCmder no descarga el directorio completo a su disco duro local de Mac antes de volver a cargarlo.
• Los datos se fragmentan a través de un anillo de búfer en memoria, transmitiendo bytes desde el socket de origen directamente al socket de destino. Esto elimina el desgaste del disco local y admite transferencias mayores que la capacidad SSD local disponible.

Consejo 3: Mantener activa la red y evitar caídas de conexión¶

Los firewalls de red con estado y las puertas de enlace NAT frecuentemente cortan las conexiones TCP inactivas después de 60 a 300 segundos de inactividad. Para evitar sesiones desconectadas al explorar árboles remotos grandes:

• La capa BaseNetworkVFS de ATBCmder mantiene automáticamente los latidos de la sesión a través de conexiones inactivas.
• Si se produce una caída momentánea de la red, el mecanismo interno _retry() ejecuta hasta 3 reintentos usando un retroceso exponencial (2^attempt intervalos de segundos) antes de informar una falla de conexión.

Consejo 4: Edición de archivos remotos con ciclo de vida de carga automática¶

¿Necesita editar un nginx.conf o un script de Python directamente en un servidor remoto?

1. Resalte el archivo remoto en la vista del panel SFTP o WebDAV.
2. Presione F4 (Fn+F4).
3. ATBCmder descarga el archivo en un entorno limitado temporal aislado (/tmp/) y lo abre en el editor integrado.
4. Cada vez que presiona Cmd+S (⌘S), ATBCmder activa _upload_vfs_temp(), transmite el archivo actualizado al servidor remoto de forma asincrónica y muestra una confirmación en la barra de estado.
5. Cuando cierra el editor, el archivo temporal se desvincula de forma segura de /tmp/.

10. Sistema y alertas de seguridad¶

11. Tabla de referencia del teclado maestro de matriz dual¶