Poradniki

Menedżer plików dla Amazon S3: połącz go z Nubbo

Jak połączyć bucket Amazon S3 z Nubbo: potrzebny klucz IAM, kreator krok po kroku, reguła CORS i co zrobić, gdy coś pójdzie nie tak.

Nubbo łączy się z Amazon S3 za pomocą klucza dostępu IAM. W kilka minut twój bucket trafia do eksploratora plików z bezpośrednim przesyłaniem, linkami udostępniającymi i galeriami, bez upubliczniania czegokolwiek. Ten poradnik prowadzi krok po kroku przez kreator Nubbo, obiema ścieżkami: automatyczną lub z kluczem ograniczonym do jednego bucketu.

Co zyskujesz

  • Przeglądasz bucket jak dysk: foldery, widoki, wyszukiwanie, kosz, etykiety i ulubione.
  • Przesyłasz i pobierasz pliki bezpośrednio między przeglądarką a Amazon S3. Pliki nigdy nie przechodzą przez serwery Nubbo.
  • Udostępniasz pliki i foldery z hasłem, datą wygaśnięcia i limitem pobrań, odbierasz pliki do swojego bucketu i tworzysz galerie.
  • Twoje klucze są przechowywane w postaci zaszyfrowanej algorytmem AES-256-GCM, a bucket możesz odłączyć w każdej chwili.

Zanim zaczniesz

Potrzebujesz konta w Amazon S3 i konta w Nubbo. Każdy połączony bucket wlicza się do limitu twojego planu: plan Bezpłatny pozwala na 2, Personal na 5, a Pro nie ma limitu. Niektóre regiony AWS są domyślnie wyłączone i trzeba je włączyć na koncie, zanim się z nich skorzysta (na przykład Mediolan, Zurych czy Kapsztad). Jeśli zamierzasz utworzyć bucket w jednym z nich, najpierw go włącz. Nie trzeba wyłączać Block Public Access: Nubbo utrzymuje bucket jako prywatny.

Wybierz sposób połączenia

Kreator Nubbo oferuje dwie ścieżki. Obie kończą się tak samo: bucket jest połączony i gotowy do przesyłania z przeglądarki.

AutomatycznieZ ograniczonym kluczem
KluczDostęp do całego kontaOgraniczony do jednego bucketu
BucketNubbo używa jednego z twoich lub tworzy nowyNajpierw tworzysz go sam
CORSNubbo dodaje regułę za ciebieRegułę dodajesz sam
Kiedy ją wybraćNajszybsza drogaGdy nie chcesz dawać dostępu do całego konta

Połączenie automatyczne

Krok 1: utwórz klucz w Amazon S3

  1. Zaloguj się do konsoli AWS i otwórz IAM. Używaj użytkownika IAM, nigdy użytkownika root konta.
  2. Przejdź do Users i naciśnij Create user. Nadaj mu nazwę, na przykład nubbo, i naciśnij Next.
  3. W Set permissions wybierz Attach policies directly, wyszukaj i zaznacz AmazonS3FullAccess, a następnie utwórz użytkownika.
  4. Otwórz użytkownika, przejdź do karty Security credentials i w sekcji Access keys naciśnij Create access key.
  5. Jako przypadek użycia wybierz Application running outside AWS (lub Other, jeśli go nie ma na liście) i naciśnij Next oraz Create access key.
  6. Naciśnij Download .csv file. To jedyny moment, w którym AWS pozwala zobaczyć secret access key.

Krok 2: połącz bucket w Nubbo

  1. W Nubbo otwórz Buckety i naciśnij Połącz bucket. Wybierz Amazon S3 i naciśnij Dalej.

    Krok Dostawca w kreatorze Nubbo z wybranym Amazon S3 Krok Dostawca w kreatorze Nubbo z wybranym Amazon S3
  2. Wybierz Automatycznie i naciśnij Dalej.

    Krok Sposób połączenia z opcjami Automatycznie i Z ograniczonym kluczem Krok Sposób połączenia z opcjami Automatycznie i Z ograniczonym kluczem
  3. W kroku Twój klucz naciśnij Prześlij plik i wybierz pobrany plik CSV albo wklej jego zawartość do pola tekstowego. Nubbo odczytuje access key i secret, więc nie musisz przepisywać ich ręcznie. Sprawdź, czy Region to region twoich bucketów. Naciśnij Sprawdź klucz. Nubbo sprawdza, czy klucz działa i czy ma dostęp do całego konta.

    Krok Twój klucz dla Amazon S3 ze skróconym przewodnikiem i polami klucza Krok Twój klucz dla Amazon S3 ze skróconym przewodnikiem i polami klucza
  4. Wybierz jeden ze swoich bucketów i naciśnij Użyj tego bucketu albo zaznacz Utwórz nowy, wpisz nazwę (i wybierz region, jeśli o niego poprosi) i naciśnij Utwórz i przygotuj. Nubbo dodaje do bucketu regułę CORS, która pozwala na przesyłanie i pobieranie tylko z aplikacji, i zachowuje reguły, które bucket już ma.

    Krok Twój bucket z listą bucketów i opcją Utwórz nowy Krok Twój bucket z listą bucketów i opcją Utwórz nowy
  5. Przejrzyj trzy weryfikacje, jeśli chcesz, zmień pole Nazwa w Nubbo i naciśnij Zakończ. Bucket pojawi się w sekcji Buckety i możesz go otworzyć w eksploratorze.

    Krok Gotowe z weryfikacją połączenia, bucketu i CORS Krok Gotowe z weryfikacją połączenia, bucketu i CORS

Jeśli Nubbo nie może dodać reguły CORS twoim kluczem, kreator przeniesie cię do kroku CORS. Wtedy postępuj według sekcji Dodaj regułę CORS.

Połączenie z ograniczonym kluczem

Krok 1: przygotuj bucket i klucz w Amazon S3

  1. W konsoli wybierz region na górnym pasku, otwórz S3 i w sekcji General purpose buckets naciśnij Create bucket. Nadaj mu nazwę (od 3 do 63 znaków: małe litery, cyfry, kropki i łączniki) i utwórz go z włączonym Block Public Access.
  2. W IAM utwórz użytkownika bez uprawnień (Users, Create user).
  3. Otwórz użytkownika, kartę Permissions, Add permissions, Create inline policy. Przełącz się na edytor JSON, wklej tę politykę, zastępując YOUR-BUCKET nazwą swojego bucketu, i zapisz ją pod wybraną nazwą.
  4. Utwórz klucz w Security credentials, Create access key, tak jak w połączeniu automatycznym, i pobierz plik CSV.
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": ["s3:ListBucket", "s3:GetBucketLocation"],
      "Resource": "arn:aws:s3:::YOUR-BUCKET"
    },
    {
      "Effect": "Allow",
      "Action": [
        "s3:GetObject",
        "s3:PutObject",
        "s3:DeleteObject",
        "s3:AbortMultipartUpload",
        "s3:ListMultipartUploadParts"
      ],
      "Resource": "arn:aws:s3:::YOUR-BUCKET/*"
    }
  ]
}

Krok 2: połącz bucket w Nubbo

  1. W sekcji Buckety naciśnij Połącz bucket, wybierz Amazon S3, a potem Z ograniczonym kluczem.
  2. Prześlij plik CSV z kluczem lub wklej jego zawartość i wybierz region bucketu. Naciśnij Sprawdź klucz.
  3. Wpisz dokładną nazwę bucketu i naciśnij Sprawdź dostęp.
  4. Kreator przejdzie do kroku CORS z regułą, którą musisz dodać.

Dodaj regułę CORS

Reguła CORS pozwala przeglądarce przesyłać i pobierać pliki z twojego bucketu na https://nubbo.app. To ta sama reguła, którą kreator pokazuje w kroku CORS.

  1. W konsoli S3 otwórz bucket i przejdź do karty Permissions.
  2. Przewiń w dół do Cross-origin resource sharing (CORS) i naciśnij Edit.
  3. Wklej regułę i naciśnij Save changes.
[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
    "AllowedOrigins": ["https://nubbo.app"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]
Krok CORS z regułą do dodania do bucketu Krok CORS z regułą do dodania do bucketu

Po zapisaniu wróć do Nubbo i naciśnij Dodane, sprawdź. Niektórzy dostawcy potrzebują minuty, aby ją zastosować. Jeśli twój klucz może zmieniać CORS, Spróbuj skonfigurować za mnie zrobi to za ciebie.

Jeśli coś pójdzie nie tak

Komunikat w NubboCo zrobić
„Nieprawidłowe dane uwierzytelniające. Sprawdź access key i secret access key.”Skopiuj ponownie oba klucze, bez spacji na początku i na końcu.
„Ten klucz wydaje się ograniczony do jednego bucketu. Możesz kontynuować ścieżką ograniczoną albo utworzyć klucz z pełnym dostępem.”Naciśnij Kontynuuj z ograniczonym kluczem albo utwórz klucz z dostępem do całego konta i naciśnij Wypróbuj inny klucz.
„Nie znaleziono bucketu. Sprawdź nazwę i region.”Sprawdź dokładną nazwę bucketu i czy wybrany region to region bucketu.
„Twój klucz nie ma uprawnień do tworzenia bucketów.”Użyj klucza z pełnym dostępem albo utwórz bucket w swoim panelu i naciśnij Mam go już w swoim panelu.
„Ta nazwa jest już używana u tego dostawcy; spróbuj innej.”Nazwy bucketów są unikalne w obrębie całego dostawcy: wybierz inną.
„Twój klucz nie ma uprawnień, aby to skonfigurować.”Dodaj regułę CORS ręcznie, tak jak opisano powyżej.
„Jeszcze nie działa. Przejrzyj regułę i sprawdź ponownie; niektórzy dostawcy potrzebują minuty, aby ją zastosować.”Sprawdź, czy origin to dokładnie https://nubbo.app bez ukośnika na końcu, odczekaj minutę i sprawdź ponownie.
„Ten bucket jest już używany.”Ten bucket jest już połączony w Nubbo, na twoim koncie lub na innym.
„Bucket znajduje się w innym regionie. Sprawdź skonfigurowany region.”W kroku Twój klucz wybierz region, w którym znajduje się bucket.
„Nie znaleźliśmy kluczy w tym pliku; wklej je ręcznie.”Prześlij plik CSV pobrany przy tworzeniu klucza albo wklej jego zawartość bez zmian.

Ile to kosztuje

Amazon S3 pobiera opłaty za przechowywanie, żądania i transfer danych na zewnątrz. Wyjaśniamy to na przykładach w artykule Cennik Amazon S3.

Najczęściej zadawane pytania

Czy muszę upublicznić bucket S3, aby korzystać z Nubbo?

Nie. Nubbo utrzymuje bucket jako prywatny, a Block Public Access może pozostać włączone. Przesyłanie i pobieranie korzysta z podpisanych adresów URL (presigned URL), które wygasają.

Jakich uprawnień potrzebuje klucz AWS?

Na ścieżce automatycznej polityki AmazonS3FullAccess. Z ograniczonym kluczem wystarczy polityka inline, która daje dostęp tylko do twojego bucketu: listowanie, odczyt, zapis i usuwanie obiektów.

Czy mogę użyć kluczy użytkownika root AWS?

To nie jest dobry pomysł i AWS to odradza. Utwórz użytkownika IAM tylko dla Nubbo; potem możesz dezaktywować jego klucz, nie ruszając niczego innego.

Dlaczego Nubbo nie ma pól na klucz AWS?

Bo AWS przekazuje klucz w pliku CSV. Nubbo odczytuje go bezpośrednio: przesyłasz go lub wklejasz jego zawartość i nigdy nie przepisujesz secret ręcznie.

Czy mogę połączyć kilka bucketów S3?

Tak. Każdy bucket wlicza się do limitu twojego planu: plan Bezpłatny pozwala na 2, Personal na 5, a Pro nie ma limitu. Buckety mogą pochodzić z różnych kont AWS.

Źródła

Ceny i limity pochodzą z poniższych oficjalnych stron. Dostawcy je zmieniają, więc sprawdź je, zanim się zdecydujesz.