File Manager — Guia do usuário | YoBench

Para que serve o módulo «File Manager»

O File Manager é um navegador unificado para arquivos no seu computador e em armazenamentos na nuvem. Em vez de alternar entre Finder/Explorer, um cliente FTP, um console de S3 e o WinSCP, você ganha uma única janela onde abre até quatro pastas lado a lado, arrasta arquivos entre elas e acompanha cópias longas pela fila de transferência.

O que você obtém:

• Quatro tipos de conexão — disco local, FTP, SFTP e armazenamento compatível com S3 (Amazon S3, MinIO, Yandex Cloud, Backblaze B2, Cloudflare R2 e outros).
• Até quatro pastas lado a lado — um navegador de duas, três ou quatro colunas com navegação, ordenação e filtros independentes em cada coluna.
• Fila de transferência — cópias e movimentações ficam visíveis num painel separado, com progresso por arquivo e por bytes, além de pausa, retomada e cancelamento.
• Uploads retomáveis — arquivos grandes em S3 são divididos em partes de 8 MB; se a conexão cair, a transferência continua a partir da última parte concluída.
• Resolução de conflitos — quando há colisão de nomes, você pode pular, sobrescrever ou renomear automaticamente, com a opção de aplicar a todos.
• Inspetor — preview para imagens, texto, PDFs, vídeo e áudio, mais propriedades do arquivo e hash SHA256 sob demanda.
• Arquivos ZIP — crie e extraia direto dentro do navegador.
• Restauração de sessão — pastas e colunas abertas voltam depois de reiniciar o app.
• Credenciais criptografadas — senhas FTP, chaves SSH e chaves de acesso da nuvem ficam guardadas criptografadas.

Conexões suportadas e seus parâmetros

Local

• Pasta — caminho da pasta. O botão Choose abre o seletor do sistema.

FTP

• Host — endereço do servidor.
• Port — padrão 21.
• Username e Password.
• Root path — usado como «raiz» da conexão, padrão /.
• Use TLS — checkbox para FTPS, desligado por padrão.
• A conexão roda em modo passivo.

SFTP

• Host e Port (padrão 22).
• Username.
• Password — para autenticação por senha (opcional).
• Private Key — texto da chave privada SSH (-----BEGIN OPENSSH PRIVATE KEY-----…). Opcional.
• Passphrase — caso a chave esteja protegida por uma passphrase.
• Host Fingerprint — fingerprint do servidor no formato SHA256:… para validação trust-on-first-use. Opcional.
• Root path — padrão /.

Você pode usar uma senha, uma chave ou ambas ao mesmo tempo.

Armazenamento compatível com S3

• S3 Endpoint — URL do provedor. Deixe vazio para o AWS S3. Exemplos: https://storage.yandexcloud.net, https://s3.us-west-002.backblazeb2.com, https://<account>.r2.cloudflarestorage.com, http://localhost:9000 para MinIO.
• S3 Region — padrão us-east-1.
• S3 Bucket — obrigatório.
• S3 Prefix — prefixo opcional dentro do bucket, usado como «raiz» da conexão.
• S3 Access Key e S3 Secret Key.
• Force Path Style — checkbox para provedores que exigem URLs no estilo path em vez de virtual-hosted (como o MinIO). Desligado por padrão.

Para arquivos grandes, o multipart upload entra em ação automaticamente, com partes de 8 MB.

Como a janela é organizada

O File Manager tem até quatro colunas ao mesmo tempo. Cada coluna mostra:

• Barra de endereço — o caminho atual; clique para editar (ou pressione Cmd/Ctrl+L).
• Lista de arquivos — ordenável por nome, tamanho, data de modificação ou tipo.
• Campo de busca / filtro — filtra a lista por substring.
• Toggle de arquivos ocultos — mostra ou esconde dotfiles.

Colunas podem ser adicionadas e removidas. Quando há menos de quatro abertas, aparece um botão + Add column à direita. Alterne entre colunas com Tab / Shift+Tab ou pule direto para uma com Cmd/Ctrl+1..4.

À direita você pode abrir o inspetor — um painel lateral com três abas:

• Preview — preview do arquivo selecionado. Suporta imagens, texto (até 100.000 caracteres), PDFs, vídeo e áudio. Para arquivos compactados e binários, só os metadados são exibidos.
• Properties — tamanho, data de modificação, caminho completo.
• Hash — SHA256 calculado sob demanda.

A largura do inspetor é ajustável com o mouse (entre 280 e 720 pixels).

Fila de transferência

Todas as operações longas (copiar, mover, upload, download) vão para o painel de transferências na parte inferior da janela. Você pode escondê-lo e mostrá-lo de novo.

Cada tarefa exibe:

• Tipo de operação (cópia, movimentação, upload).
• Progresso — arquivos concluídos sobre o total.
• Estado — em execução, pausada, concluída, cancelada ou com falha.
• Progresso em bytes.

Ações disponíveis:

• Pause (‖) — pausa uma tarefa em execução.
• Resume (▶) — continua uma tarefa pausada ou com falha.
• Cancel (×) — cancela uma tarefa em qualquer estado.
• Clear finished — remove tarefas concluídas da lista.

Se já existir um arquivo com o mesmo nome no destino, abre o diálogo de resolução de conflitos:

• Skip — pula este arquivo.
• Overwrite — substitui o existente.
• Rename — adiciona (1), (2) e assim por diante.
• Apply to all remaining conflicts — aplica a sua escolha a todos os conflitos restantes desta tarefa.
• Cancel job — cancela a operação inteira.

Arquivos compactados

O menu de contexto de um arquivo ou pasta tem os itens Create archive e Extract archive:

• Formato suportado: ZIP.
• Os arquivos podem ser montados a partir de itens selecionados em qualquer coluna (por exemplo, empacote uma pasta local e suba o ZIP direto para o S3).
• A extração pode ir para qualquer pasta de qualquer conexão.
• Proteção contra zip bomb: a extração é limitada a 10 GB de dados descompactados.

Restauração de sessão

Depois de reiniciar o app, isto é restaurado:

• Quais colunas estavam abertas e suas larguras.
• A conexão e a pasta atual de cada coluna.
• Ordenação, filtro e o toggle de arquivos ocultos.
• A coluna ativa e a largura do inspetor.

A conexão em si fica armazenada à parte e nunca se perde. A sessão é salva automaticamente com debounce de 0,5 segundo após mudanças.

Atualizações em tempo real das pastas

Para pastas locais, o File Manager observa o sistema de arquivos e atualiza a lista por conta própria — adicione ou apague um arquivo no Finder/Explorer e a coluna se atualiza na hora. Para conexões remotas (FTP, SFTP, S3) a atualização automática não está disponível — pressione Cmd/Ctrl+R ou o botão Refresh para reler a pasta.

Segurança

• Senhas FTP, chaves SSH, passphrases e credenciais S3 ficam guardadas criptografadas no banco de dados local do app.
• O renderer (processo de UI) nunca vê os segredos crus — só flags do tipo «password set» / «key set».
• O botão Show password tem rate limit de cinco revelações por hora por processo.
• Para SFTP você pode fixar um fingerprint do servidor (SHA256:…); na próxima conexão, o app verifica — protegendo você de servidores impostores na rede.

Atalhos de teclado

Configurações

As configurações do File Manager têm quatro seções:

• Sources — CRUD completo das conexões salvas, com botões Test, ocultar e remover.
• Behaviour — defaults: se mostrar arquivos ocultos, comportamento de drag-and-drop, etc.
• Hotkeys — tabela de referência dos atalhos de teclado.
• About — informações do módulo.

Fluxo de uso

1. Conecte-se a uma pasta local

1. Abra o File Manager na barra lateral.
2. Settings → Sources → New source.
3. Tipo — Local.
4. Nome (por exemplo, «Documentos») e o caminho.
5. Salve.
6. No navegador, clique em + Add column e escolha a nova conexão.

2. Conecte-se ao S3

1. Settings → Sources → New source → tipo S3.
2. Preencha Endpoint (ou deixe vazio para AWS), Region, Bucket, Access Key, Secret Key.
3. Se o seu provedor exige URLs no estilo path (como o MinIO), ative Force Path Style.
4. Test — a conexão deve listar objetos com sucesso.
5. Salve.

3. Copie arquivos entre provedores

1. Abra duas colunas — uma com a pasta local, outra com o S3 (ou FTP).
2. Selecione arquivos na coluna de origem (Cmd/Ctrl+A, Shift+click, Cmd/Ctrl+click).
3. Arraste a seleção para a coluna de destino — ou pressione F5 (copiar) / F6 (mover).
4. A transferência aparece no painel de transferências na parte inferior. Se já existirem arquivos, o diálogo de conflito é aberto.
5. Feche a janela ou continue trabalhando — a transferência roda em segundo plano. Você pode pausar e retomar depois, inclusive entre reinícios do app.

4. Extraia um arquivo da nuvem para o seu computador

1. Abra duas colunas: S3 (ou FTP) e uma pasta local.
2. Encontre o arquivo ZIP na coluna remota.
3. Clique direito no arquivo → Extract archive.
4. Escolha a pasta de destino — pode ser direto na coluna local.
5. A extração roda em segundo plano como qualquer outra transferência — com progresso e suporte a pausa.

Próximos passos

• DB Manager — agende backups de banco direto para o S3 ou para um servidor FTP.
• Scenarios — automatize movimentações recorrentes de arquivos e reaproveite as mesmas conexões.
• Configurações — configure uma senha-mestra para proteger todas as conexões salvas.

Ajuda e feedback

Algo não está funcionando ou falta um recurso? Escreva para nós pelo formulário de contato.