Pular para o conteúdo
Documentação

MinIO / S3: buckets e métricas

Como conectar o miniCP a um servidor MinIO para gerenciar buckets e arquivos e acompanhar as métricas do storage.

R Regis Manze 20/11/2026 4 min de leitura

A integração com MinIO deixa você criar e remover buckets, navegar pelos arquivos, enviar e baixar objetos direto do painel. As métricas do MinIO (capacidade, drives, requisições) ficam na tela Observabilidade.

O miniCP não instala o MinIO. Ele se conecta a um servidor MinIO que já existe, pela API S3.

Ativar a integração

  1. Abra Configuracoes e vá até a aba MinIO.
  2. Ligue a chave Habilitado.
  3. Preencha os campos:
Campo O que informar
Host / IP Endereço do servidor MinIO.
Porta (API) Porta da API S3. O padrão é 9000.
HTTPS/TLS Ligue se a API do MinIO responde em HTTPS.
Access Key Chave de acesso com permissão de administrador.
Secret Key Senha da chave. Deixe vazio para manter a atual.
  1. Salve as configurações.

Depois de habilitado, aparece o item MinIO no menu lateral, no grupo de rede.

Atenção: use a porta da API S3 (normalmente 9000), não a porta do Console web (normalmente 9001). As credenciais precisam ter permissão de admin no MinIO.

Se a conexão falhar, a tela MinIO mostra a mensagem "Falha ao conectar no MinIO" com o erro devolvido. Confira host, porta, TLS e credenciais.

Gerenciar buckets

A tela MinIO lista os buckets com nome e data de criação.

Criar um bucket

  1. Clique em Criar Bucket.
  2. Informe o Nome do Bucket.
  3. Clique em Criar.

Regras para o nome: de 3 a 63 caracteres, só letras minúsculas, números, ponto ou hífen. Deve começar e terminar com letra ou número.

Remover um bucket

Clique no ícone de lixeira na linha do bucket e confirme.

Atenção: o bucket precisa estar vazio para ser removido. Apague os objetos antes.

Navegar e gerenciar arquivos

  1. Clique no ícone de pasta na linha do bucket para abrir.
  2. As "pastas" (prefixos) aparecem primeiro. Clique para entrar.
  3. Use a trilha no topo para voltar a um nível anterior, ou Buckets para voltar à lista.

Para cada objeto você vê nome, tamanho e data de modificação, com as ações:

  • Baixar (ícone de download);
  • Remover (ícone de lixeira, com confirmação).

Para enviar um arquivo para a pasta atual:

  1. No quadro Enviar para, escolha o arquivo.
  2. Clique em Upload.

Dica: a listagem mostra até 1000 itens por pasta. Se houver mais, aparece o aviso de lista truncada. Organize os objetos em prefixos (pastas) para navegar melhor.

Chaves de acesso

O painel não cria nem gerencia usuários, políticas ou chaves de acesso do MinIO. Para criar uma chave para uma aplicação (por exemplo, uma loja que guarda imagens no S3), use o Console do MinIO ou a ferramenta mc:

mc admin user add meuminio app-loja SENHA-FORTE
mc admin policy attach meuminio readwrite --user app-loja

Prefira chaves com acesso restrito ao bucket da aplicação. Não use a chave de admin do painel nas aplicações.

Métricas do MinIO

As métricas ficam em Monitoramento > Observabilidade. Lá o MinIO é cadastrado separado da integração acima.

  1. Em Observabilidade, clique no botão MinIO.
  2. Informe Nome, Host, Porta (API), Access Key, Secret Key e, se for o caso, Usar HTTPS/TLS.
  3. Clique em Adicionar.
  4. Na lista de conexões, clique no botão de monitor ao vivo do MinIO.

O monitor mostra:

Indicador Significado
Modo Estado do cluster (online ou não).
Servidores Quantidade de nós.
Drives Online / Offline Discos ativos e com falha.
Capacidade e Uso Espaço usado, total e percentual.
Buckets e Objetos Contagem total.
Req S3 e Erros S3 Requisições recebidas e com erro.
Trafego IN / OUT Volume recebido e enviado.
Versao e Uptime Versão do MinIO e tempo no ar.

Também há gráficos de uso, objetos, drives online e requisições.

Dica: se aparecer o aviso "Metricas Prometheus indisponiveis", as requisições e o tráfego ficam zerados. Verifique se o endpoint de métricas do MinIO está acessível e se as credenciais estão corretas.

Copiar para usar com IA

Este artigo foi útil?

Que bom! O que ajudou mais? O que faltou nesta página?

Opcional — seu voto já foi registrado.

Obrigado pelo seu feedback!