Klient desktopowy
Aplikacja desktopowa Qubix Drive montuje zawartość Qubix jako dysk lokalny. Dysk
wygląda jak zwykłe foldery i pliki, a każda zapisana zmiana jest natychmiast
przesyłana z powrotem na serwer Qubix — podobnie jak działa Google Drive na
komputerze. Umożliwia edycję w VS Code, vim lub dowolnym innym narzędziu oraz
kopiowanie plików za pomocą cp, mv lub rsync.
Co znajduje się na dysku
Zamontowany dysk zawiera trzy foldery najwyższego poziomu:
websites/— po jednym folderze na witrynę, z jej rzeczywistą strukturą plików (index.html,static/…, obrazy). Zapisanie pliku przesyła nową wersję, a witryna zachowuje swoją historię — tak samo jak podczas edycji w panelu.scripts/— skrypty automatyzacji, po jednym pliku.jskażdy, zawierającym kod skryptu. Harmonogram, stan włączenia/wyłączenia i opis pozostają w panelu.drive/— foldery i strony Drive.
Widoczne są wyłącznie te zasoby, do których konto ma dostęp, a serwer decyduje, co można zmieniać — te same uprawnienia co w panelu.
1. Instalacja sterownika FUSE
Aplikacja prezentuje się systemowi jako dysk za pośrednictwem komponentu systemowego o nazwie FUSE. Najpierw zainstaluj wersję odpowiednią dla swojego systemu:
- macOS — macFUSE
- Windows — WinFsp
- Linux — libfuse
Bez sterownika aplikacja uruchamia się, ale nie może zamontować dysku i informuje o brakującym sterowniku.
2. Pobieranie aplikacji
Otwórz stronę Pobrane w panelu i pobierz Qubix Drive dla swojego systemu.
Aplikacja nie jest jeszcze notaryzowana przez Apple. Jeśli macOS zablokuje ją przy pierwszym uruchomieniu, zezwól na nią w System Settings → Privacy & Security, a następnie otwórz ją ponownie.
3. Logowanie
Uruchom aplikację z poleceniem login, podając adres panelu oraz adres e-mail
konta. Zostaniesz poproszony o hasło.
Jako adres możesz wkleić dowolny link skopiowany z panelu — używana jest wyłącznie
część adresowa. Sesja jest zapisywana na komputerze, więc logujesz się tylko raz.
Stan sesji możesz sprawdzić w dowolnej chwili za pomocą qubix-fs whoami.
4. Montowanie dysku
macOS i Linux — wskaż aplikacji folder, w którym ma być zamontowany dysk:
qubix-fs mount ~/QubixDrive
Dysk pojawi się jako wolumin o nazwie Qubix.
Windows — wystarczy uruchomić qubix-fs mount; dysk pojawi się jako Q:\.
Pozostaw polecenie uruchomione — utrzymuje połączenie z dyskiem. Naciśnij Ctrl-C
lub uruchom qubix-fs unmount ~/QubixDrive, aby rozłączyć.
Praca z dyskiem
Otwieraj, edytuj i zapisuj pliki tak jak na każdym innym dysku — każdy zapis trafia z powrotem na serwer. Kilka zachowań różni się od zwykłego dysku lokalnego:
- Skryptów nie można usunąć z dysku. Aby nie usunąć przez pomyłkę działającej automatyzacji, usuwanie pliku skryptu jest blokowane — skrypty należy usuwać w panelu. Pliki witryn można usuwać (a ich historia jest zachowywana).
- W każdym folderze można dodawać tylko właściwy rodzaj plików. Nowe skrypty
trafiają do
scripts/jako pliki.js; nowe strony Drive trafiają dodrive/. Nowych witryn, skryptów ani elementów najwyższego poziomu nie tworzy się przez samo założenie folderu w katalogu głównym. - Nazwy mogą otrzymać krótki sufiks. Gdy dwa elementy mają tę samą nazwę,
aplikacja dodaje krótki kod w nawiasach — na przykład
My landing [a1b2c3d4]— aby każdy był odrębny. Kod służy wyłącznie do ich odróżnienia. - Nie ma trybu offline. Dysk jest bieżącym widokiem serwera. Jeśli połączenie zostanie przerwane, zapisywanie nie powiedzie się aż do jego przywrócenia — żadne operacje nie są kolejkowane. Zapis odrzucony przez serwer (na przykład skrypt z błędem składniowym) nie zmienia przechowywanej wersji.
- Uprawnienia są egzekwowane przez serwer. Jeśli nie masz uprawnień do zmiany danego zasobu, zapis zostanie odrzucony — te same reguły co w panelu.
Jeśli sesja wygaśnie lub zostanie unieważniona, dysk nie może połączyć się
z serwerem i aplikacja informuje o konieczności ponownego połączenia. Aby je
przywrócić, uruchom ponownie polecenie login.