Cerca de 5 minutos

Como usar o Aktar com Wasabi, Hetzner, Scaleway e outros armazenamentos compatíveis com S3

O Aktar funciona com qualquer provedor que implemente a API do Amazon S3. Escolha Other S3-Compatible e informe o endpoint, a região e as chaves do provedor. Exemplos comuns:

  • Wasabi: https://s3.<region>.wasabisys.com, por exemplo s3.eu-central-1.wasabisys.com
  • Hetzner Object Storage: https://<location>.your-objectstorage.com, por exemplo fsn1.your-objectstorage.com
  • Scaleway: https://s3.<region>.scw.cloud, por exemplo s3.fr-par.scw.cloud
  • Akamai (Linode): https://<region>.linodeobjects.com

O que você precisa

  • Uma conta em um provedor compatível com S3
  • O Aktar instalado no seu Mac

Passo a passo

  1. 1

    Crie um bucket

    Crie um bucket no console do seu provedor e anote a região ou localização, por exemplo eu-central-1, fsn1 ou fr-par.

  2. 2

    Libere a leitura pública

    Deixe os objetos do bucket com leitura pública, usando a configuração de visibilidade do bucket do provedor ou uma bucket policy que permita s3:GetObject. O Aktar não define permissões por arquivo, então isso precisa ser configurado no bucket.

  3. 3

    Crie as chaves de acesso

    Crie uma access key e um secret S3 com acesso de leitura e escrita ao bucket.

  4. 4

    Adicione o destino no Aktar

    Em Settings → Destinations → Add Destination, escolha Other S3-Compatible e informe os valores abaixo. Essa predefinição usa URLs no estilo virtual-hosted (bucket.endpoint). Se o seu servidor só aceita URLs no estilo path, escolha a predefinição MinIO.

  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
ProviderOther S3-Compatible
Endpointhttps://fsn1.your-objectstorage.comO endpoint S3 do seu provedor.
Regionfsn1A região ou localização do bucket.
Access Key ID…
Secret Access Key••••••••
Bucketyour-bucket
Public Base URLyour-bucket.fsn1.your-objectstorage.comOu uma CDN ou domínio personalizado na frente do bucket.

Dicas

  • Consulte a documentação do seu provedor para saber o endpoint exato da região escolhida.
  • Se o seu provedor oferece CDN ou domínios personalizados, use esse endereço como Public Base URL.

Solução de problemas

O Test Connection não consegue acessar o bucket

Confira o endpoint e a região. Se o provedor só aceita URLs no estilo path, troque a predefinição para MinIO.

Os links retornam 403

O bucket ainda não permite leitura pública. Veja erros de Access Denied.

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