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 (Amazon S3, Cloudflare R2, Wasabi, Backblaze B2, …). 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 ID da Chave de Acesso e uma Chave de Acesso Secreta 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 | Regiões |
|---|---|---|
| Akamai Linode | https://<região>.linodeobjects.com |
Use URLs for access |
| Alibaba Cloud | https://oss-<região>.aliyuncs.com |
Regions and endpoints |
| Amazon S3 | https://s3.<região>.amazonaws.com |
Endpoints e cotas de Amazon Simple Storage Service |
| Backblaze B2 | https://s3.<região>.backblazeb2.com |
Where are the Backblaze Cloud Storage Data Centers |
| Ceph (autogerenciado) | a URL do seu RADOS Gateway | — |
| Cloudflare R2 | https://<id-da-conta>.r2.cloudflarestorage.com |
Data location |
| Cloudian (autogerenciado) | a URL do seu servidor | — |
| DigitalOcean Spaces | https://<região>.digitaloceanspaces.com |
Spaces Availability |
| DreamHost | https://objects-us-east-1.dream.io ou https://s3.us-east-005.dream.io (por cluster) |
What DreamObjects hostname should I use to connect? |
| Garage (autogerenciado) | a URL do seu servidor | — |
| IBM Cloud | https://s3.<região>.cloud-object-storage.appdomain.cloud |
Terminais e locais de armazenamento |
| IDrive e2 | https://<host>.<região>.idrivee2-XX.com (exibido no seu console e2) |
Pontos de extremidade de região |
| IONOS | https://s3.<região>.ionoscloud.com |
Endpoints |
| Leviia | https://s3.<região>.leviia.com |
— |
| MEGA S4 | https://s3.<região>.megas4.com |
MEGA S4 endpoint URLs |
| MinIO (autogerenciado) | a URL do seu servidor | — |
| Naver Cloud Platform | https://<região>.object.ncloudstorage.com — região: kr, us, sg, de; jp: https://jp.object.ncpstorage.com |
Object Storage overview |
| Oracle Cloud | https://<namespace>.compat.objectstorage.<região>.oraclecloud.com |
Regiões e Domínios de Disponibilidade |
| Storj | https://gateway.storjshare.io (ponto de extremidade global único) |
Storj-hosted S3 Compatible Gateway |
| Synology C2 | https://<região>.s3.synologyc2.net |
How to use development tools with C2 Object Storage |
| Tencent Cloud | https://cos.<região>.myqcloud.com |
Regions and Access Endpoints |
| Wasabi | https://s3.<região>.wasabisys.com |
Service URLs for Wasabi's Storage Regions |
| Scaleway e outros | https://s3.<região>.scw.cloud — pela entrada genérica S3 Compatible |
Object Storage - Concepts |
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 com endereçamento 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 — 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 |