Capitolo 6: File system virtuali e rete¶

La moderna gestione dei file raramente si ferma al confine di un singolo disco rigido fisico. Gli sviluppatori di software mantengono ambienti di gestione temporanea remoti su SFTP; gli amministratori di sistema gestiscono le condivisioni di file aziendali su SMB/CIFS; i creatori di contenuti accedono allo storage cloud e ai server multimediali tramite WebDAV; e gli utenti esperti ispezionano, modificano e impacchettano regolarmente archivi compressi su scala gigabyte.

Gli ambienti desktop tradizionali costringono gli utenti a destreggiarsi tra applicazioni disgiunte: un'utilità di archivio autonoma per decomprimere e ricomprimere archivi zip, un client FTP/SFTP esterno per gestire le risorse del server e finestre di dialogo di montaggio del sistema operativo che spargono volumi remoti su finestre del Finder disconnesse.

ATBCmder elimina questa frammentazione attraverso il suo motore Virtual File System (VFS). Basato su un livello di astrazione URI vfs:// unificato, ATBCmder tratta i server remoti e gli archivi compressi esattamente come cartelle locali standard. È possibile navigare in un archivio .tar.gz, visualizzare in anteprima i file di codice con F3, modificare un file di configurazione nidificato con F4 (con repacking automatico in tempo reale al salvataggio) e copiare le risorse direttamente attraverso una sessione SFTP sicura su un NAS per PMI in sede utilizzando la chiave standard F5, il tutto senza estrarre file intermedi su disco o passare da uno strumento separato all'altro.

1. Avvio rapido visivo: l'architettura VFS e la matrice dei comandi¶

ATBCmder instrada tutto l'accesso al filesystem attraverso un livello di astrazione unificato. Sia che un percorso punti a una partizione SSD APFS Apple, a un membro all'interno di un archivio nidificato .zip o a una directory remota ospitata su un server SFTP Linux dall'altra parte del mondo, l'interfaccia a doppio pannello fornisce un modello operativo identico.

┌────────────────────────────────────────────────────────────────────────────────────────┐
│                              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      │
└────────────────────────────────────────────────────────────────────────────────────────┘

VFS a doppia matrice e foglio informativo di rete¶

2. L'astrazione URI unificata vfs://¶

I file manager tradizionali trattano i server e gli archivi remoti come cittadini di seconda classe, richiedendo utilità di montaggio esterne, cartelle di estrazione temporanee o client di trasferimento di terze parti. ATBCmder unifica ogni origine file sotto un'unica specifica URI ben definita:

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

2.1 Anatomia dei percorsi virtuali¶

A seconda del dominio operativo, gli URI vfs:// assumono una delle due forme standard:

1. Archivia percorsi virtuali:

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

2. Prefisso esterno: vfs:// indica a FileSystemModel di intercettare l'attraversamento del percorso.

3. Percorso contenitore: /Users/brain/Documents/release_v1.7.zip identifica l'archivio del contenitore fisico nello spazio di archiviazione locale.

4. Membro interno: src/main.py individua la risorsa virtuale annidata all'interno dell'archivio.

5. Percorsi del server di rete:

   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. Scheme Specifier: identifica il driver di trasporto (sftp, ftp, ftps, smb, webdav, webdavs, gdrive, dropbox).

7. Autenticazione: codifica le credenziali dell'utente e la porta di destinazione.
8. Target remoto: risolve la directory assoluta e i percorsi dei file sull'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 Integrazione perfetta del doppio pannello¶

Poiché i percorsi virtuali sono conformi alle strutture di directory standard all'interno di ATBCmder, puoi usufruire della piena parità a doppio pannello:

• Aree di lavoro virtuali a schede: apri una cartella SFTP remota nella Scheda 1, un archivio ZIP locale crittografato nella Scheda 2 e la cartella ~/Downloads locale nella Scheda 3.
• Copia direzionale (F5): seleziona i file nel pannello attivo locale e premi F5 per caricarli direttamente nel server remoto o nell'archivio compresso visualizzato nel pannello inattivo.
• Interoperabilità drag-and-drop: trascina gli elementi tra pannelli tra dischi locali, condivisioni di rete e gerarchie di archivio senza gestione temporanea intermedia.
• Barra breadcrumb interattiva: la barra del percorso breadcrumb analizza gli URI virtuali in segmenti selezionabili. Fai clic su qualsiasi cartella principale o sul badge del server root per saltare immediatamente sull'albero.

3. Archivio VFS: navigazione e ispezione sul posto¶

L'apertura di un archivio in ATBCmder non richiede l'estrazione manuale o uno strumento di decompressione di terze parti. Evidenzia semplicemente qualsiasi archivio supportato e premi Enter (o fai doppio clic). ATBCmder monta l'archivio sul posto, trasformando il pannello in un browser di directory virtuale ad alta velocità.

Figura 6.1: Navigazione all'interno di un archivio compresso multi-nidificato come una cartella virtuale, che mostra dimensioni, timestamp e sottodirectory non compressi.

3.1 Formati di archivio supportati¶

ATBCmder dispone di driver integrati per tutti i formati di archiviazione e compressione standard del settore:

3.2 Flussi di lavoro di navigazione sul posto¶

Durante la navigazione all'interno di un archivio:

1. Entra nelle sottodirectory: premi Enter su qualsiasi cartella all'interno dell'archivio per esplorare gli alberi nidificati.
2. Sali a principale (..): premi Backspace (⌫) o fai doppio clic sulla voce .. [Parent Directory] per salire. Una volta raggiunta la radice dell'archivio, premendo Backspace si ritorna direttamente alla directory fisica contenente il file di archivio.
3. Anteprima istantanea (F3 / Fn+F3): evidenzia qualsiasi documento, immagine o file di origine all'interno dell'archivio e premi F3. ATBCmder estrae automaticamente il file di destinazione in una sandbox temporanea sicura e lo esegue il rendering all'interno dell'Universal Lister.
4. Copia selettiva (F5 / Fn+F5): invece di decomprimere un intero archivio multi-gigabyte solo per recuperare uno o due file, seleziona i membri specifici di cui hai bisogno e premi F5. ATBCmder decomprime solo gli elementi scelti direttamente nel pannello inattivo.

4. Repacking in tempo reale: modifica sul posto all'interno degli archivi¶

Uno dei flussi di lavoro più potenti in ATBCmder è Live Repacking. Storicamente, la modifica di un singolo file annidato all'interno di un archivio compresso richiedeva una noiosa sequenza di sei passaggi: estrarre l'intero archivio, individuare il file di destinazione, modificarlo e salvarlo, ricomprimere la directory in un nuovo archivio, eliminare l'archivio originale e ripulire le cartelle temporanee.

ATBCmder rende la modifica dei file all'interno degli archivi altrettanto semplice quanto la modifica dei file locali standard.

┌────────────────────────────────────────────────────────────────────────────────────────┐
│                              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 Passo dopo passo: modifica di un file di configurazione archiviato¶

1. Navigare nell'archivio (ad esempio, application_bundle.zip) premendo Enter.
2. Individua il file che desideri modificare (ad esempio, settings.yaml).
3. Premere F4 (Fn+F4). ATBCmder estrae il file in una cache temporanea e avvia l'editor integrato.
4. Apporta le modifiche nell'editor.
5. Premere Cmd+S (⌘S) per salvare.
6. Chiudere l'editor con Cmd+W (⌘W) o Esc.
7. RepackWorker di ATBCmder aggiorna automaticamente il membro interno, comprime la struttura aggiornata in un file temporaneo, sostituisce atomicamente l'archivio originale e aggiorna la visualizzazione del pannello.

5. Creazione ed estrazione di archivi (Alt+F5 / Alt+F9)¶

ATBCmder fornisce operatori in background dedicati per la creazione e l'estrazione di archivi, garantendo che i pannelli dei file rimangano reattivi anche durante processi di compressione di lunga durata.

Figura 6.2: La finestra di dialogo Parametri archivio (Alt+F5 / cm_PackFiles) che mostra il percorso di destinazione, la selezione del formato, i livelli di compressione e la crittografia della password.

5.1 Compressione di file (Alt+F5 / ⌥F5 / cm_PackFiles)¶

Per creare un nuovo archivio:

1. Nel pannello attivo, seleziona i file o le directory che desideri raggruppare.
2. Premere Alt+F5 (⌥F5) o scegliere File ➔ Pacchetto... dalla barra dei menu.
3. Viene visualizzata la finestra di dialogo Comprimi file:
4. Crea file di archivio: percorso file di destinazione. Per impostazione predefinita, ATBCmder suggerisce di posizionare l'archivio nella directory del pannello inattivo, che prende il nome dall'elemento focalizzato.
5. Formato archivio: scegli tra ZIP, TAR, TAR.GZ, TAR.BZ2, TAR.XZ o 7Z.
6. Livello di compressione:
7. Store: compressione zero; confezionamento istantaneo per supporti precompressi (MP4, JPEG).
8. Fast: basso sovraccarico della CPU; ideale per trasferimenti veloci.
9. Normal (Deflated): Rapporto di velocità e compressione bilanciato (consigliato per uso generale).
10. Maximum: compressione a densità più elevata (utilizza LZMA/Bzip2 ove applicabile).
11. Password (solo ZIP): inserisci una passphrase segreta per crittografare l'archivio.
12. Fare clic su Start (o premere Enter). L'operazione viene eseguita in un thread in background non bloccante con una barra di avanzamento e un indicatore di stato file per file.

Crittografia password AES-256 di livello militare¶

La crittografia ZIP standard (legacy ZipCrypto) è crittograficamente compromessa e vulnerabile agli attacchi del dizionario di testo normale. Quando specifichi una password per un archivio ZIP, ATBCmder utilizza la crittografia AES-256 fornita da pyzipper (pyzipper.AESZipFile con WZ_AES standard). Ciò garantisce la compatibilità con macOS, WinZip e 7-Zip proteggendo al tempo stesso i dati sensibili dalla decrittografia a forza bruta.

Suddivisione di archivi enormi su set multivolume¶

Se devi distribuire un archivio tra allegati e-mail, unità FAT32 o limiti di caricamento nel cloud con limiti di dimensione file:

1. Raggruppa i tuoi file utilizzando Alt+F5 (cm_PackFiles).
2. Evidenziare l'archivio .zip o .tar risultante e attivare il File Splitter tramite Alt+F6 (cm_FileSpliter).
3. Selezionare una dimensione di suddivisione preimpostata (ad esempio, 100 MB, 4.7 GB DVD, CD 700 MB o dimensione in byte personalizzata).
4. ATBCmder genera parti divise numerate (archive.zip.001, archive.zip.002, ecc.) insieme a un manifest di verifica CRC32. I destinatari possono rimontare il contenitore originale in qualsiasi momento utilizzando cm_FileLinker (cm_Combine).

5.2 Estrazione degli archivi (Alt+F9 / ⌥F9 / cm_ExtractFiles)¶

Per estrarre gli archivi su disco:

1. Evidenzia uno o più archivi nel pannello attivo.
2. Premere Alt+F9 (⌥F9) o scegliere File ➔ Estrai... dalla barra dei menu.
3. Viene visualizzata la finestra di dialogo Estrai file:
4. Archivio da estrarre: percorso di origine del contenitore selezionato.
5. Estrai nella directory: directory di destinazione (per impostazione predefinita è il pannello inattivo).
6. Anteprima dei contenuti: una casella di riepilogo interattiva che carica i membri dell'archivio in tempo reale.
7. Password: campo di immissione per archivi protetti da password.
8. Fare clic su Avvia. Se un file di destinazione esiste già nella cartella di destinazione, ATBCmder mette in pausa il lavoratore e presenta una finestra di dialogo interattiva di collisione:
9. Sovrascrivi: sostituisce il file di destinazione in conflitto.
10. Salta: lascia intatto il file esistente e procede all'elemento successivo.
11. Sovrascrivi tutto: sovrascrive silenziosamente tutti i conflitti successivi.
12. Salta tutto: ignora automaticamente tutti i file di destinazione esistenti.
13. Annulla: interrompe in modo sicuro il processo di estrazione.

6. VFS di rete remota: protocolli e archiviazione remota¶

ATBCmder include un motore client di rete multiprotocollo in grado di montare, esplorare e manipolare server remoti direttamente all'interno dell'area di lavoro a doppio pannello.

Figura 6.3: Navigazione nelle directory del server Linux remoto su SFTP sicuro con attributi di file attivi, autorizzazioni di proprietà e trasferimento a doppio pannello.

Figura 6.4: Tipi di connessione di rete supportati: FTP/FTPS, SFTP sicuro, archiviazione cloud WebDAV e condivisioni di rete SMB.

6.1 Protocolli di rete supportati¶

6.2 Funzionalità del protocollo e approfondimento¶

SFTP (protocollo di trasferimento file SSH)¶

Supportato dal motore SSH paramiko standard del settore, il driver SFTP di ATBCmder stabilisce tunnel crittografati sulla porta 22:

• Sicurezza chiave host (WarningPolicy): in conformità con severi requisiti di sicurezza, ATBCmder consulta automaticamente il tuo file ~/.ssh/known_hosts locale. Quando ci si connette a un host conosciuto, le chiavi dell'host vengono verificate crittograficamente. Se viene rilevato un server sconosciuto, ATBCmder emette un avviso di sicurezza anziché fidarsi silenziosamente di chiavi pubbliche inaspettate.
• Autenticazione chiave SSH: oltre all'autenticazione con password standard, ATBCmder supporta i file di chiave privata SSH (~/.ssh/id_rsa, ~/.ssh/id_ed25519).
• Mappatura attributi UNIX: preserva le modalità file ottali remoti (chmod), le stringhe di proprietà dell'utente/gruppo e i timestamp esatti di modifica POSIX.

FTP e FTPS (SSL esplicito/implicito)¶

Gestito da ftplib di Python, il driver FTP supporta:

• Modalità passiva (PASV): abilitata per impostazione predefinita per garantire connessioni affidabili tramite router NAT restrittivi e firewall consumer.
• Codifiche configurabili: risolve i problemi di visualizzazione dei nomi file non ASCII consentendo di alternare tra i set di caratteri UTF-8, ISO-8859-1, GB18030 e Windows-1252.

PMI/Samba (condivisioni Windows e dispositivi NAS)¶

A differenza delle ingenue librerie SMB Python per lo spazio utente che soffrono di velocità di trasferimento lente, ATBCmder utilizza un'architettura ibrida:

• Accelerazione kernel nativa di macOS (mount_smbfs): su macOS, SambaMounter di ATBCmder sfrutta il sottosistema /sbin/mount_smbfs nativo di Apple. Monta la condivisione remota direttamente nell'albero VFS di macOS (/Volumes/ o una directory di montaggio isolata), sbloccando il throughput di lettura/scrittura SMB3 completo con accelerazione hardware.
• Rilevamento montaggio esistente: se macOS Finder o uno script di sistema ha già montato la condivisione SMB di destinazione, ATBCmder rileva automaticamente il punto di montaggio attivo dalla tabella mount del sistema operativo e vi accede immediatamente, evitando connessioni di rete ridondanti.

WebDAV e WebDAVS (Nextcloud/Archiviazione sul cloud)¶

Basato su webdavclient3, questo driver fornisce la sincronizzazione bidirezionale dei file con le moderne soluzioni di archiviazione cloud:

• Verifica del certificato SSL: supporta la rigorosa convalida del certificato SSL per host WebDAVS pubblici, con un'attivazione/disattivazione dell'override per i certificati autofirmati nelle configurazioni di laboratori domestici privati.
• Creazione di directory ricorsiva (makedirs): crea automaticamente percorsi di directory remote nidificate mancanti durante le operazioni di caricamento in blocco.

6.3 Archiviazione cloud Google Drive: Guida passo-passo alla configurazione¶

La gestione di Google Drive tramite un browser Web risulta spesso lenta quando si caricano file di grandi dimensioni o si organizzano cartelle nidificate. Inoltre, l'applicazione desktop ufficiale di Google Drive tenta in genere di sincronizzare interi alberi di cartelle sull'SSD locale del Mac, consumando spazio prezioso.

ATBCmder risolve questo problema trattando Google Drive come un'unità virtuale attiva (gdrive://). Puoi sfogliare le cartelle remote direttamente nell'interfaccia a doppio pannello, visualizzare in anteprima i file con F3 e copiare i file con F5 tra il Mac e Google Drive — senza scaricare l'intero archivio cloud sul computer.

Figura 6.5: Connessione a Google Drive tramite Gestione connessioni con credenziali client OAuth2 ed esplorazione dei file cloud accanto alle cartelle locali nella vista a doppio pannello.

Perché ho bisogno di un "Client ID" e di un "Client Secret"?¶

Per proteggere la tua privacy e sicurezza, Google non consente alle app desktop di terze parti di richiedere direttamente la password del tuo account Google. Viene invece utilizzata l'autorizzazione ufficiale OAuth 2.0.

Creando le tue credenziali OAuth gratuite nella console di Google Cloud:

• 100% privato e diretto: I dati viaggiano direttamente tra il Mac e i server ufficiali di Google. Nessun server di terze parti o intermediario vede mai i tuoi file o le tue chiavi.
• Velocità e quote dedicate: Ottieni la tua larghezza di banda API privata senza condividere limiti di frequenza con altri utenti.
• Revocabile in qualsiasi momento: Mantieni il controllo totale. Puoi revocare l'accesso di ATBCmder con un solo clic nella dashboard di sicurezza del tuo account Google.

La configurazione richiede meno di 3 minuti e deve essere eseguita solo una volta!

Passaggio 1: Creare credenziali gratuite in Google Cloud (Richiede 2 minuti)¶

1. Apri Google Cloud Console — Credenziali nel browser Web e accedi con il tuo account Google.
2. Seleziona o crea un progetto:
3. Nella parte superiore della pagina, fai clic sul menu a discesa dell'organizzazione / progetto.
4. (Suggerimento per le organizzazioni: se disponi di un'organizzazione Google Workspace o Cloud Identity come aitobox.com, selezionala per creare il progetto sotto il tuo dominio).
5. Se non hai ancora un progetto, fai clic su Nuovo progetto, assegnagli un nome (ad es. ATBCmder) e fai clic su Crea.
6. Abilita l'API Google Drive:
7. Nella barra laterale sinistra o nella barra di ricerca superiore, vai su API e servizi abilitati (o fai clic su + ABILITA API E SERVIZI).
8. Cerca Google Drive API, fai clic su di essa e premi il pulsante blu Abilita.
9. Configura la schermata di consenso OAuth (se richiesto):
10. Se è la prima volta che crei delle credenziali, Google potrebbe chiederti di configurare la schermata di consenso:
    • Seleziona Esterno (External) e fai clic su Crea.
    • Inserisci un Nome app (ad es. ATBCmder) e inserisci il tuo indirizzo email di supporto e contatto sviluppatore.
    • In Dominio app, imposta la Home page dell'applicazione sul tuo sito (ad es. https://cmder.aitobox.com).
    • In Domini autorizzati, aggiungi il tuo dominio principale (ad es. aitobox.com).
    • Fai clic su Salva e continua nelle schermate successive.
11. Crea credenziali per applicazione desktop:
12. Torna a API e servizi ➔ Credenziali.
13. Fai clic su + Crea credenziali in alto e scegli ID client OAuth.
14. Nel menu a discesa Tipo di applicazione, seleziona App desktop (Desktop app).
15. Nel campo Nome, inserisci ATBCmder Desktop (o qualsiasi nome descrittivo).
16. Fai clic su Crea.
17. Copia le tue chiavi:
18. Apparirà una finestra di dialogo con il tuo ID client (che termina con .apps.googleusercontent.com) e il tuo Client Secret.
19. Copia entrambe le stringhe (o mantieni aperta la scheda del browser).

Branding personalizzato: Comprendere "Accesso concesso a" (Access Granted To)¶

Quando visualizzi le applicazioni di terze parti collegate nel centro di sicurezza del tuo account Google (myaccount.google.com/connections), Google mostra una scheda dettagliata per ATBCmder:

• Nome app: ATBCmder
• Accesso concesso a (Access granted to): ad es. aitobox.com o oplist.org
• Home page: https://cmder.aitobox.com

Perché Google mostra un nome di organizzazione specifico?¶

La riga "Accesso concesso a" (Access granted to) viene determinata automaticamente da Google in base all'organizzazione Google Cloud (o all'account Google Workspace) proprietaria del progetto GCP in cui è stato creato l'ID client OAuth:

• Se l'ID client è stato creato in un progetto GCP di un'organizzazione terza (come oplist.org), Google mostrerà quel dominio per avvisare l'utente dell'appartenenza del client API.
• Se il progetto è stato creato con un account Google personale, Google mostrerà l'identità di contatto dello sviluppatore.

Come impostare l'organizzazione sul proprio dominio (es. aitobox.com)¶

Se desideri che la dashboard di sicurezza di Google mostri il dominio personalizzato della tua azienda (come aitobox.com):

1. Crea il progetto nell'organizzazione del tuo dominio:
2. Accedi a Google Cloud Console con un account del tuo dominio (ad es. admin@aitobox.com).
3. Assicurati che nel selettore in alto sia selezionato il dominio aziendale prima di creare il progetto.
4. Configura il dominio dell'app nella schermata di consenso OAuth:
5. Vai su API e servizi ➔ Schermata di consenso OAuth.
6. Imposta la Home page dell'applicazione con la pagina ufficiale del prodotto (ad es. https://cmder.aitobox.com).
7. Registra il tuo dominio principale nei Domini autorizzati (ad es. aitobox.com).
8. Imposta l'email di supporto sul tuo dominio.
9. Genera un nuovo ID client per app desktop:
10. Vai su API e servizi ➔ Credenziali e crea un nuovo ID client OAuth di tipo App desktop.
11. Aggiorna le chiavi in ATBCmder:
12. Incolla il nuovo Client ID e il Client Secret nella Gestione connessioni di ATBCmder e fai clic su Riautorizza....
13. Google mostrerà ora il dominio aziendale (aitobox.com) come destinatario autorizzato!

Passaggio 2: Aggiungere Google Drive in ATBCmder¶

Una volta ottenute le chiavi, l'aggiunta in ATBCmder richiede solo pochi clic:

1. Nella barra dei menu di ATBCmder, apri Rete ➔ Gestisci connessioni... (o premi cm_ManageConnections).
2. Fai clic sul pulsante + Nuovo nell'angolo in basso a sinistra.
3. Nel modulo Dettagli connessione a destra:
4. Etichetta: Inserisci un nome intuitivo (ad es. Il mio Google Drive o Drive Lavoro).
5. Protocollo: Seleziona gdrive dal menu a discesa.
6. ID client: Incolla il Client ID copiato da Google Cloud.
7. Client Secret: Incolla il Client Secret copiato da Google Cloud.
8. (Suggerimento: puoi fare clic sul collegamento blu Create OAuth 2.0 credentials in Google Cloud Console per aprire la console in qualsiasi momento).
9. Fai clic sul pulsante Autorizza (o Riautorizza...):
10. ATBCmder aprirà automaticamente il browser predefinito sulla pagina di accesso ufficiale di Google.
11. Avviso di sicurezza importante (Assolutamente normale e previsto):
    Poiché stai utilizzando un Client ID privato creato nel tuo progetto Google Cloud personale anziché un'app commerciale del marketplace, Google visualizzerà una schermata di avviso: «Google non ha verificato questa app» / «Rischio per la sicurezza».
    È un comportamento del tutto normale e sicuro. Nel browser, espandi le opzioni (fai clic su Avanzate / Advanced) e seleziona «Apri l'app (non sicuro) / Continua».
12. Seleziona il tuo account Google e conferma i permessi richiesti (lettura e scrittura su Google Drive).
13. Fai clic su Continua / Consenti.
14. Una volta approvato, il browser confermerà il successo. Tornando ad ATBCmder, lo stato si aggiornerà in:
    ✓ Authorized (your_account@gmail.com)!

1. Fai clic su 💾 Salva per memorizzare la connessione, quindi premi 🔗 Connetti (o fai doppio clic sulla voce nell'elenco a sinistra).
2. Si aprirà immediatamente una nuova scheda nel pannello attivo con il percorso:

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

   Tutti i tuoi file e le tue cartelle di Google Drive saranno a tua disposizione!

Passaggio 3: Utilizzare Google Drive come un'unità locale¶

Una volta connesso, Google Drive si comporta esattamente come una normale cartella locale:

• Esplorazione e anteprima istantanea: Fai doppio clic o premi Invio per aprire le cartelle. Seleziona qualsiasi immagine, PDF, file di codice o documento e premi F3 per aprirlo immediatamente nel visualizzatore universale in streaming, senza salvarlo prima sul disco.
• Caricamento sul cloud (F5): Seleziona i file nel pannello locale (ad es. la cartella Download) e premi F5 per caricarli direttamente nella directory remota di Google Drive.
• Download sul computer (F5): Seleziona i file nel pannello di Google Drive e premi F5 per scaricarli nella cartella di destinazione locale.
• Trascina e rilascia (Drag & Drop): Trascina liberamente file e cartelle con il mouse tra il pannello locale e il pannello di Google Drive.
• Aggiornamento istantaneo (F9 / Ctrl+R): Se un collega condivide un nuovo file o effettui modifiche dallo smartphone, premi F9 per sincronizzare all'istante le ultime novità.
• Indicatore quota di spazio in tempo reale: La capsula di stato nella barra degli strumenti in alto a destra mostra lo spazio residuo su Google Drive (ad es. 259.7 GB free of 994.7 GB).
• Gestione account multipli: Puoi registrare più profili Google Drive in Gestione connessioni (ad es. Drive Personale e Drive Lavoro) e trasferire file direttamente aprendone uno nel pannello sinistro e l'altro nel pannello destro!
• Protezione hardware con Secure Enclave: Le chiavi segrete e i token OAuth vengono memorizzati in modo crittografato direttamente nel Portachiavi di sistema macOS (ATBCmder_VFS) protetto dal Secure Enclave di Apple.

6.4 Archiviazione cloud Dropbox: Guida passo-passo alla configurazione¶

Proprio come per Google Drive, accedere direttamente a Dropbox in ATBCmder ti consente di esplorare e organizzare i tuoi dati cloud senza dover sincronizzare centinaia di gigabyte sull'SSD locale del Mac.

ATBCmder gestisce Dropbox come un'unità virtuale attiva (dropbox://), consentendo anteprime con F3, trasferimenti a blocchi in streaming con F5 e il monitoraggio della quota cloud in tempo reale nella barra degli strumenti.

Perché ho bisogno di una "App Key" e di un "App Secret"?¶

Per proteggere la tua privacy e la sicurezza dell'account, Dropbox non consente agli strumenti desktop di richiedere o memorizzare la password del tuo account Dropbox. Tutte le autorizzazioni passano per OAuth 2.0.

Creando le tue App Key e App Secret gratuite nella Dropbox App Console:

• 100% privato e diretto: I dati viaggiano direttamente tra il tuo Mac e i server ufficiali di Dropbox, senza passare per server intermedi.
• Velocità e quote dedicate: Ottieni la tua larghezza di banda API privata senza condividere limiti con altri utenti.
• Revocabile in qualsiasi momento: Mantieni il pieno controllo. Puoi revocare i permessi in qualsiasi momento nelle impostazioni di sicurezza di Dropbox.

La configurazione richiede meno di 2 minuti ed è valida per sempre!

Passaggio 1: Creare un'app nella Dropbox App Console¶

1. Apri Dropbox App Console nel browser e accedi con il tuo account Dropbox.
2. Fai clic sul pulsante blu Create app nell'angolo in alto a destra.
3. Configura le impostazioni dell'applicazione come mostrato nello screenshot seguente:

Figura 6.6: Creazione di una nuova applicazione nella Dropbox App Console con Scoped access e accesso Full Dropbox.

• 1. Choose an API: Seleziona Scoped access.
• 2. Choose the type of access you need: Seleziona Full Dropbox (Accesso a tutti i file e le cartelle nel tuo Dropbox).
  (Nota: se desideri che ATBCmder acceda solo a una cartella isolata, puoi scegliere "App folder").
• 3. Name your app: Inserisci un nome univoco (ad es. ATBCmder o ATBCmder-TuoNome).
• Seleziona la casella I agree to Dropbox API Terms and Conditions.
• Fai clic sul pulsante blu Create app in basso a destra.

Passaggio 2: Configurare l'URI di reindirizzamento e copiare le chiavi (Scheda Settings)¶

Una volta creata l'app, verrai reindirizzato alla dashboard. Fai clic sulla scheda Settings in alto.

Figura 6.7: Configurazione dell'URI di reindirizzamento locale (http://127.0.0.1:53682/callback) e copia di App key e App secret.

1. Imposta l'URI di reindirizzamento OAuth 2:
2. Scorri verso il basso fino alla sezione OAuth 2.
3. Individua il campo Redirect URIs.

4. Incolla il seguente URL esatto:

   http://127.0.0.1:53682/callback
   

5. Fai clic sul pulsante Add accanto al campo.
   (Spiegazione: durante l'autorizzazione, ATBCmder avvia un listener di loopback locale sicuro sulla porta 53682. La registrazione di questo URI consente a Dropbox di restituire l'autorizzazione ad ATBCmder in un clic).

6. Consenti client pubblici (PKCE):
7. Assicurati che l'opzione Allow public clients (Implicit Grant & PKCE) sia impostata su Allow (o valore predefinito).
8. Copia la tua App Key e App Secret:
9. Nella parte superiore della scheda Settings, individua App key e copiala.
10. Subito sotto, individua App secret, fai clic sul link Show e copia la chiave segreta.
    (Conserva la finestra aperta o salva temporaneamente le chiavi).

Passaggio 3: Configurare i permessi richiesti (Scheda Permissions)¶

Fai clic sulla scheda Permissions nella parte superiore della pagina delle impostazioni dell'app.

Figura 6.8: Selezione delle autorizzazioni richieste nella scheda Permissions, inclusi files.metadata.read/write e files.content.read/write.

1. In Account Info:
2. account_info.read: Visualizza le informazioni di base sull'account Dropbox (abilitato per impostazione predefinita, consente di visualizzare l'email dell'account).
3. In Files and folders, assicurati che siano selezionate le seguenti caselle:
4. files.metadata.write: Visualizza e modifica le informazioni sui tuoi file e cartelle Dropbox.
5. files.content.write: Modifica il contenuto dei tuoi file e cartelle Dropbox (caricamento e modifica file).
6. files.content.read: Visualizza il contenuto dei tuoi file e cartelle Dropbox (download e visualizzazione file).

Passaggio 4: Aggiungere Dropbox in ATBCmder e autorizzare in un clic¶

Una volta configurata l'app Dropbox, l'integrazione in ATBCmder richiede pochissimi passaggi:

1. Nella barra dei menu di ATBCmder, apri Rete ➔ Gestisci connessioni... (o premi cm_ManageConnections).
2. Fai clic sul pulsante + Nuovo in basso a sinistra.
3. Nel modulo Dettagli connessione a destra:
4. Etichetta: Inserisci un nome (ad es. Il mio Dropbox o Dropbox Team).
5. Protocollo: Scegli dropbox dal menu a discesa.
6. App Key: Incolla l'App key copiata dalla scheda Settings.
7. App Secret: Incolla l'App secret copiato dalla scheda Settings.
8. (Suggerimento: puoi fare clic sul collegamento di supporto per aprire la console di Dropbox in qualsiasi momento).
9. Fai clic sul pulsante Accedi tramite browser... (o Autorizza):
10. ATBCmder aprirà automaticamente il browser sulla pagina di consenso di Dropbox.
11. Verifica i permessi richiesti e fai clic su Consenti (Allow).
12. Una volta approvato, il browser confermerà il successo. In ATBCmder lo stato diventerà:
    ✓ Authorized (your_account@email.com)!
13. Fai clic su 💾 Salva e poi su 🔗 Connetti (o fai doppio clic sulla voce nell'elenco a sinistra).
14. Si aprirà immediatamente una nuova scheda nel pannello attivo con l'indirizzo:

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

    Tutti i tuoi file e cartelle di Dropbox saranno visibili all'istante!

Risoluzione dei problemi comuni¶

Passaggio 5: Utilizzare Dropbox come un'unità locale¶

Una volta connesso, Dropbox risponde con la rapidità di un'unità locale:

• Copia a doppio pannello (F5): Seleziona i file nel pannello locale (ad es. Documenti o Download) e premi F5 per caricarli direttamente su Dropbox; oppure seleziona i file remoti e premi F5 per scaricarli.
• Trasferimenti a blocchi in streaming: Le sessioni di streaming non bloccanti con indicatore di avanzamento in tempo reale consentono di trasferire file video o archivi compressi di vari gigabyte senza sovraccaricare la memoria.
• Anteprima immediata (F3): Seleziona immagini, PDF, file Markdown o file di testo su Dropbox e premi F3 per aprirli nel visualizzatore universale senza salvarli prima sul disco.
• Creazione cartelle remote (F7): Premi F7 per creare nuove directory remote, con creazione automatica ricorsiva delle cartelle superiori.
• Trascina e rilascia (Drag & Drop): Sposta file e cartelle direttamente tra i pannelli con il mouse.
• Misuratore di capacità in tempo reale: Lo spazio disponibile su Dropbox è sempre visibile nella barra degli strumenti in alto a destra (ad es. 1.8 GB free of 2.0 GB).
• Aggiornamento istantaneo (F9 / Ctrl+R): Recupera in un istante le modifiche apportate su altri dispositivi con la semplice pressione di un tasto.
• Sicurezza hardware con Secure Enclave: Credenziali e token OAuth vengono memorizzati in modo crittografato direttamente nel Portachiavi di sistema macOS (ATBCmder_VFS) protetto dal Secure Enclave di Apple.

6.3 Archiviazione sandbox sul cloud dell'App Store (OneDrive, Google Drive, iCloud)¶

Nelle build sandbox di ATBCmder del Mac App Store, l'accesso diretto del filesystem alle directory di sincronizzazione cloud di terze parti (ad esempio, Microsoft OneDrive, Google Drive per desktop, Dropbox e iCloud Drive) è regolato dall'architettura sandbox di Apple:

• Segnalibri con ambito di sicurezza: le directory cloud sincronizzate che risiedono in ~/Library/CloudStorage/OneDrive-*, ~/Library/CloudStorage/GoogleDrive-* o ~/Library/Mobile Documents/com~apple~CloudDocs/ richiedono token di accesso con ambito di sicurezza.
• Switcher di unità e integrazione del percorso: ATBCmder rileva automaticamente le directory cloud locali configurate e le mostra nello Switcher di unità (Alt+D / ⌥D), nelle barre dei pulsanti delle unità e nei breadcrumb del percorso.
• Concessioni di autorizzazioni persistenti: quando si apre una directory cloud per la prima volta, macOS presenta un foglio di autorizzazione. Una volta selezionato, ATBCmder memorizza il segnalibro con ambito di sicurezza crittografica nelle preferenze dell'utente, garantendo un accesso in lettura/scrittura continuo e ininterrotto durante i riavvii dell'applicazione senza ripetute finestre di dialogo di autorizzazione.

7. Connessione rapida e Gestione connessione¶

ATBCmder fornisce due meccanismi flessibili per la connessione a host remoti: Quick Connect per sessioni temporanee veloci e Connection Manager per segnalibri server persistenti e categorizzati.

7.1 Connessione rapida (cm_NetworkConnect)¶

Quando devi accedere rapidamente a un server senza ingombrare la tua configurazione permanente:

1. Scegli Rete ➔ Connessione rapida... (o esegui il comando cm_NetworkConnect).
2. Viene visualizzata la richiesta di connessione leggera:
3. Protocollo: Selezionare sftp, ftp, ftps, smb, webdav, webdavs, gdrive o dropbox.
4. Host e porta: inserisci l'indirizzo del server (la porta compila automaticamente i valori predefiniti).
5. Nome utente e password: inserisci le credenziali di connessione.
6. Percorso remoto: avvio della directory remota (impostazione predefinita: /).
7. Ricorda password: lascia deselezionato per una connessione temporanea a sessione singola.
8. Fare clic su Verifica connessione per verificare l'handshake e le credenziali della rete prima della connessione.
9. Fare clic su Connetti. ATBCmder apre immediatamente una nuova scheda nel pannello attivo che punta al server remoto.

7.2 Gestore connessione (cm_ManageConnections)¶

Per i server a cui accedi regolarmente, Connection Manager fornisce un dashboard di configurazione 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] │
└──────────────────────────────┴─────────────────────────────────────────────────────────┘

Gestione dei profili del server¶

• Crea nuovo (➕ New): cancella il modulo a destra per definire una nuova configurazione del server.
• Duplica (⧉ Duplicate): clona il profilo di connessione selezionato. Ideale quando si gestiscono più ambienti (sviluppo, staging, produzione) su configurazioni host identiche.
• Elimina (🗑 Delete): rimuove il profilo di connessione ed elimina le credenziali associate dal portachiavi di sistema.
• Test connessione (🔍 Test Connection): invia un operatore in background (ConnectionTestWorker) per connettersi, autenticarsi e disconnettersi correttamente, verificando la reattività del server senza allontanarsi.
• Connetti (🔗 Connect): salva eventuali modifiche ai campi in sospeso, stabilisce la sessione remota e carica la directory remota in una nuova scheda del pannello attivo.

Menu Connessioni salvate dinamiche¶

Le connessioni salvate vengono automaticamente integrate nella barra dei menu in alto in Rete ➔ Connessioni salvate. Puoi montare qualsiasi server con segnalibro con un solo clic:

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

8. Sicurezza delle credenziali e integrazione del portachiavi¶

I file di configurazione del file manager sono un obiettivo primario per il malware di raccolta delle credenziali. Molti file manager legacy memorizzano le password FTP/SFTP in file di configurazione XML o INI in testo semplice situati nella directory home dell'utente.

ATBCmder garantisce zero archiviazione di credenziali in chiaro.

8.1 L'architettura di sicurezza¶

┌────────────────────────────────────────────────────────────────────────────────────────┐
│                           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. Scrubbing XML in chiaro: ogni volta che i profili di connessione vengono serializzati sul disco (atbcmder.xml), la routine ConnectionManager.save() forza esplicitamente d["password"] = "" prima della scrittura. Anche se una parte non autorizzata controlla l'XML di configurazione, nessuna password del server verrà mai rivelata.
2. Crittografia portachiavi di sistema macOS: quando la casella di controllo Ricorda password è selezionata, le password vengono salvate direttamente nel portachiavi macOS tramite l'API di sistema keyring con l'identificatore del servizio sicuro ATBCmder_VFS. La derivazione e l'archiviazione delle chiavi sono protette dall'hardware Secure Enclave di Apple.
3. Sessioni in memoria temporanee: se "Ricorda password" è deselezionato, le credenziali vengono conservate rigorosamente nella memoria dinamica (VFSSessionCache) durante il ciclo di vita dell'applicazione corrente e vengono cancellate nel momento in cui ATBCmder termina.

9. ⚡ Suggerimenti degli esperti: operazioni remote ad alte prestazioni¶

Suggerimento 1: coda di trasferimento in background non bloccante (cm_OperationsPanel)¶

Quando copi directory di grandi dimensioni su server remoti o scarichi ISO multi-gigabyte su SFTP, non bloccare mai il tuo spazio di lavoro. Tutte le operazioni sui file di rete in ATBCmder si integrano automaticamente con la Coda delle operazioni in background:

• Premi F5 per avviare un trasferimento, quindi fai clic su Sfondo (o lascialo in coda automaticamente).
• Apri il pannello delle operazioni tramite Mostra ➔ Pannello delle operazioni (cm_OperationsPanel) per monitorare i grafici della larghezza di banda in tempo reale, i conteggi di byte per file e le stime di trasferimento rimanenti.
• Puoi mettere in pausa, riprendere o riordinare i trasferimenti di rete in coda continuando a sfogliare i file locali in entrambi i pannelli.

Suggerimento 2: copiare in streaming su protocolli eterogenei¶

Il motore stream_copy_file di ATBCmder consente lo streaming diretto da server a server. Se trascini una cartella da un server SFTP nel pannello di sinistra a una condivisione di rete SMB nel pannello di destra:

• ATBCmder non scarica l'intera directory sul disco rigido del tuo Mac locale prima di ricaricarla.
• I dati vengono suddivisi in blocchi attraverso un anello buffer in memoria, trasmettendo byte dal socket di origine direttamente al socket di destinazione. Ciò elimina l'usura del disco locale e consente trasferimenti più grandi della capacità SSD locale disponibile.

Suggerimento 3: mantenimento della rete attiva e prevenzione delle interruzioni della connessione¶

I firewall di rete con stato e i gateway NAT spesso interrompono le connessioni TCP inattive dopo 60-300 secondi di inattività. Per evitare sessioni disconnesse durante l'esplorazione di grandi alberi remoti:

• Il livello BaseNetworkVFS di ATBCmder mantiene automaticamente gli heartbeat della sessione attraverso le connessioni inattive.
• Se si verifica un'interruzione temporanea della rete, il meccanismo interno _retry() esegue fino a 3 tentativi utilizzando il backoff esponenziale (intervalli di 2^attempt secondi) prima di segnalare un errore di connessione.

Suggerimento 4: modifica di file remoti con ciclo di vita di caricamento automatico¶

Hai bisogno di modificare uno script nginx.conf o Python direttamente su un server remoto?

1. Evidenziare il file remoto nella visualizzazione del pannello SFTP o WebDAV.
2. Premere F4 (Fn+F4).
3. ATBCmder scarica il file in un sandbox temporaneo isolato (/tmp/) e lo apre nell'editor integrato.
4. Ogni volta che si preme Cmd+S (⌘S), ATBCmder attiva _upload_vfs_temp(), trasmettendo il file aggiornato al server remoto in modo asincrono e visualizzando una conferma nella barra di stato.
5. Quando chiudi l'editor, il file temporaneo viene scollegato in modo sicuro da /tmp/.

10. Avvisi di sistema e sicurezza¶

11. Tabella di riferimento della tastiera master a doppia matrice¶