Cerca de 5 minutos

Como usar o Aktar com MinIO

O MinIO permite rodar um armazenamento compatível com S3 no seu próprio servidor. A predefinição MinIO do Aktar usa endereçamento no estilo path (https://server/bucket/file), que é o que a maioria das instalações self-hosted espera.

O que você precisa

  • Um servidor MinIO acessível a partir do seu Mac, de preferência por HTTPS
  • O MinIO Client (mc) ou acesso ao MinIO Console
  • O Aktar instalado no seu Mac

Passo a passo

  1. 1

    Crie um bucket

    Usando o MinIO Client com um alias para o seu servidor:

    mc mb myminio/screenshots
  2. 2

    Libere downloads anônimos

    Dê ao bucket uma política de leitura pública para que os links compartilhados abram para qualquer pessoa:

    mc anonymous set download myminio/screenshots
  3. 3

    Crie uma access key

    No MinIO Console, crie uma access key (ou um usuário dedicado com acesso de leitura e escrita ao bucket) e copie a Access Key e a Secret Key.

  4. 4

    Adicione o destino no Aktar

    Em Settings → Destinations → Add Destination, escolha MinIO e informe os valores abaixo. Como o MinIO usa URLs no estilo path, a Public Base URL inclui o nome do bucket.

  5. 5

    Teste e salve

    Clique em Test Connection e depois em Save.

Configurações no Aktar

Preencha estes valores em Settings → Destinations → Add Destination. Os nomes dos campos são os mesmos do app.

CampoValor de exemplo
ProviderMinIO
Endpointhttps://minio.example.comO endereço da API do seu MinIO (geralmente na porta 9000).
Regionus-east-1A região configurada no seu servidor; us-east-1 se você nunca definiu uma.
Access Key IDaktar
Secret Access Key••••••••
Bucketscreenshots
Public Base URLhttps://minio.example.com/screenshotsInclui o nome do bucket.

Dicas

  • Coloque o MinIO atrás de um proxy reverso com HTTPS para que os links funcionem em qualquer navegador e app de mensagens.
  • Para enviar, basta seu Mac alcançar o servidor (VPN ou rede local servem), mas os links compartilhados exigem que a URL pública seja acessível para quem for abri-los.

Solução de problemas

O Test Connection mostra um erro de região ou de assinatura

Defina Region com a região configurada no seu servidor MinIO. Se você nunca configurou uma, use us-east-1.

Os links retornam 403

O bucket não tem política de leitura anônima, ou falta o nome do bucket na Public Base URL. Veja erros de Access Denied.

Ainda com problemas?Veja as perguntas frequentes ou pergunte no GitHub.