デスクトップクライアント
Qubix Drive デスクトップアプリは、Qubix のコンテンツをローカルディスクとしてマウントします。ディスクは通常のフォルダとファイルとして表示され、保存した変更はすべて Qubix サーバーに直接書き込まれます — Google Drive for Desktop と同様の仕組みです。VS Code や vim などのツールで編集したり、cp、mv、rsync でファイルをコピーしたりできます。
ディスクの構成
マウントされたディスクには、3 つのトップレベルフォルダがあります：
websites/— サイトごとに 1 つのフォルダがあり、実際のファイルツリー（index.html、static/…、画像）が含まれます。ファイルを保存すると新しいバージョンがアップロードされ、パネルで編集した場合と同様に履歴が保持されます。scripts/— 自動化スクリプトが格納されます。スクリプトのコードを含む.jsファイルが各スクリプトに 1 つずつあります。スケジュール、オン/オフ状態、説明はパネルで管理されます。drive/— Drive のフォルダとページが格納されます。
表示されるのはアカウントで閲覧が許可されているコンテンツのみです。変更できる内容はサーバーによって決定され、パネルと同じアクセス権限が適用されます。
1. FUSE ドライバーのインストール
アプリは FUSE と呼ばれるシステムコンポーネントを通じてディスクとして機能します。お使いのシステム向けのドライバーを先にインストールしてください：
- macOS — macFUSE
- Windows — WinFsp
- Linux — libfuse
ドライバーがない場合、アプリは起動しますがマウントできず、ドライバーが見つからない旨のメッセージが表示されます。
2. アプリのダウンロード
パネルで ダウンロード ページを開き、お使いのシステム向けの Qubix Drive をダウンロードしてください。
このアプリはまだ Apple による公証を受けていません。macOS が初回起動時にブロックした場合は、「システム設定」→「プライバシーとセキュリティ」 で許可してから、再度開いてください。
3. ログイン
login コマンドでアプリを実行し、パネルのアドレスとアカウントのメールアドレスを指定してください。パスワードの入力を求められます。
アドレスにはパネルからコピーしたリンクをそのまま貼り付けることができます — アドレス部分のみが使用されます。セッションはコンピューターに保存されるため、ログインは 1 回だけ必要です。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/以下に配置します。ルートにフォルダを作成するだけでは、新しいサイト・スクリプト・トップレベルの項目は作成されません。 - 名前に短いサフィックスが付く場合があります。 同じ名前の項目が 2 つある場合、アプリは括弧内に短いコードを追加します（例：
My landing [a1b2c3d4]）。これにより各項目が区別されます。コードは識別のためだけのものです。 - オフラインモードはありません。 ディスクはサーバーのライブビューです。接続が切断されると、復旧するまで保存が失敗します — キューには入りません。拒否された保存（例えば構文エラーのあるスクリプト）は、保存済みのバージョンに影響を与えません。
- アクセスはサーバーによって制御されます。 変更する権限がない場合、保存は拒否されます — パネルと同じルールが適用されます。
セッションが期限切れまたは無効化された場合、ディスクはサーバーに接続できなくなり、再接続を促すメッセージが表示されます。login コマンドを再度実行して復元してください。