S3 Compatible¶
Qualquer serviço que implemente a API S3 pode ser montado como unidade do Windows. Os campos de ligação são sempre os mesmos — URL do endpoint, ID da chave de acesso, Chave de acesso secreta e um bucket — pelo que este guia único abrange toda a família S3.
Muitos destes serviços aparecem como entrada própria com nome no separador Enterprise do RaiDrive (Wasabi, Backblaze B2, Cloudflare R2, …). Escolha a entrada com nome quando existir — o RaiDrive fica então a conhecer por si o padrão do endpoint e a lista de regiões. Utilize a entrada genérica S3 Compatible para tudo o resto, incluindo servidores alojados por si.
Antes de começar¶
Prepare antecipadamente o seguinte:
- Um ID da chave de acesso e uma chave de acesso secreta emitidos pelo serviço — todos os serviços compatíveis com S3 têm uma página de gestão de chaves na sua própria consola; as páginas dedicadas de cada fornecedor nesta secção indicam exatamente onde, para cada serviço com nome.
- O URL do endpoint S3 do serviço (consulte a tabela abaixo).
- Alguns serviços precisam de um identificador adicional — por exemplo, o Cloudflare R2 precisa do seu Account ID e a Oracle precisa do seu namespace de armazenamento de objetos.
Ligar¶
- Clique em Adicionar na barra de ferramentas.
- Escolha Enterprise → o serviço com nome, ou S3 Compatible se não estiver na lista.
- Na entrada genérica, escreva o URL do endpoint em Ponto final (e, se o serviço o exigir, a Região).
- Introduza o ID da chave de acesso e a Chave de acesso secreta e, em seguida, clique no botão Atualizar junto ao campo do bucket.
- Selecione o Bucket e clique em Conectar.
Introdução manual do bucket
Se a sua chave não tiver permissão para listar buckets, assinale a caixa de verificação à esquerda do campo do bucket e escreva diretamente o nome do bucket.
Referência de endpoints¶
| Serviço | Padrão do endpoint |
|---|---|
| Wasabi | https://s3.<region>.wasabisys.com |
| Backblaze B2 | https://s3.<region>.backblazeb2.com |
| Cloudflare R2 | https://<account-id>.r2.cloudflarestorage.com |
| Storj | https://gateway.storjshare.io (endpoint global único) |
| DigitalOcean Spaces | https://<region>.digitaloceanspaces.com |
| Oracle Cloud | https://<namespace>.compat.objectstorage.<region>.oraclecloud.com |
| IBM Cloud | https://s3.<region>.cloud-object-storage.appdomain.cloud |
| Alibaba Cloud | https://oss-<region>.aliyuncs.com |
| Tencent Cloud | https://cos.<region>.myqcloud.com |
| Naver Cloud Platform | https://<region>.object.ncloudstorage.com — região: kr, us, sg, jp, de |
| Synology C2 | https://object.<region>.c2.synology.com |
| IDrive e2 | https://<host>.<region>.idrivee2-XX.com (apresentado na sua consola do e2) |
| Akamai Linode | https://<region>.linodeobjects.com |
| IONOS | https://s3.<region>.ionoscloud.com |
| DreamHost | https://objects-us-east-1.dream.io ou https://s3.us-east-005.dream.io (por cluster) |
| Leviia | https://s3.<region>.leviia.com |
| MEGA S4 | https://s3.<region>.s4.mega.io |
| MinIO (alojado por si) | o URL do seu servidor |
| Cloudian (alojado por si) | o URL do seu servidor |
| Ceph (alojado por si) | o URL do seu RADOS Gateway |
| Garage (alojado por si) | o URL do seu servidor |
| Scaleway e outros | https://s3.<region>.scw.cloud — através da entrada genérica S3 Compatible |
Definições¶
| Definição | Descrição | Predefinição |
|---|---|---|
| Ponto final | O URL da API S3 do serviço | — |
| Região | Região de autenticação; exigida por alguns serviços (p. ex., Garage, Scaleway) | vazio |
| ID da chave de acesso / Chave de acesso secreta | Credenciais emitidas pelo serviço | — |
| Bucket | O bucket a montar (lista ou introdução manual) | — |
| Somente leitura | Bloqueia a escrita na unidade montada | desativado |
Comportamento e limites¶
- O RaiDrive valida o endpoint dos servidores que se identificam a si próprios: MinIO, Cloudian, Ceph e Garage são reconhecidos pelas respostas do servidor; IDrive e2, Akamai Linode e Synology C2 pelo padrão do nome de anfitrião. Um endpoint que não corresponda é rejeitado com "invalid endpoint".
- Os servidores alojados por si (MinIO, Cloudian, Ceph, Garage) são acedidos em estilo de caminho (path-style), e são aceites certificados TLS privados/autoassinados.
- A semântica S3 aplica-se em todo o lado: não há pastas reais — as "pastas" são prefixos de chaves, pelo que mudar o nome de uma árvore de pastas grande é uma cópia seguida de eliminação de todos os objetos sob o prefixo — consulte AWS: organizar objetos com pastas.
Resolução de problemas¶
| Sintoma | Causa | Solução |
|---|---|---|
| "invalid endpoint" | O endpoint não corresponde ao serviço selecionado | Verifique o padrão na tabela, ou utilize a entrada genérica S3 Compatible |
| Lista de buckets vazia | A chave não consegue listar buckets | Utilize a introdução manual do bucket |
| Erros de assinatura / autorização | O serviço precisa de uma região explícita | Preencha o campo Região com o valor da consola do seu serviço |
| Erros de TLS num servidor da LAN | Certificado autoassinado numa entrada de serviço público com nome | Utilize as entradas para servidores alojados por si (MinIO/Cloudian/Ceph/Garage) ou S3 Compatible |