Docs/ Operações/ Gerenciador de Arquivos

Gerenciador de Arquivos

Navegue e gerencie arquivos dentro dos seus contêineres com um explorador de arquivos visual. Visualize, edite, envie e baixe arquivos sem abrir um terminal.

Navegando Arquivos do Contêiner

O gerenciador de arquivos fornece uma interface visual para o sistema de arquivos dentro de qualquer contêiner em execução. Acesse-o pela página de detalhes do serviço clicando na aba Arquivos.

Navegue até seu serviço dentro da sua stack.
Clique na aba Arquivos.
O navegador de arquivos abre no diretório raiz do contêiner (/).

File manager main view -- showing a directory listing with file names, sizes, modification dates, and permission indicators

A lista de arquivos exibe as seguintes informações para cada entrada:

Nome -- Nome do arquivo ou diretório, com ícones distinguindo arquivos de pastas.
Tamanho -- Tamanho do arquivo em formato legível (KB, MB, GB).
Modificado -- Timestamp da última modificação.
Permissões -- Permissões Unix exibidas como string (ex.: rwxr-xr-x).
Proprietário -- Proprietário e grupo do arquivo.

Navegando Diretórios

Clique em qualquer nome de diretório para entrar nele. O caminho breadcrumb no topo mostra sua localização atual e permite voltar para qualquer diretório pai.

Breadcrumb navigation -- showing path segments / > app > src > routes with each segment clickable

Você também pode digitar um caminho diretamente na barra de caminho para ir a um diretório específico. Pressione Enter para navegar.

Tip

Caminhos comuns para verificar: /app (código da aplicação), /var/log (logs), /etc (configuração) e /tmp (arquivos temporários).

Visualizando Conteúdo de Arquivos

Clique em qualquer arquivo para abri-lo no visualizador integrado. O visualizador suporta destaque de sintaxe para tipos comuns de arquivo:

Arquivos de código-fonte (JavaScript, Python, Ruby, Go, Rust, PHP, etc.)
Arquivos de configuração (JSON, YAML, TOML, INI, XML)
Texto simples e arquivos de log
Scripts shell
Dockerfiles e arquivos docker-compose

File viewer -- showing a package.json file with syntax highlighting and line numbers

Note

Arquivos binários (imagens, binários compilados, arquivos compactados) não podem ser exibidos no visualizador. Você pode baixá-los.

Editando Arquivos

O gerenciador de arquivos inclui um editor integrado para fazer alterações rápidas em arquivos. Clique no botão Editar ao visualizar um arquivo para entrar no modo de edição.

Abra um arquivo no visualizador.
Clique em Editar no canto superior direito.
Faça suas alterações no editor.
Clique em Salvar para gravar as alterações no contêiner.

File editor -- showing an editable text area with syntax highlighting, a Save button, and a Discard button

Warning

Edições de arquivo são gravadas diretamente no sistema de arquivos do contêiner. Se o arquivo não está em um volume montado, as alterações serão perdidas quando o contêiner reiniciar ou for reimplantado. Para alterações permanentes, atualize seu código-fonte e reimplante.

Enviando Arquivos

Envie arquivos da sua máquina local para o contêiner. Isso é útil para transferir arquivos de configuração, certificados, arquivos de dados ou assets.

Navegue até o diretório de destino no gerenciador de arquivos.
Clique no botão Upload.
Selecione um ou mais arquivos da sua máquina (ou arraste e solte na lista de arquivos).
Os arquivos são enviados e aparecem no diretório.

File upload dialog -- showing a drag-and-drop zone and a file picker button with upload progress indicators

Note

Tamanho máximo de upload é 100 MB por arquivo. Para arquivos maiores, use o Terminal com wget ou curl para baixar arquivos diretamente no contêiner.

Baixando Arquivos

Baixe arquivos do contêiner para sua máquina local. Clique com o botão direito em um arquivo (ou use o menu de ações) e selecione Download.

Você também pode baixar diretórios inteiros como um arquivo .tar.gz. Isso é útil para puxar diretórios de log, arquivos de backup ou dados da aplicação.

File context menu -- showing options for Download, Rename, Copy path, and Delete

Permissões de Arquivo

O gerenciador de arquivos exibe permissões Unix para cada arquivo e diretório. Você pode modificar permissões pelo painel de propriedades:

Clique com o botão direito em um arquivo e selecione Propriedades.
Visualize ou modifique o modo de permissão (ex.: 644, 755).
Clique em Aplicar para atualizar as permissões.

Common permission patterns

644  - Owner read/write, group/others read-only (files)
755  - Owner full, group/others read+execute (directories, scripts)
600  - Owner read/write only (private keys, secrets)
777  - Full access for everyone (avoid this in production)

Arquivos Persistentes vs. Efêmeros

Entender quais arquivos persistem entre reinicializações de contêiner é fundamental:

Tipo	Sobrevive à Reinicialização?	Exemplos
Volumes montados	Sim	Dados de banco de dados, arquivos enviados, configuração persistente
Sistema de arquivos do contêiner	Não	Código da aplicação, arquivos temporários, logs (a menos que montados em volume)

Tip

No gerenciador de arquivos, diretórios que são respaldados por um volume são marcados com um ícone de volume. Isso facilita identificar quais caminhos persistirão entre reinicializações.

Terminal Access

Logs