rclone — A Ferramenta Completa para Armazenamento em Nuvem

Quando Usar

Use esta habilidade quando precisar de referência e guia de uso do gerenciador de armazenamento em nuvem via linha de comando rclone. Use esta habilidade sempre que o usuário mencionar rclone, ou qualquer tarefa envolvendo operações de arquivos em nuvem baseadas em terminal, como upload, download, sincronização, cópia, movimentação, montagem ou gerenciamento de remotos. Dispara em armazenamento compatível com S3,...

Rclone é um programa de linha de comando para gerenciar arquivos em armazenamento em nuvem. É uma alternativa rica em recursos às interfaces de armazenamento web dos fornecedores de nuvem. Mais de 70 produtos de armazenamento em nuvem suportam rclone, incluindo armazenamentos de objetos S3, serviços de armazenamento de arquivos empresariais e de consumidores, e protocolos de transferência padrão.

Rclone possui equivalentes poderosos na nuvem para os comandos Unix rsync, cp, mv, mount, ls, ncdu, tree, rm e cat. Ele preserva timestamps e verifica checksums o tempo todo. As transferências podem ser reiniciadas a partir do último arquivo bem-sucedido.

Recursos oficiais: rclone.org | Docs | Comandos | Instalar | Fórum | GitHub

Pré-requisitos

Antes de usar o rclone, verifique se ele está instalado:

# Check if rclone is installed
rclone --version

# If not found, run the install script:
# See scripts/install.sh in this skill's directory
sudo -v ; curl https://rclone.org/install.sh | sudo bash

# Or for beta version:
sudo -v ; curl https://rclone.org/install.sh | sudo bash -s beta

Para instalação offline/manual, use o script empacotado em scripts/install.sh.

Avisos de Segurança

IMPORTANTE: Rclone é extremamente poderoso e pode modificar ou excluir dados irreversivelmente no armazenamento em nuvem. Preste muita atenção às seguintes diretrizes de segurança:

• Sempre use --dry-run primeiro ao executar os comandos sync, move, delete ou purge. Isso mostra o que aconteceria sem realmente fazê-lo.
• Use a flag --interactive / -i enquanto aprende rclone para evitar perda acidental de dados. Ele pede confirmação antes de cada operação destrutiva.
• Nunca exponha credenciais em texto puro na linha de comando. Use rclone config para armazenar credenciais com segurança, ou use variáveis de ambiente.
• Chaves privadas e tokens (chaves secretas S3, JSON de conta de serviço, tokens OAuth) nunca devem ser enviados para controle de versão ou registrados. O arquivo de configuração ~/.config/rclone/rclone.conf contém dados sensíveis — proteja-o com chmod 600.
• rclone purge ignora todos os filtros — ele exclui tudo sob o caminho especificado. Use com extrema cautela.
• rclone sync torna o destino idêntico à origem — arquivos no destino que não estão na origem serão EXCLUÍDOS. Sempre verifique com --dry-run primeiro.
• API de controle remoto (--rc) deve se vincular apenas ao localhost por padrão. Expor sem autenticação (--rc-htpasswd) permite que qualquer pessoa controle sua instância rclone.
• Operações de montagem podem causar perda de dados se a montagem for interrompida durante gravações. Use --vfs-cache-mode full para gravações mais seguras.

Referência Rápida

Configuração

# Interactive configuration (recommended)
rclone config

# Show current config (redacts secrets by default)
rclone config show

# Show full config including secrets (DANGEROUS — do not share output)
rclone config show --redacted=false

# List configured remotes
rclone listremotes

# Create a remote non-interactively
rclone config create myremote s3 provider=AWS env_auth=true region=us-east-1

# Update existing remote
rclone config update myremote region=us-west-2

Sintaxe Básica

rclone subcommand [options] source:path dest:path

Caminhos de origem e destino usam a sintaxe remote:path. Para caminhos locais, use apenas /path/to/dir.

Comandos Principais

# Listar arquivos
rclone ls remote:path                    # lista todos os objetos com tamanho
rclone lsd remote:path                   # lista diretórios
rclone lsl remote:path                   # lista com tamanho, modtime, caminho
rclone lsf remote:path                   # lista em formato flexível
rclone size remote:path                  # tamanho total e contagem de objetos
rclone tree remote:path                  # visualização em árvore

# Copiar (não exclui arquivos no destino)
rclone copy /local/path remote:path      # local para remoto
rclone copy remote:path /local/path      # remoto para local
rclone copy remote1:path remote2:path    # remoto para remoto (server-side se possível)


…