S3 Compatible¶
Qualquer serviço que implemente a API S3 pode ser montado como uma unidade do Windows. Os campos de conexão são sempre os mesmos — URL do ponto de extremidade, ID da Chave de Acesso, Chave de Acesso Secreta e um bucket — então este único guia cobre toda a família S3.
Muitos desses serviços aparecem como sua própria entrada nomeada na aba Enterprise do RaiDrive (Wasabi, Backblaze B2, Cloudflare R2, …). Escolha a entrada nomeada quando ela existir — assim o RaiDrive já conhece o padrão de ponto de extremidade e a lista de regiões para você. Use a entrada genérica S3 Compatible para qualquer outro caso, incluindo servidores autogerenciados.
Antes de começar¶
Prepare o seguinte com antecedência:
- Um Access Key ID e um Secret Access Key emitidos pelo serviço — todo serviço compatível com S3 tem uma página de gerenciamento de chaves no seu próprio console; as páginas dedicadas de provedores nesta seção dizem exatamente onde encontrá-las para cada serviço nomeado.
- A URL do ponto de extremidade S3 do serviço (veja a tabela abaixo).
- Alguns serviços precisam de um identificador extra — por exemplo, o Cloudflare R2 precisa do seu ID da Conta e a Oracle precisa do seu namespace de object storage.
Conectar¶
- Clique em Adicionar na barra de ferramentas.
- Escolha Enterprise → o serviço nomeado, ou S3 Compatible se ele não estiver listado.
- Para a entrada genérica, digite a URL do ponto de extremidade (e, se o serviço exigir, a região).
- Informe o ID da Chave de Acesso e a Chave de Acesso Secreta, e clique no botão Atualizar ao lado do campo de bucket.
- Selecione o bucket e clique em Conectar.
Entrada manual de bucket
Se sua chave não tiver permissão para listar buckets, marque a caixa de seleção à esquerda do campo de bucket e digite o nome do bucket diretamente.
Referência de pontos de extremidade¶
| Serviço | Padrão de ponto de extremidade |
|---|---|
| Wasabi | https://s3.<região>.wasabisys.com |
| Backblaze B2 | https://s3.<região>.backblazeb2.com |
| Cloudflare R2 | https://<id-da-conta>.r2.cloudflarestorage.com |
| Storj | https://gateway.storjshare.io (ponto de extremidade global único) |
| DigitalOcean Spaces | https://<região>.digitaloceanspaces.com |
| Oracle Cloud | https://<namespace>.compat.objectstorage.<região>.oraclecloud.com |
| IBM Cloud | https://s3.<região>.cloud-object-storage.appdomain.cloud |
| Alibaba Cloud | https://oss-<região>.aliyuncs.com |
| Tencent Cloud | https://cos.<região>.myqcloud.com |
| Naver Cloud Platform | https://<região>.object.ncloudstorage.com — região: kr, us, sg, jp, de |
| Synology C2 | https://object.<região>.c2.synology.com |
| IDrive e2 | https://<host>.<região>.idrivee2-XX.com (exibido no seu console e2) |
| Akamai Linode | https://<região>.linodeobjects.com |
| IONOS | https://s3.<região>.ionoscloud.com |
| DreamHost | https://objects-us-east-1.dream.io ou https://s3.us-east-005.dream.io (por cluster) |
| Leviia | https://s3.<região>.leviia.com |
| MEGA S4 | https://s3.<região>.s4.mega.io |
| MinIO (autogerenciado) | a URL do seu servidor |
| Cloudian (autogerenciado) | a URL do seu servidor |
| Ceph (autogerenciado) | a URL do seu RADOS Gateway |
| Garage (autogerenciado) | a URL do seu servidor |
| Scaleway e outros | https://s3.<região>.scw.cloud — pela entrada genérica S3 Compatible |
Configurações¶
| Configuração | Descrição | Padrão |
|---|---|---|
| Ponto de extremidade | A URL da API S3 do serviço | — |
| Região | Região de autenticação; exigida por alguns serviços (por exemplo, Garage, Scaleway) | vazio |
| ID da Chave de Acesso / Chave de Acesso Secreta | Credenciais emitidas pelo serviço | — |
| Bucket | O bucket a montar (lista ou entrada manual) | — |
| Somente leitura | Bloqueia gravações na unidade montada | desativado |
Comportamento e limites¶
- O RaiDrive valida o ponto de extremidade em busca de servidores autoidentificáveis: MinIO, Cloudian, Ceph e Garage são reconhecidos por suas respostas de servidor; IDrive e2, Akamai Linode e Synology C2 pelo padrão do nome do host. Um ponto de extremidade incompatível é rejeitado com "ponto de extremidade inválido".
- Servidores autogerenciados (MinIO, Cloudian, Ceph, Garage) são acessados no estilo path-style, e certificados TLS privados/ autoassinados são aceitos.
- A semântica do S3 se aplica em todos os lugares: sem pastas reais — "pastas" são prefixos de chave, então renomear uma árvore de pastas grande é uma cópia-e-exclusão de todo objeto sob o prefixo — veja AWS: organizando objetos usando pastas.
Solução de problemas¶
| Sintoma | Causa | Correção |
|---|---|---|
| "ponto de extremidade inválido" | O ponto de extremidade não corresponde ao serviço selecionado | Verifique o padrão na tabela, ou use a entrada genérica S3 Compatible |
| Lista de buckets vazia | A chave não consegue listar buckets | Use a entrada manual de bucket |
| Erros de assinatura / autorização | O serviço exige uma região explícita | Preencha o campo Região com o valor do console do seu serviço |
| Erros de TLS em um servidor de LAN | Certificado autoassinado em uma entrada de serviço público nomeada | Use as entradas autogerenciadas (MinIO/Cloudian/Ceph/Garage) ou S3 Compatible |