Cliente desktop
O aplicativo desktop do Qubix Drive monta o seu conteúdo do Qubix como um disco local. O disco
aparece como pastas e arquivos comuns, e cada alteração salva é gravada
diretamente no seu servidor Qubix — da mesma forma que o Google Drive para desktop funciona. Ele
permite editar no VS Code, vim ou em qualquer ferramenta, e copiar arquivos para dentro e fora com cp,
mv ou rsync.
O que há no disco
O disco montado possui três pastas de nível superior:
websites/— uma pasta por site, com sua árvore de arquivos real (index.html,static/…, imagens). Salvar um arquivo envia uma nova versão e o site mantém seu histórico, exatamente como ao editar no painel.scripts/— seus scripts de automação, um arquivo.jscada, contendo o código do script. O agendamento, o estado ligado/desligado e a descrição permanecem no painel.drive/— suas pastas e páginas do Drive.
Você vê apenas o que sua conta tem permissão para ver, e o servidor decide o que você pode alterar — o mesmo acesso que no painel.
1. Instale o driver FUSE
O aplicativo se apresenta como um disco por meio de um componente do sistema chamado FUSE. Instale o adequado para o seu sistema primeiro:
- macOS — macFUSE
- Windows — WinFsp
- Linux — libfuse
Sem ele, o aplicativo inicia, mas não consegue montar o disco e informa que o driver está ausente.
2. Baixe o aplicativo
Abra a página Downloads no painel e baixe o Qubix Drive para o seu sistema.
O aplicativo ainda não foi notarizado pela Apple. Se o macOS bloqueá-lo na primeira inicialização, permita-o em Configurações do Sistema → Privacidade e Segurança e abra-o novamente.
3. Faça login
Execute o aplicativo com o comando login, informando o endereço do painel e o e-mail da sua conta.
Você será solicitado a inserir a senha.
Para o endereço, você pode colar qualquer link copiado do seu painel — apenas a parte do endereço
é utilizada. A sessão é salva no seu computador, portanto você faz login uma única vez. Verifique-a
a qualquer momento com qubix-fs whoami.
4. Monte o disco
macOS e Linux — forneça ao aplicativo uma pasta para montar:
qubix-fs mount ~/QubixDrive
O disco aparece como um volume chamado Qubix.
Windows — basta executar qubix-fs mount; o disco aparece como Q:\.
Deixe o comando em execução — ele mantém o disco conectado. Pressione Ctrl-C ou execute
qubix-fs unmount ~/QubixDrive para desconectar.
Trabalhando com o disco
Abra, edite e salve arquivos como faria em qualquer disco — cada salvamento é enviado de volta ao seu servidor. Algumas coisas se comportam de forma diferente de um disco local comum:
- Scripts não podem ser excluídos pelo disco. Para que você não remova acidentalmente uma automação ativa, a exclusão de um arquivo de script é recusada — remova os scripts pelo painel. Arquivos de sites podem ser excluídos (e o histórico deles é mantido).
- Você só pode adicionar o tipo correto de arquivo em cada pasta. Novos scripts vão em
scripts/como arquivos.js; novas páginas do Drive vão emdrive/. Novos sites, scripts ou itens de nível superior não são criados apenas criando uma pasta na raiz. - Os nomes podem receber um sufixo curto. Quando dois itens têm o mesmo nome, o aplicativo adiciona um
código curto entre colchetes — por exemplo
Minha landing [a1b2c3d4]— para que cada um seja distinto. O código serve apenas para diferenciá-los. - Não há modo offline. O disco é uma visualização ao vivo do seu servidor. Se a conexão cair, o salvamento falhará até que ela seja restabelecida — nada fica em fila. Um salvamento recusado (por exemplo, um script com erro de sintaxe) deixa a versão armazenada intacta.
- O acesso é controlado pelo servidor. Se você não tiver permissão para alterar algo, o salvamento é recusado — as mesmas regras do painel.
Se a sua sessão expirar ou for revogada, o disco não conseguirá mais acessar o servidor e
o aplicativo solicitará que você se reconecte. Execute o comando login novamente para restaurá-la.