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 del punto finale, 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 (Wasabi, Backblaze B2, Cloudflare R2, …). Scegli la voce dedicata quando esiste: in questo modo RaiDrive conosce già lo schema del punto finale 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 del punto finale 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 del punto finale (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 di aggiornamento 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 dei punti finali¶
| Servizio | Schema del punto finale |
|---|---|
| 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 (unico punto finale globale) |
| 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; regione: kr, us, sg, jp, de |
| Synology C2 | https://object.<region>.c2.synology.com |
| IDrive e2 | https://<host>.<region>.idrivee2-XX.com (indicato nella tua console e2) |
| Akamai Linode | https://<region>.linodeobjects.com |
| IONOS | https://s3.<region>.ionoscloud.com |
| DreamHost | https://objects-us-east-1.dream.io o https://s3.us-east-005.dream.io (a seconda del cluster) |
| Leviia | https://s3.<region>.leviia.com |
| MEGA S4 | https://s3.<region>.s4.mega.io |
| MinIO (self-hosted) | l'URL del tuo server |
| Cloudian (self-hosted) | l'URL del tuo server |
| Ceph (self-hosted) | l'URL del tuo RADOS Gateway |
| Garage (self-hosted) | l'URL del tuo server |
| Scaleway e altri | https://s3.<region>.scw.cloud: tramite la voce generica S3 Compatible |
Impostazioni¶
| Impostazione | Descrizione | Predefinito |
|---|---|---|
| Punto finale | 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 il punto finale 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 punto finale 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, quindi rinominare un albero di cartelle di grandi dimensioni significa copiare ed eliminare ogni oggetto con quel prefisso; consulta AWS: organizzare gli oggetti con le cartelle.
Risoluzione dei problemi¶
| Sintomo | Causa | Soluzione |
|---|---|---|
| "invalid endpoint" | Il punto finale 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 |