Sincronización desde la terminal
Utilice la interfaz de línea de comandos (CLI) de Sync-in para configurar y activar sincronizaciones entre sus archivos locales y servidores remotos. Esta interfaz también le permite administrar múltiples servidores, definir rutas de sincronización personalizadas y automatizar sus flujos de trabajo de transferencia.
Es ideal para usuarios avanzados, la automatización mediante scripts y los entornos sin interfaz gráfica.
Casos de uso
- Trabajar en entornos sin interfaz gráfica, como servidores o contenedores remotos.
- Programar sincronizaciones automáticas mediante tareas CRON o un planificador del sistema.
- Automatice los flujos de trabajo de su negocio integrando la CLI en scripts de procesamiento o respaldo.
- Probar sincronizaciones en modo simulación, usando las opciones
--reporty--debugpara identificar cambios sin aplicarlos o solucionar problemas. - Administra múltiples servidores, centralizando tus conexiones en una sola herramienta.
- Implementar configuraciones predefinidas, para instalaciones automatizadas en múltiples máquinas o entornos.
Requisitos de acceso
Para utilizar la CLI, se deben cumplir las siguientes condiciones:
- Debes tener habilitado el permiso de acceso al escritorio.
- Debes tener habilitado el permiso de sincronización.
- Node.js 22.x – 24.x debe estar instalado en el sistema.
- Debes descargar el binario de la CLI desde tu Cuenta o la página Descargas.
Inicio rápido
1. Agregar un servidor
./sync-in-cli servers add \
--name <MY_SERVER> \
--url https://<YOUR_DOMAIN> \
--login <YOUR_LOGIN> \
--password <YOUR_PASSWORD>
Si la autenticación de dos factores está habilitada, puede proporcionar el código TOTP o un código de recuperación usando la opción --code.
2. Agregue una ruta de sincronización
./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. Iniciar sincronización
./sync-in-cli run \
--server <MY_SERVER> \
--path <PATH_NAME>
Gestión
Una vez que la CLI está configurada y registrada con el servidor, tiene acceso a su cuenta.
Los detalles de conexión se pueden ver en el menú Clientes de su cuenta.
Puede revocar el acceso a la CLI en cualquier momento, independientemente de la estación de trabajo utilizada para la configuración.
Desde el mismo menú, también puede actualizar la configuración de sincronización de las rutas administradas por CLI.
Los cambios se aplicarán la próxima vez que se inicie una sincronización.
Seguridad
Después de un cierto período, es posible que se le solicite volver a autenticarse para renovar de forma segura el acceso a su cuenta.
Para realizar esta operación, consulte el comando de reautenticación.
Notas
A diferencia de la aplicación de escritorio, los archivos eliminados localmente (en la estación de trabajo) no se mueven a la papelera.
Comandos
| Comando | Descripción |
|---|---|
--help | Muestra ayuda general |
--version | Muestra la versión CLI |
run | Activa sincronizaciones (consulte las opciones a continuación) |
servers | Gestiona servidores registrados |
paths | Gestiona rutas de sincronización |
run Comando
run – Iniciar una sincronización
Inicia manualmente una sincronización desde la línea de comando.
Puede sincronizar todas las rutas configuradas o apuntar a servidores/rutas específicas.
Si no se especifican --server o --path, se seleccionarán todas las carpetas para la sincronización.
| Opción | Alias | Descripción | Requerido |
|---|---|---|---|
--report | -r | Modo de sólo lectura (dry-run), muestra diferencias sin aplicarlas | ❌ |
--debug | -d | Habilita registros detallados para la depuración | ❌ |
--async | -a | Ejecuta sincronizaciones en paralelo | ❌ |
--server | -s | ID o nombre del servidor a sincronizar | ❌ |
--path | -p | ID o nombre de las rutas para sincronizar (requiere --server) | ❌ |
servers Comandos
| Subcomando | Alias | Descripción |
|---|---|---|
list | ls | Listar todos los servidores registrados |
add | mk | Agregar un nuevo servidor |
remove | rm | Eliminar un servidor registrado |
auth | touch | Volver a autenticar (actualizar token de acceso) |
add (alias: mk)
Agrega y registra un servidor remoto para usarlo con la CLI.
| Opción | Alias | Descripción | Requerido |
|---|---|---|---|
--name | -n | Nombre personalizado para identificar el servidor | ✅ |
--url | --web | URL del servidor (por ejemplo, https://my.sync-in.com) | ✅ |
--login | -u | Inicio de sesión de usuario o correo electrónico | ✅ |
--password | -p | Contraseña de usuario | ✅ |
--code | -c | Código de autenticación de dos factores (2FA) o código de recuperación | ❌ |
remove (alias: rm)
Elimina un servidor registrado.
| Opción | Alias | Descripción | Requerido |
|---|---|---|---|
--server | -s | ID o nombre del servidor | ✅ |
auth (alias: touch)
Actualiza el token de acceso de un servidor registrado.
| Opción | Alias | Descripción | Requerido |
|---|---|---|---|
--server | -s | ID o nombre del servidor | ✅ |
--login | -u | Inicio de sesión de usuario o correo electrónico | ✅ |
--password | -p | Contraseña de usuario | ✅ |
--code | -c | Código de autenticación de dos factores (2FA) o código de recuperación | ❌ |
paths Comandos
| Subcomando | Alias | Descripción |
|---|---|---|
list | ls | Listar rutas de sincronización por servidor |
add | mk | Agregar una nueva ruta de sincronización local/remota |
set | vi | Editar opciones de sincronización para una ruta existente |
remove | rm | Eliminar una ruta de sincronización existente |
update | up | Actualizar rutas desde el servidor |
flush | reset | Borrar instantáneas anteriores de una ruta de sincronización |
add (alias: mk)
Agrega una nueva ruta de sincronización (local/remota).
| Opción | Alias | Descripción | Requerido | Valores | Predeterminado |
|---|---|---|---|---|---|
--server | -s | ID o nombre del servidor | ✅ | — | — |
--localPath | -l | Ruta al archivo o carpeta local | ✅ | — | — |
--remotePath | -r | Ruta remota (spaces, personal o shares) | ✅ | — | — |
--name | -n | Nombre de sincronización personalizado | ❌ | — | — |
--mode | -m | Modo de sincronización | ✅ | download, upload, both | — |
--diffMode | -d | Modo de detección de diferencias | ❌ | fast, secure | fast |
--conflictMode | -c | Estrategia de resolución de conflictos (si --mode both) | ❌ | recent, local, remote | recent |
set (alias: vi)
Modifica las opciones de sincronización para una ruta existente.
| Opción | Alias | Descripción | Requerido | Valores |
|---|---|---|---|---|
--server | -s | ID o nombre del servidor | ✅ | — |
--path | -p | ID o nombre de la ruta | ✅ | — |
--name | -n | Nuevo nombre de sincronización | ❌ | — |
--mode | -m | Modo de sincronización | ❌ | download, upload, both |
--diffMode | -d | Modo de detección de diferencias | ❌ | fast, secure |
--conflictMode | -c | Estrategia de resolución de conflictos (si el modo es ambos) | ❌ | recent, local, remote |
remove (alias: rm)
Elimina una ruta de sincronización existente.
| Opción | Alias | Descripción | Requerido |
|---|---|---|---|
--server | -s | ID o nombre del servidor | ✅ |
--path | -p | ID o nombre de la ruta | ✅ |
update (alias: up)
Actualiza todas las rutas configuradas en un servidor.
| Opción | Alias | Descripción | Requerido |
|---|---|---|---|
--server | -s | ID o nombre del servidor | ✅ |
flush (alias: reset)
Borra las instantáneas (estados anteriores) de una ruta.
| Opción | Alias | Descripción | Requerido |
|---|---|---|---|
--server | -s | ID o nombre del servidor | ✅ |
--path | -p | ID o nombre de la ruta | ✅ |