S3 Compatible¶
Każdą usługę implementującą API S3 można zamontować jako dysk w systemie Windows. Pola połączenia są zawsze takie same — adres URL punktu końcowego, Access Key ID, Secret Access Key i bucket — dlatego ten jeden przewodnik obejmuje całą rodzinę usług S3.
Wiele z tych usług ma w RaiDrive własny, nazwany wpis na karcie Enterprise (Amazon S3, Cloudflare R2, Wasabi, Backblaze B2, …). Jeśli taki wpis istnieje, wybierz go — RaiDrive zna wtedy wzorzec punktu końcowego i listę regionów. Ogólnego wpisu S3 Compatible używaj dla wszystkich innych usług, w tym serwerów hostowanych samodzielnie.
Zanim zaczniesz¶
Przygotuj wcześniej:
- Access Key ID i Secret Access Key wydane przez usługę — każda usługa zgodna z S3 ma we własnej konsoli stronę zarządzania kluczami; poszczególne strony dostawców w tej sekcji wskazują dokładnie, gdzie ją znaleźć dla każdej nazwanej usługi.
- Adres URL punktu końcowego S3 usługi (zobacz tabelę poniżej).
- Niektóre usługi wymagają jednego dodatkowego identyfikatora — na przykład Cloudflare R2 wymaga ID konta, a Oracle — przestrzeni nazw magazynu obiektów.
Połączenie¶
- Kliknij Dodaj na pasku narzędzi.
- Wybierz Enterprise → nazwaną usługę lub S3 Compatible, jeśli usługi nie ma na liście.
- W przypadku ogólnego wpisu wpisz adres URL punktu końcowego (i, jeśli usługa tego wymaga, region).
- Wprowadź Access Key ID i Secret Access Key, a następnie kliknij przycisk Odśwież obok pola bucketu.
- Wybierz bucket i kliknij Połącz.
Ręczne wpisanie bucketu
Jeśli twój klucz nie może wyświetlać listy bucketów, zaznacz pole wyboru po lewej stronie pola bucketu i wpisz nazwę bucketu bezpośrednio.
Punkty końcowe¶
| Usługa | Wzorzec punktu końcowego | Regiony |
|---|---|---|
| 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 |
Amazon Simple Storage Service endpoints and quotas |
| Backblaze B2 | https://s3.<region>.backblazeb2.com |
Where are the Backblaze Cloud Storage Data Centers |
| Ceph (hostowany samodzielnie) | adres URL twojej bramy RADOS Gateway | — |
| Cloudflare R2 | https://<account-id>.r2.cloudflarestorage.com |
Data location |
| Cloudian (hostowany samodzielnie) | adres URL twojego serwera | — |
| DigitalOcean Spaces | https://<region>.digitaloceanspaces.com |
Spaces Availability |
| DreamHost | https://objects-us-east-1.dream.io lub https://s3.us-east-005.dream.io (zależnie od klastra) |
What DreamObjects hostname should I use to connect? |
| Garage (hostowany samodzielnie) | adres URL twojego serwera | — |
| IBM Cloud | https://s3.<region>.cloud-object-storage.appdomain.cloud |
Endpoints and storage locations |
| IDrive e2 | https://<host>.<region>.idrivee2-XX.com (wyświetlany w konsoli e2) |
Punkty końcowe regionów |
| 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 (hostowany samodzielnie) | adres URL twojego serwera | — |
| Naver Cloud Platform | https://<region>.object.ncloudstorage.com — region: kr, us, sg, de; jp: https://jp.object.ncpstorage.com |
Object Storage overview |
| Oracle Cloud | https://<namespace>.compat.objectstorage.<region>.oraclecloud.com |
Regions and Availability Domains |
| Storj | https://gateway.storjshare.io (jeden globalny punkt końcowy) |
Storj-hosted S3 Compatible Gateway |
| Synology C2 | https://<region>.s3.synologyc2.net |
Jak korzystać z narzędzi deweloperskich z 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 i inne | https://s3.<region>.scw.cloud — przez ogólny wpis S3 Compatible |
Object Storage - Concepts |
Ustawienia¶
| Ustawienie | Opis | Domyślnie |
|---|---|---|
| Punkt końcowy | Adres URL API S3 usługi | — |
| Region | Region uwierzytelniania; wymagany przez niektóre usługi (np. Garage, Scaleway) | puste |
| Access Key ID / Secret Access Key | Dane logowania wydane przez usługę | — |
| Bucket | Bucket do zamontowania (z listy lub wpisany ręcznie) | — |
| Tylko do odczytu | Blokuje zapis na zamontowanym dysku | wył. |
Działanie i ograniczenia¶
- RaiDrive weryfikuje punkt końcowy serwerów, które same się identyfikują: MinIO, Cloudian, Ceph i Garage są rozpoznawane po odpowiedziach serwera; IDrive e2, Akamai Linode i Synology C2 — po wzorcu nazwy hosta. Niepasujący punkt końcowy jest odrzucany z komunikatem „invalid endpoint”.
- Do serwerów hostowanych samodzielnie (MinIO, Cloudian, Ceph, Garage) RaiDrive łączy się z adresowaniem w stylu ścieżki (path-style); akceptowane są prywatne lub samopodpisane certyfikaty TLS.
- Semantyka S3 obowiązuje wszędzie: nie ma prawdziwych folderów — „foldery” to prefiksy kluczy — zobacz AWS: porządkowanie obiektów za pomocą folderów.
Rozwiązywanie problemów¶
| Objaw | Przyczyna | Rozwiązanie |
|---|---|---|
| „invalid endpoint” | Punkt końcowy nie pasuje do wybranej usługi | Sprawdź wzorzec w tabeli lub użyj ogólnego wpisu S3 Compatible |
| Lista bucketów jest pusta | Klucz nie może wyświetlać listy bucketów | Wpisz nazwę bucketu ręcznie |
| Błędy podpisu lub autoryzacji | Usługa wymaga jawnie podanego regionu | Wypełnij pole Region wartością z konsoli usługi |
| Błędy TLS na serwerze w sieci lokalnej | Samopodpisany certyfikat przy nazwanym wpisie usługi publicznej | Użyj wpisów dla serwerów hostowanych samodzielnie (MinIO/Cloudian/Ceph/Garage) lub S3 Compatible |