Client de bureau

L'application de bureau Qubix Drive monte votre contenu Qubix en tant que disque local. Ce disque ressemble à des dossiers et fichiers ordinaires, et chaque modification que vous enregistrez est écrite directement sur votre serveur Qubix — à la manière de Google Drive pour ordinateur. Cela vous permet d'éditer dans VS Code, vim, ou n'importe quel outil, et de copier des fichiers vers et depuis le disque avec cp, mv ou rsync.

Contenu du disque

Le disque monté contient trois dossiers de premier niveau :

• websites/ — un dossier par site, avec son arborescence réelle (index.html, static/…, images). L'enregistrement d'un fichier téléverse une nouvelle version et le site conserve son historique, exactement comme lors d'une édition dans le panneau.
• scripts/ — vos scripts d'automatisation, un fichier .js par script, contenant le code du script. La planification, l'état activé/désactivé et la description restent dans le panneau.
• drive/ — vos dossiers et pages Drive.

Vous ne voyez que ce que votre compte est autorisé à voir, et le serveur décide de ce que vous pouvez modifier — les mêmes droits d'accès que dans le panneau.

1. Installer le pilote FUSE

L'application se présente comme un disque via un composant système appelé FUSE. Installez celui correspondant à votre système en premier :

• macOS — macFUSE
• Windows — WinFsp
• Linux — libfuse

Sans ce pilote, l'application démarre mais ne peut pas monter le disque, et vous indique que le pilote est manquant.

2. Télécharger l'application

Ouvrez la page Téléchargements dans le panneau et téléchargez Qubix Drive pour votre système.

macOS

L'application n'est pas encore notarisée par Apple. Si macOS la bloque au premier lancement, autorisez-la dans Réglages du système → Confidentialité et sécurité, puis ouvrez-la à nouveau.

3. Se connecter

Lancez l'application avec la commande login, en indiquant l'adresse de votre panneau et l'adresse e-mail de votre compte. Votre mot de passe vous sera demandé.

Bash

qubix-fs login https://your-panel-address --email [email protected]

Pour l'adresse, vous pouvez coller n'importe quel lien copié depuis votre panneau — seule la partie adresse est utilisée. La session est enregistrée sur votre ordinateur, vous n'avez donc à vous connecter qu'une seule fois. Vérifiez-la à tout moment avec qubix-fs whoami.

4. Monter le disque

macOS et Linux — indiquez à l'application un dossier dans lequel monter le disque :

Bash

qubix-fs mount ~/QubixDrive

Le disque apparaît en tant que volume nommé Qubix.

Windows — exécutez simplement qubix-fs mount ; le disque apparaît sous Q:\.

Laissez la commande en cours d'exécution — elle maintient le disque connecté. Appuyez sur Ctrl-C, ou exécutez qubix-fs unmount ~/QubixDrive, pour vous déconnecter.

Utilisation du disque

Ouvrez, éditez et enregistrez les fichiers comme sur n'importe quel disque — chaque enregistrement est renvoyé vers votre serveur. Certains comportements diffèrent d'un disque local ordinaire :

• Les scripts ne peuvent pas être supprimés depuis le disque. Pour éviter de supprimer par accident une automatisation en production, la suppression d'un fichier script est refusée — supprimez les scripts depuis le panneau. Les fichiers de sites peuvent être supprimés (et leur historique est conservé).
• Seul le bon type de fichier peut être ajouté dans chaque dossier. Les nouveaux scripts doivent être placés sous scripts/ en tant que fichiers .js ; les nouvelles pages Drive sous drive/. Les nouveaux sites, scripts ou éléments de premier niveau ne sont pas créés simplement en créant un dossier à la racine.
• Les noms peuvent recevoir un suffixe court. Lorsque deux éléments partagent un nom, l'application ajoute un code court entre crochets — par exemple My landing [a1b2c3d4] — afin que chacun soit distinct. Ce code sert uniquement à les différencier.
• Il n'y a pas de mode hors ligne. Le disque est une vue en direct de votre serveur. Si la connexion est interrompue, l'enregistrement échoue jusqu'au rétablissement de la connexion — rien n'est mis en file d'attente. Un enregistrement refusé (par exemple un script contenant une erreur de syntaxe) laisse la version stockée intacte.
• Les accès sont contrôlés par le serveur. Si vous n'avez pas la permission de modifier quelque chose, l'enregistrement est refusé — les mêmes règles que dans le panneau.

Remarque

Si votre session expire ou est révoquée, le disque ne peut plus atteindre le serveur et l'application vous demande de vous reconnecter. Exécutez à nouveau la commande login pour la restaurer.

Étapes suivantes

Gérer les fichiers

Le même contenu dans le panneau du navigateur.

Téléchargements

Obtenez le client, l'extension et l'application mobile.

Sites web

Fonctionnement des fichiers et des versions de sites.