Na semana passada, concluímos o lançamento do Proton Drive SDK, um motor partilhado concebido para harmonizar o Proton Drive em todas as plataformas e para lhe trazer as funcionalidades de que necessita mais rapidamente. Hoje, damos o passo seguinte: o Proton Drive CLI já chegou, disponível para Windows, macOS e Linux.
O CLI traz o poder do nosso armazenamento na nuvem e da encriptação ponto a ponto para scripts, cópias de segurança e pipelines de implementação, sem o incómodo de escrever código. Foi desenvolvido com base no mesmo Proton Drive SDK que alimenta as nossas aplicações de cliente oficiais do Proton Drive, e é totalmente interoperável com as mesmas.
Para a nossa comunidade de programadores: enquanto desenvolvemos a nossa aplicação Linux com todas as funcionalidades, o CLI já lhe permite criar scripts para muitas das principais funcionalidades do Proton Drive a partir dos seus ambientes de script favoritos (ou até agendar tarefas com o cron). O CLI destina-se a complementar a aplicação Proton Drive. Não se trata de uma substituição completa — por exemplo, apenas as aplicações incluem um motor de sincronização completo que é executado em segundo plano —, mas sim de uma forma de alcançar muitos objetivos a partir de um ambiente de script leve.
O que é o CLI?
Uma interface de linha de comandos (CLI) é um programa que executa a partir de uma shell, como o Terminal, o PowerShell ou o SSH. Introduz um comando e argumentos, este faz o seu trabalho e termina. À semelhança de outras ferramentas de linha de comandos Unix, pode canalizar e criar scripts com o Proton Drive CLI juntamente com outras ferramentas em fluxos de trabalho maiores.
O Proton Drive CLI é um ficheiro binário único que pode introduzir nesse ecossistema. Suporta operações comuns da unidade, tais como listar pastas, carregar e transferir ficheiros, o lixo, partilhar ou convites. Por predefinição, os resultados são apresentados em formato de texto simples e legível — e, se estiver a criar automatizações, pode mudar para um formato legível por máquinas utilizando o parâmetro --json (ou -j).
Como é que o Proton Drive CLI ajuda?
Até agora, a utilização do Proton Drive como parte de um fluxo de trabalho automatizado — a par de ferramentas como scripts de implementação, tarefas de cópias de segurança, cron ou runbooks internos — significava fazê-lo manualmente (como abrir a aplicação ou arrastar ficheiros) ou fazer engenharia reversa do funcionamento interno da unidade para escrever scripts personalizados que eram frágeis e difíceis de manter. O CLI muda isso ao permitir-lhe executar operações do Proton Drive diretamente a partir do terminal. Pode, por exemplo, carregar ficheiros após a conclusão de uma compilação, fazer a cópia de segurança de uma pasta de forma programada, convidar um revisor ou verificar o que foi partilhado.
Isto é especialmente útil quando necessita que uma ação específica aconteça num momento específico, em vez de manter as pastas continuamente sincronizadas, como publicar ficheiros após um lançamento, tirar um instantâneo de uma pasta partilhada antes de uma auditoria ou revogar o acesso quando alguém sai da empresa. O CLI executa a operação, indica se funcionou e termina.
É ideal para quem já trabalha no terminal e para equipas que pretendem que os seus fluxos de trabalho da unidade sejam descritos como comandos repetíveis, em vez de uma série de cliques a memorizar.
Começar a utilizar o Proton Drive CLI
No lançamento, o CLI abrange o essencial: iniciar e terminar sessão, navegar e gerir ficheiros e pastas (incluindo o lixo), e gerir a partilha e os convites.
Alguns fluxos típicos:
proton-drive auth login
# Carregar ficheiros do diretório local para a pasta em Os meus ficheiros
proton-drive filesystem upload ./reports/* /my-files/Reports --conflict-strategy skip
# Ver quem tem acesso e, de seguida, convidar um colega
proton-drive sharing status /my-files/Reports
proton-drive sharing invite --user example@pm.me --role editor --message "Por favor, reveja os relatórios" /my-files/Reports
# Transferir para um diretório de cópias de segurança local
proton-drive filesystem download /my-files/Reports ./backups
Para obter o conjunto completo de comandos e parâmetros, execute proton-drive help ou proton-drive --help. Por exemplo, proton-drive filesystem upload --help.
Saiba mais sobre como utilizar o Proton Drive CLI.
O que vem a seguir
As próximas adições ao Proton Drive CLI incluem o suporte para:
- Fotos e álbuns
- Ficheiros e pastas partilhados através de uma ligação pública e segura
- Suporte multi-contas para equipas maiores e prestadores de serviços geridos
O nosso objetivo a longo prazo é trazer tudo o que pode fazer na aplicação Proton Drive para a linha de comandos.
Transferir o Proton Drive CLI
A forma mais rápida de começar é transferir os binários pré-compilados para a sua plataforma:
No macOS e Linux, terá de tornar o ficheiro executável após a transferência (chmod +x proton-drive). Uma vez concluído, execute proton-drive version para confirmar a compilação.
O início de sessão é feito através do seu navegador — sem palavra-passe na linha de comandos. As suas sessões são armazenadas de forma segura pelo seu sistema operativo (Windows Credential Manager, macOS Keychain ou libsecret no Linux).
Compilar a partir do código-fonte
Prefere compilar a partir do código-fonte? O CLI é implementado em TypeScript, empacotado com o Bun(nova janela) e está disponível para transferência no repositório do Drive SDK(nova janela). Depois de o clonar, pode instalar as dependências e compilar o CLI a partir do diretório principal:
cd js/cli
bun install
bun run build
./release/proton-drive auth login
./release/proton-drive filesystem list /my-files
Consulte o README do CLI no repositório para obter mais detalhes.
Utilização responsável e limites de utilização
O Proton Drive CLI segue as mesmas políticas de utilização responsável que todos os clientes do Proton Drive. Para se manter dentro dos limites, carregue ou transfira apenas o que realmente mudou — não volte a carregar repetidamente os mesmos ficheiros nem substitua pastas inteiras quando apenas alguns ficheiros são novos. As contas que geram um tráfego invulgarmente elevado são temporariamente limitadas para proteger o serviço para todos.
Agora no seu terminal, com o mesmo nível de privacidade
O Proton Drive CLI está disponível hoje e mais funcionalidades surgirão em breve. Tudo o que faz através do terminal está protegido pela mesma encriptação ponto a ponto que o resto do Proton Drive. Transfira-o, experimente-o e diga-nos o que desenvolveu. E se utiliza o Linux: está a caminho um cliente de ambiente de trabalho completo com sincronização.
