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 (Wasabi, Backblaze B2, Cloudflare R2, …). Jeśli taki wpis istnieje, wybierz go — RaiDrive zna wtedy za ciebie 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 |
|---|---|
| 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 (jeden globalny punkt końcowy) |
| 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 — region: kr, us, sg, jp, de |
| Synology C2 | https://object.<region>.c2.synology.com |
| IDrive e2 | https://<host>.<region>.idrivee2-XX.com (wyświetlany w konsoli e2) |
| Akamai Linode | https://<region>.linodeobjects.com |
| IONOS | https://s3.<region>.ionoscloud.com |
| DreamHost | https://objects-us-east-1.dream.io lub https://s3.us-east-005.dream.io (zależnie od klastra) |
| Leviia | https://s3.<region>.leviia.com |
| MEGA S4 | https://s3.<region>.s4.mega.io |
| MinIO (hostowany samodzielnie) | adres URL twojego serwera |
| Cloudian (hostowany samodzielnie) | adres URL twojego serwera |
| Ceph (hostowany samodzielnie) | adres URL twojej bramy RADOS Gateway |
| Garage (hostowany samodzielnie) | adres URL twojego serwera |
| Scaleway i inne | https://s3.<region>.scw.cloud — przez ogólny wpis S3 Compatible |
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, więc zmiana nazwy dużego drzewa folderów oznacza skopiowanie i usunięcie każdego obiektu pod danym prefiksem — 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 |