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.
| Automatycznie | Z ograniczonym kluczem | |
|---|---|---|
| Klucz | Dostęp do całego konta | Ograniczony do jednego bucketu |
| Bucket | Nubbo używa jednego z twoich lub tworzy nowy | Najpierw tworzysz go sam |
| CORS | Nubbo dodaje regułę za ciebie | Regułę dodajesz sam |
| Kiedy ją wybrać | Najszybsza droga | Gdy nie chcesz dawać dostępu do całego konta |
Połączenie automatyczne
Krok 1: utwórz klucz w Amazon S3
- Zaloguj się do konsoli AWS i otwórz IAM. Używaj użytkownika IAM, nigdy użytkownika root konta.
- Przejdź do Users i naciśnij Create user. Nadaj mu nazwę, na przykład
nubbo, i naciśnij Next. - W Set permissions wybierz Attach policies directly, wyszukaj i zaznacz AmazonS3FullAccess, a następnie utwórz użytkownika.
- Otwórz użytkownika, przejdź do karty Security credentials i w sekcji Access keys naciśnij Create access key.
- 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.
- Naciśnij Download .csv file. To jedyny moment, w którym AWS pozwala zobaczyć secret access key.
Krok 2: połącz bucket w Nubbo
W Nubbo otwórz Buckety i naciśnij Połącz bucket. Wybierz Amazon S3 i naciśnij Dalej.

Wybierz Automatycznie i naciśnij Dalej.

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.

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.

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.

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
- 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.
- W IAM utwórz użytkownika bez uprawnień (Users, Create user).
- Otwórz użytkownika, kartę Permissions, Add permissions, Create inline policy. Przełącz się na edytor JSON, wklej tę politykę, zastępując
YOUR-BUCKETnazwą swojego bucketu, i zapisz ją pod wybraną nazwą. - 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
- W sekcji Buckety naciśnij Połącz bucket, wybierz Amazon S3, a potem Z ograniczonym kluczem.
- Prześlij plik CSV z kluczem lub wklej jego zawartość i wybierz region bucketu. Naciśnij Sprawdź klucz.
- Wpisz dokładną nazwę bucketu i naciśnij Sprawdź dostęp.
- 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.
- W konsoli S3 otwórz bucket i przejdź do karty Permissions.
- Przewiń w dół do Cross-origin resource sharing (CORS) i naciśnij Edit.
- Wklej regułę i naciśnij Save changes.
[
{
"AllowedHeaders": ["*"],
"AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
"AllowedOrigins": ["https://nubbo.app"],
"ExposeHeaders": ["ETag"],
"MaxAgeSeconds": 3600
}
]

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 Nubbo | Co 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.