Desktop-Client
Die Qubix Drive Desktop-App bindet Ihre Qubix-Inhalte als lokales Laufwerk ein. Das
Laufwerk erscheint wie gewöhnliche Ordner und Dateien, und jede gespeicherte Änderung
wird direkt auf Ihren Qubix-Server zurückgeschrieben — so wie Google Drive für den
Desktop funktioniert. Sie können in VS Code, vim oder einem beliebigen Werkzeug
bearbeiten sowie Dateien mit cp, mv oder rsync kopieren.
Was sich auf dem Laufwerk befindet
Das eingebundene Laufwerk enthält drei Ordner auf oberster Ebene:
websites/— ein Ordner pro Website mit deren realem Dateibaum (index.html,static/…, Bilder). Beim Speichern einer Datei wird eine neue Version hochgeladen, und die Website behält ihren Verlauf — genau wie bei der Bearbeitung im Panel.scripts/— Ihre Automatisierungsskripte, jeweils als.js-Datei mit dem Skriptcode. Zeitplan, Ein-/Aus-Zustand und Beschreibung verbleiben im Panel.drive/— Ihre Drive-Ordner und -Seiten.
Sie sehen nur, was Ihr Konto sehen darf, und der Server entscheidet, was Sie ändern können — dieselben Zugriffsrechte wie im Panel.
1. FUSE-Treiber installieren
Die App präsentiert sich über eine Systemkomponente namens FUSE als Laufwerk. Installieren Sie zuerst die passende Variante für Ihr System:
- macOS — macFUSE
- Windows — WinFsp
- Linux — libfuse
Ohne diesen Treiber startet die App zwar, kann das Laufwerk jedoch nicht einbinden und meldet, dass der Treiber fehlt.
2. App herunterladen
Öffnen Sie die Seite Downloads im Panel und laden Sie Qubix Drive für Ihr System herunter.
Die App ist noch nicht von Apple notarisiert. Falls macOS sie beim ersten Start blockiert, erlauben Sie sie unter System Settings → Privacy & Security und öffnen Sie sie erneut.
3. Anmelden
Starten Sie die App mit dem Befehl login und geben Sie die Adresse Ihres Panels sowie
Ihre Konto-E-Mail-Adresse an. Sie werden nach Ihrem Passwort gefragt.
Als Adresse können Sie jeden Link einfügen, den Sie aus Ihrem Panel kopiert haben — nur
der Adressteil wird verwendet. Die Sitzung wird auf Ihrem Computer gespeichert, sodass
Sie sich nur einmal anmelden müssen. Sie können den Status jederzeit mit qubix-fs whoami
prüfen.
4. Laufwerk einbinden
macOS und Linux — geben Sie der App einen Ordner zum Einbinden an:
qubix-fs mount ~/QubixDrive
Das Laufwerk erscheint als Volume mit dem Namen Qubix.
Windows — führen Sie einfach qubix-fs mount aus; das Laufwerk erscheint als Q:\.
Lassen Sie den Befehl laufen — er hält das Laufwerk verbunden. Drücken Sie Ctrl-C oder
führen Sie qubix-fs unmount ~/QubixDrive aus, um die Verbindung zu trennen.
Arbeiten mit dem Laufwerk
Öffnen, bearbeiten und speichern Sie Dateien wie auf einem gewöhnlichen Laufwerk — jeder Speichervorgang wird an Ihren Server übertragen. Einige Dinge verhalten sich anders als bei einem einfachen lokalen Laufwerk:
- Skripte können nicht vom Laufwerk gelöscht werden. Damit Sie keine laufende Automatisierung versehentlich entfernen, wird das Löschen einer Skriptdatei verweigert — entfernen Sie Skripte stattdessen im Panel. Website-Dateien können gelöscht werden (ihr Verlauf bleibt erhalten).
- In jedem Ordner darf nur der passende Dateityp hinzugefügt werden. Neue Skripte
kommen unter
scripts/als.js-Dateien; neue Drive-Seiten unterdrive/. Neue Websites, Skripte oder Einträge auf oberster Ebene werden nicht einfach durch Anlegen eines Ordners im Stammverzeichnis erstellt. - Namen können einen kurzen Zusatz erhalten. Wenn zwei Einträge denselben Namen haben,
fügt die App einen kurzen Code in eckigen Klammern hinzu — zum Beispiel
My landing [a1b2c3d4]— damit jeder eindeutig ist. Der Code dient nur zur Unterscheidung. - Es gibt keinen Offline-Modus. Das Laufwerk ist eine Live-Ansicht Ihres Servers. Bricht die Verbindung ab, schlägt das Speichern fehl, bis sie wiederhergestellt ist — es wird nichts in einer Warteschlange gepuffert. Ein abgelehnter Speichervorgang (zum Beispiel ein Skript mit einem Syntaxfehler) lässt die gespeicherte Version unverändert.
- Der Zugriff wird vom Server durchgesetzt. Wenn Sie keine Berechtigung haben, etwas zu ändern, wird der Speichervorgang verweigert — dieselben Regeln wie im Panel.
Wenn Ihre Sitzung abläuft oder widerrufen wird, kann das Laufwerk den Server nicht mehr
erreichen, und die App fordert Sie auf, die Verbindung wiederherzustellen. Führen Sie den
Befehl login erneut aus, um sie zu restaurieren.