S3 Compatible¶
Qualsiasi servizio che implementi l'API S3 può essere montato come unità di Windows. I campi di connessione sono sempre gli stessi (URL dell'endpoint, ID chiave di accesso, Chiave segreta di accesso e un bucket), quindi questa sola guida copre l'intera famiglia S3.
Molti di questi servizi compaiono come voce dedicata con il proprio nome nella scheda Enterprise di RaiDrive (Amazon S3, Cloudflare R2, Wasabi, Backblaze B2, …). Scegli la voce dedicata quando esiste: in questo modo RaiDrive conosce già lo schema dell'endpoint e l'elenco delle regioni. Usa la voce generica S3 Compatible per tutto il resto, inclusi i server self-hosted.
Prima di iniziare¶
Prepara in anticipo quanto segue:
- Un ID chiave di accesso e una Chiave segreta di accesso rilasciati dal servizio: ogni servizio compatibile con S3 ha una pagina di gestione delle chiavi nella propria console; le pagine dedicate ai singoli provider in questa sezione indicano esattamente dove trovarla per ogni servizio con voce dedicata.
- L'URL dell'endpoint S3 del servizio (consulta la tabella più avanti).
- Alcuni servizi richiedono un identificatore aggiuntivo: ad esempio Cloudflare R2 richiede il tuo ID account e Oracle il tuo spazio dei nomi dell'object storage.
Connessione¶
- Fai clic su Aggiungi nella barra degli strumenti.
- Scegli Enterprise → il servizio con voce dedicata, oppure S3 Compatible se non è in elenco.
- Per la voce generica, digita l'URL dell'endpoint (e, se il servizio lo richiede, la Regione).
- Inserisci l'ID chiave di accesso e la Chiave segreta di accesso, quindi fai clic sul pulsante Aggiorna accanto al campo del bucket.
- Seleziona il Bucket e fai clic su Connetti.
Inserimento manuale del bucket
Se la tua chiave non è autorizzata a elencare i bucket, seleziona la casella di controllo a sinistra del campo del bucket e digita direttamente il nome del bucket.
Riferimento degli endpoint¶
| Servizio | Schema dell'endpoint | Regioni |
|---|---|---|
| Akamai Linode | https://<region>.linodeobjects.com |
Use URLs for access |
| Alibaba Cloud | https://oss-<region>.aliyuncs.com |
Regions and endpoints |
| Amazon S3 | https://s3.<region>.amazonaws.com |
Endpoint e quote di Amazon Simple Storage Service |
| Backblaze B2 | https://s3.<region>.backblazeb2.com |
Where are the Backblaze Cloud Storage Data Centers |
| Ceph (self-hosted) | l'URL del tuo RADOS Gateway | — |
| Cloudflare R2 | https://<account-id>.r2.cloudflarestorage.com |
Data location |
| Cloudian (self-hosted) | l'URL del tuo server | — |
| DigitalOcean Spaces | https://<region>.digitaloceanspaces.com |
Spaces Availability |
| DreamHost | https://objects-us-east-1.dream.io o https://s3.us-east-005.dream.io (a seconda del cluster) |
What DreamObjects hostname should I use to connect? |
| Garage (self-hosted) | l'URL del tuo server | — |
| IBM Cloud | https://s3.<region>.cloud-object-storage.appdomain.cloud |
Endpoint e ubicazioni di archiviazione |
| IDrive e2 | https://<host>.<region>.idrivee2-XX.com (indicato nella tua console e2) |
Endpoint delle regioni |
| IONOS | https://s3.<region>.ionoscloud.com |
Endpoints |
| Leviia | https://s3.<region>.leviia.com |
— |
| MEGA S4 | https://s3.<region>.megas4.com |
MEGA S4 endpoint URLs |
| MinIO (self-hosted) | l'URL del tuo server | — |
| Naver Cloud Platform | https://<region>.object.ncloudstorage.com; regione: kr, us, sg, de; jp: https://jp.object.ncpstorage.com |
Object Storage overview |
| Oracle Cloud | https://<namespace>.compat.objectstorage.<region>.oraclecloud.com |
Dominio aree e disponibilità |
| Storj | https://gateway.storjshare.io (unico endpoint globale) |
Storj-hosted S3 Compatible Gateway |
| Synology C2 | https://<region>.s3.synologyc2.net |
Come utilizzare gli strumenti di sviluppo con C2 Object Storage |
| Tencent Cloud | https://cos.<region>.myqcloud.com |
Regions and Access Endpoints |
| Wasabi | https://s3.<region>.wasabisys.com |
Service URLs for Wasabi's Storage Regions |
| Scaleway e altri | https://s3.<region>.scw.cloud: tramite la voce generica S3 Compatible |
Object Storage - Concepts |
Impostazioni¶
| Impostazione | Descrizione | Predefinito |
|---|---|---|
| Endpoint | L'URL dell'API S3 del servizio | — |
| Regione | Regione di autenticazione; richiesta da alcuni servizi (ad es. Garage, Scaleway) | vuoto |
| ID chiave di accesso / Chiave segreta di accesso | Credenziali rilasciate dal servizio | — |
| Bucket | Il bucket da montare (dall'elenco o inserito manualmente) | — |
| Sola lettura | Blocca la scrittura sull'unità montata | disattivata |
Comportamento e limiti¶
- RaiDrive convalida l'endpoint per i server che si identificano: MinIO, Cloudian, Ceph e Garage vengono riconosciuti dalle risposte del server; IDrive e2, Akamai Linode e Synology C2 dallo schema del nome host. Un endpoint non corrispondente viene rifiutato con "invalid endpoint".
- Ai server self-hosted (MinIO, Cloudian, Ceph, Garage) si accede con l'indirizzamento path-style e vengono accettati certificati TLS privati o autofirmati.
- La semantica S3 vale ovunque: non esistono vere cartelle, le "cartelle" sono prefissi delle chiavi; consulta AWS: organizzare gli oggetti con le cartelle.
Risoluzione dei problemi¶
| Sintomo | Causa | Soluzione |
|---|---|---|
| "invalid endpoint" | L'endpoint non corrisponde al servizio selezionato | Controlla lo schema nella tabella, oppure usa la voce generica S3 Compatible |
| Elenco dei bucket vuoto | La chiave non può elencare i bucket | Usa l'inserimento manuale del bucket |
| Errori di firma / autorizzazione | Il servizio richiede una regione esplicita | Compila il campo Regione con il valore indicato nella console del servizio |
| Errori TLS su un server nella LAN | Certificato autofirmato su una voce dedicata a un servizio pubblico | Usa le voci self-hosted (MinIO/Cloudian/Ceph/Garage) oppure S3 Compatible |