Sincronizzazione tramite terminale
Utilizza l'interfaccia a riga di comando (CLI) di Sync-in per configurare e avviare le sincronizzazioni tra i file locali e i server remoti. Questa interfaccia consente inoltre di gestire più server, definire percorsi di sincronizzazione personalizzati e automatizzare i flussi di trasferimento.
È ideale per gli utenti esperti, gli script e gli ambienti privi di interfaccia grafica.
Casi d'uso
- Lavorare in ambienti headless, come server remoti o container.
- Pianificare sincronizzazioni automatiche mediante attività CRON o uno scheduler di sistema.
- Automatizzare i flussi di lavoro aziendali integrando la CLI negli script di elaborazione o di backup.
- Provare le sincronizzazioni in modalità simulazione, utilizzando le opzioni
--reporte--debugper individuare le modifiche senza applicarle oppure per risolvere eventuali problemi. - Gestire più server, centralizzando le connessioni in un unico strumento.
- Distribuire configurazioni predefinite per automatizzare le installazioni su più computer o ambienti.
Requisiti di accesso
Per utilizzare la CLI devono essere soddisfatte le condizioni seguenti:
- Deve essere attiva l'autorizzazione di accesso desktop.
- Deve essere attiva l'autorizzazione di sincronizzazione.
- Nel sistema deve essere installato Node.js 22.x – 24.x.
- Occorre scaricare il programma della CLI dal proprio Account o dalla pagina Download.
Avvio rapido
1. Aggiungere un server
./sync-in-cli servers add \
--name <MY_SERVER> \
--url https://<YOUR_DOMAIN> \
--login <YOUR_LOGIN> \
--password <YOUR_PASSWORD>
Se è attiva l'autenticazione a due fattori, puoi fornire il codice TOTP o un codice di recupero mediante l'opzione --code.
2. Aggiungere un percorso di sincronizzazione
./sync-in-cli paths add \
--server <MY_SERVER> \
--localPath </local/path/to/files> \
--remotePath <personal|spaces|shares/...> \
--name <PATH_NAME> \
--mode <both|upload|download> \
--diffMode <fast|secure> \
--conflictMode <recent|local|remote>
3. Avviare la sincronizzazione
./sync-in-cli run \
--server <MY_SERVER> \
--path <PATH_NAME>
Gestione
Dopo essere stata configurata e registrata sul server, la CLI ottiene l'accesso al tuo account.
I dettagli della connessione sono disponibili nel menu Client dell'account.
Puoi revocare l'accesso della CLI in qualsiasi momento, indipendentemente dalla postazione utilizzata per la configurazione.
Dallo stesso menu puoi inoltre aggiornare la configurazione di sincronizzazione dei percorsi gestiti dalla CLI.
Le modifiche verranno applicate al successivo avvio di una sincronizzazione.
Sicurezza
Dopo un determinato periodo può essere richiesta una nuova autenticazione per rinnovare in modo sicuro l'accesso all'account.
Per eseguire questa operazione, consulta il comando di nuova autenticazione.
Note
A differenza dell'applicazione desktop, i file eliminati localmente sulla postazione di lavoro non vengono spostati nel cestino.
Comandi
| Comando | Descrizione |
|---|---|
--help | Mostra la guida generale |
--version | Mostra la versione della CLI |
run | Avvia le sincronizzazioni; vedi le opzioni |
servers | Gestisce i server registrati |
paths | Gestisce i percorsi di sincronizzazione |
Comando run
run – Avviare una sincronizzazione
Avvia manualmente una sincronizzazione dalla riga di comando.
Puoi sincronizzare tutti i percorsi configurati oppure selezionare server o percorsi specifici.
Se --server o --path non sono specificati, tutte le cartelle vengono selezionate per la sincronizzazione.
| Opzione | Alias | Descrizione | Obbligatoria |
|---|---|---|---|
--report | -r | Modalità di sola lettura (dry run); mostra le differenze senza applicarle | ❌ |
--debug | -d | Attiva i log dettagliati per il debug | ❌ |
--async | -a | Esegue le sincronizzazioni in parallelo | ❌ |
--server | -s | ID o nome del server da sincronizzare | ❌ |
--path | -p | ID o nomi dei percorsi da sincronizzare; richiede --server | ❌ |
Comandi servers
| Sottocomando | Alias | Descrizione |
|---|---|---|
list | ls | Elenca tutti i server registrati |
add | mk | Aggiunge un nuovo server |
remove | rm | Rimuove un server registrato |
auth | touch | Esegue nuovamente l'autenticazione e rinnova il token di accesso |
add (alias: mk)
Aggiunge e registra un server remoto da utilizzare con la CLI.
| Opzione | Alias | Descrizione | Obbligatoria |
|---|---|---|---|
--name | -n | Nome personalizzato che identifica il server | ✅ |
--url | --web | URL del server, ad esempio https://my.sync-in.com | ✅ |
--login | -u | Nome utente o indirizzo e-mail | ✅ |
--password | -p | Password dell'utente | ✅ |
--code | -c | Codice 2FA o codice di recupero | ❌ |
remove (alias: rm)
Rimuove un server registrato.
| Opzione | Alias | Descrizione | Obbligatoria |
|---|---|---|---|
--server | -s | ID o nome del server | ✅ |
auth (alias: touch)
Rinnova il token di accesso di un server registrato.
| Opzione | Alias | Descrizione | Obbligatoria |
|---|---|---|---|
--server | -s | ID o nome del server | ✅ |
--login | -u | Nome utente o indirizzo e-mail | ✅ |
--password | -p | Password dell'utente | ✅ |
--code | -c | Codice 2FA o codice di recupero | ❌ |
Comandi paths
| Sottocomando | Alias | Descrizione |
|---|---|---|
list | ls | Elenca i percorsi di sincronizzazione per server |
add | mk | Aggiunge un nuovo percorso di sincronizzazione locale/remoto |
set | vi | Modifica le opzioni di un percorso esistente |
remove | rm | Rimuove un percorso di sincronizzazione esistente |
update | up | Aggiorna i percorsi dal server |
flush | reset | Cancella le istantanee precedenti di un percorso |
add (alias: mk)
Aggiunge un nuovo percorso di sincronizzazione locale/remoto.
| Opzione | Alias | Descrizione | Obbligatoria | Valori | Predefinito |
|---|---|---|---|---|---|
--server | -s | ID o nome del server | ✅ | — | — |
--localPath | -l | Percorso del file o della cartella locale | ✅ | — | — |
--remotePath | -r | Percorso remoto (spaces, personal o shares) | ✅ | — | — |
--name | -n | Nome personalizzato della sincronizzazione | ❌ | — | — |
--mode | -m | Modalità di sincronizzazione | ✅ | download, upload, both | — |
--diffMode | -d | Modalità di rilevamento delle differenze | ❌ | fast, secure | fast |
--conflictMode | -c | Strategia di risoluzione dei conflitti con --mode both | ❌ | recent, local, remote | recent |
set (alias: vi)
Modifica le opzioni di sincronizzazione di un percorso esistente.
| Opzione | Alias | Descrizione | Obbligatoria | Valori |
|---|---|---|---|---|
--server | -s | ID o nome del server | ✅ | — |
--path | -p | ID o nome del percorso | ✅ | — |
--name | -n | Nuovo nome della sincronizzazione | ❌ | — |
--mode | -m | Modalità di sincronizzazione | ❌ | download, upload, both |
--diffMode | -d | Modalità di rilevamento delle differenze | ❌ | fast, secure |
--conflictMode | -c | Strategia di risoluzione dei conflitti se la modalità è both | ❌ | recent, local, remote |
remove (alias: rm)
Elimina un percorso di sincronizzazione esistente.
| Opzione | Alias | Descrizione | Obbligatoria |
|---|---|---|---|
--server | -s | ID o nome del server | ✅ |
--path | -p | ID o nome del percorso | ✅ |
update (alias: up)
Aggiorna tutti i percorsi configurati in un server.
| Opzione | Alias | Descrizione | Obbligatoria |
|---|---|---|---|
--server | -s | ID o nome del server | ✅ |
flush (alias: reset)
Cancella le istantanee, ossia gli stati precedenti, di un percorso.
| Opzione | Alias | Descrizione | Obbligatoria |
|---|---|---|---|
--server | -s | ID o nome del server | ✅ |
--path | -p | ID o nome del percorso | ✅ |