Cliente de escritorio
La aplicación de escritorio de Qubix Drive monta su contenido de Qubix como un disco local. El disco
aparece como carpetas y archivos ordinarios, y cada cambio que guarde se escribe
directamente en su servidor de Qubix, igual que funciona Google Drive para escritorio. Le
permite editar en VS Code, vim o cualquier herramienta, y copiar archivos con cp,
mv o rsync.
Qué contiene el disco
El disco montado tiene tres carpetas de nivel superior:
websites/— una carpeta por sitio, con su árbol de archivos real (index.html,static/…, imágenes). Al guardar un archivo se sube una nueva versión y el sitio conserva su historial, exactamente igual que al editar desde el panel.scripts/— sus scripts de automatización, un archivo.jspor cada uno, que contiene el código del script. La programación, el estado activado/desactivado y la descripción permanecen en el panel.drive/— sus carpetas y páginas de Drive.
Solo verá lo que su cuenta tiene permiso para ver, y el servidor determina qué puede modificar: el mismo acceso que en el panel.
1. Instalar el controlador FUSE
La aplicación se presenta como un disco a través de un componente del sistema llamado FUSE. Instale el correspondiente a su sistema primero:
- macOS — macFUSE
- Windows — WinFsp
- Linux — libfuse
Sin él, la aplicación se inicia pero no puede montar el disco, e indica que falta el controlador.
2. Descargar la aplicación
Abra la página Descargas en el panel y descargue Qubix Drive para su sistema.
La aplicación aún no está notarizada por Apple. Si macOS la bloquea al abrirla por primera vez, permítala en Configuración del sistema → Privacidad y seguridad, y vuelva a abrirla.
3. Iniciar sesión
Ejecute la aplicación con el comando login, indicando la dirección de su panel y el correo
electrónico de su cuenta. Se le pedirá su contraseña.
Como dirección puede pegar cualquier enlace copiado desde su panel; solo se utiliza la parte
de la dirección. La sesión se guarda en su equipo, por lo que solo necesita iniciar sesión una vez. Compruébelo
en cualquier momento con qubix-fs whoami.
4. Montar el disco
macOS y Linux — indique a la aplicación una carpeta donde montar:
qubix-fs mount ~/QubixDrive
El disco aparece como un volumen llamado Qubix.
Windows — simplemente ejecute qubix-fs mount; el disco aparece como Q:\.
Deje el comando en ejecución para mantener el disco conectado. Pulse Ctrl-C, o ejecute
qubix-fs unmount ~/QubixDrive, para desconectarlo.
Trabajar con el disco
Abra, edite y guarde archivos como lo haría en cualquier disco: cada guardado se envía a su servidor. Algunos comportamientos difieren de un disco local ordinario:
- Los scripts no pueden eliminarse desde el disco. Para evitar que elimine accidentalmente una automatización activa, se rechaza la eliminación de archivos de script; elimine los scripts desde el panel en su lugar. Los archivos de sitio sí pueden eliminarse (y su historial se conserva).
- Solo puede añadir el tipo de archivo adecuado en cada carpeta. Los nuevos scripts van en
scripts/como archivos.js; las nuevas páginas de Drive van endrive/. Los nuevos sitios, scripts o elementos de nivel superior no se crean simplemente creando una carpeta en la raíz. - Los nombres pueden llevar un sufijo breve. Cuando dos elementos comparten nombre, la aplicación añade un
código corto entre corchetes, por ejemplo
Mi landing [a1b2c3d4], para distinguirlos. El código sirve únicamente para diferenciarlos. - No hay modo sin conexión. El disco es una vista en tiempo real de su servidor. Si se pierde la conexión, el guardado falla hasta que se restablezca; nada queda en cola. Un guardado rechazado (por ejemplo, un script con un error de sintaxis) deja la versión almacenada intacta.
- El acceso lo controla el servidor. Si no tiene permiso para modificar algo, el guardado se rechaza; las mismas reglas que en el panel.
Si su sesión caduca o es revocada, el disco ya no puede comunicarse con el servidor y
la aplicación le indica que vuelva a conectarse. Ejecute el comando login de nuevo para restaurarla.