Настольный клиент
Настольное приложение Qubix Drive подключает содержимое Qubix как локальный диск. Диск
выглядит как обычные папки и файлы, а каждое сохранение сразу записывается обратно на
ваш сервер Qubix — так же, как работает Google Drive для компьютера. Вы можете
редактировать файлы в VS Code, vim или любом другом инструменте, а также копировать их
с помощью cp, mv или rsync.
Что находится на диске
Смонтированный диск содержит три папки верхнего уровня:
websites/— по одной папке на каждый сайт с его реальным деревом файлов (index.html,static/…, изображения). При сохранении файла загружается новая версия, и сайт сохраняет историю — точно так же, как при редактировании в панели.scripts/— ваши скрипты автоматизации: по одному файлу.jsс кодом скрипта. Расписание, состояние (вкл./выкл.) и описание остаются в панели.drive/— папки и страницы вашего Drive.
Вы видите только то, к чему у вашего аккаунта есть доступ, а сервер определяет, что вы можете изменить — те же права, что и в панели.
1. Установите драйвер FUSE
Приложение представляет себя как диск через системный компонент FUSE. Сначала установите подходящий для вашей системы:
- macOS — macFUSE
- Windows — WinFsp
- Linux — libfuse
Без него приложение запустится, но не сможет смонтировать диск и сообщит об отсутствии драйвера.
2. Скачайте приложение
Откройте страницу Загрузки в панели и скачайте Qubix Drive для вашей системы.
Приложение пока не нотаризировано Apple. Если macOS заблокирует его при первом запуске, разрешите его в System Settings → Privacy & Security, а затем откройте снова.
3. Войдите в аккаунт
Запустите приложение с командой login, указав адрес вашей панели и электронную почту
аккаунта. Вас попросят ввести пароль.
В качестве адреса можно вставить любую ссылку, скопированную из панели — используется
только сам адрес. Сессия сохраняется на вашем компьютере, поэтому входить нужно только
один раз. Проверить состояние можно в любой момент командой qubix-fs whoami.
4. Смонтируйте диск
macOS и Linux — укажите приложению папку для монтирования:
qubix-fs mount ~/QubixDrive
Диск появится как том с именем Qubix.
Windows — просто выполните qubix-fs mount; диск появится как Q:\.
Не закрывайте команду — она поддерживает соединение с диском. Нажмите Ctrl-C или
выполните qubix-fs unmount ~/QubixDrive, чтобы отключиться.
Работа с диском
Открывайте, редактируйте и сохраняйте файлы, как на любом диске — каждое сохранение передаётся на ваш сервер. Некоторые вещи работают иначе, чем на обычном локальном диске:
- Скрипты нельзя удалить с диска. Чтобы вы случайно не удалили работающую автоматизацию, удаление файла скрипта запрещено — удаляйте скрипты через панель. Файлы сайтов можно удалять (их история при этом сохраняется).
- В каждой папке можно добавлять только файлы подходящего типа. Новые скрипты
создаются в
scripts/как файлы.js; новые страницы Drive — вdrive/. Создать новый сайт, скрипт или элемент верхнего уровня, просто сделав папку в корне, не получится. - К именам может добавляться короткий суффикс. Если два элемента имеют одинаковое
название, приложение добавляет короткий код в квадратных скобках — например
My landing [a1b2c3d4]— чтобы каждый был уникальным. Код нужен только для различения элементов. - Автономный режим не предусмотрен. Диск отображает содержимое сервера в реальном времени. При обрыве соединения сохранение не работает до его восстановления — очереди нет. Отклонённое сохранение (например, скрипт с синтаксической ошибкой) не изменяет хранящуюся версию.
- Доступ определяется сервером. Если у вас нет прав на изменение чего-либо, сохранение будет отклонено — те же правила, что и в панели.
Если сессия истечёт или будет отозвана, диск потеряет соединение с сервером и приложение
попросит вас переподключиться. Выполните команду login ещё раз, чтобы восстановить
соединение.