Ghiduri

Manager de fișiere pentru MinIO și S3 găzduit propriu: conectează-l la Nubbo

Cum conectezi la Nubbo propria stocare compatibilă S3, ca MinIO, Ceph sau SeaweedFS: endpoint, cheie, regiune, CORS și ce faci dacă eșuează.

Nubbo se conectează la orice stocare compatibilă S3 care semnează cu Signature V4, cum ar fi MinIO, Ceph sau SeaweedFS, pe propriul tău server sau la alt furnizor. Ai nevoie doar de URL-ul endpointului, de o cheie și de regiune. Acest ghid urmează pas cu pas asistentul Nubbo, pe ambele căi: automată sau cu o cheie limitată la un singur bucket.

Ce obții

  • Explorezi bucketul ca pe un drive: foldere, vizualizări, căutare, coș de gunoi, etichete și favorite.
  • Încarci și descarci fișiere direct între browserul tău și serverul tău. Fișierele nu trec niciodată prin serverele Nubbo.
  • Partajezi fișiere și foldere cu parolă, dată de expirare și limită de descărcări, primești fișiere în bucket și creezi galerii.
  • Cheile tale sunt păstrate criptate cu AES-256-GCM și poți deconecta bucketul oricând.

Înainte să începi

Ai nevoie de o stocare compatibilă S3 și de un cont Nubbo. Fiecare bucket pe care îl conectezi contează pentru limita planului tău: Gratuit permite 2, Personal 5, iar Pro nu are limită. Endpointul trebuie să fie un URL public la care pot ajunge atât serverele Nubbo, cât și browserul, și are nevoie de HTTPS, pentru că browserul nu încarcă conținut HTTP de pe https://nubbo.app. Nubbo respinge endpointurile care indică spre adrese private sau locale. Dacă serverul tău nu are regiuni, lasă us-east-1.

Alege cum te conectezi

Asistentul Nubbo îți oferă două căi. Ambele se termină la fel: bucketul conectat și pregătit pentru încărcări din browser.

AutomatCu o cheie limitată
CheieAcces la tot contulLimitată la un singur bucket
BucketNubbo folosește unul de-al tău sau creează unulÎl creezi tu mai întâi
CORSNubbo adaugă regula pentru tineAdaugi tu regula
Când o alegiCea mai rapidă caleCând nu vrei să dai acces la tot contul

Conectare automată

Pasul 1: creează cheia pe serverul tău

  1. Verifică dacă serverul tău expune API-ul S3 cu semnături V4 la un URL HTTPS public, de exemplu https://s3.your-domain.com.
  2. Creează o cheie care poate crea bucketuri și le poate modifica CORS.
  3. Notează URL-ul endpointului și regiunea. Dacă serverul tău nu are regiuni, folosește us-east-1.

Pasul 2: conectează bucketul în Nubbo

  1. În Nubbo, deschide Bucketuri și apasă Conectează bucket. Alege S3 personalizat / găzduit propriu și apasă Continuă.

    Pasul Provider din asistentul Nubbo cu S3 personalizat / găzduit propriu selectat Pasul Provider din asistentul Nubbo cu S3 personalizat / găzduit propriu selectat
  2. Alege Automat și apasă Continuă.

    Pasul Mod de conectare cu opțiunile Automat și Cu o cheie limitată Pasul Mod de conectare cu opțiunile Automat și Cu o cheie limitată
  3. La pasul Cheia ta, lipește cheia de acces, cheia secretă, URL-ul endpointului și regiunea. Apasă Verifică cheia. Nubbo verifică dacă cheia funcționează și dacă are acces la tot contul.

    Pasul Cheia ta pentru S3 personalizat / găzduit propriu cu ghidul rapid și câmpurile cheii Pasul Cheia ta pentru S3 personalizat / găzduit propriu cu ghidul rapid și câmpurile cheii
  4. Alege unul dintre bucketurile tale și apasă Folosește acest bucket sau selectează Creează unul nou, scrie un nume (și alege regiunea, dacă ți se cere) și apasă Creează și pregătește. Nubbo adaugă în bucket o regulă CORS care permite încărcări și descărcări doar din aplicație și păstrează regulile pe care le are deja.

    Pasul Bucketul tău cu lista de bucketuri și opțiunea Creează unul nou Pasul Bucketul tău cu lista de bucketuri și opțiunea Creează unul nou
  5. Verifică cele trei confirmări, schimbă Nume în Nubbo dacă vrei și apasă Finalizează. Bucketul apare în Bucketuri și îl poți deschide în explorator.

    Pasul Gata cu verificările pentru conexiune, bucket și CORS Pasul Gata cu verificările pentru conexiune, bucket și CORS

Dacă Nubbo nu poate adăuga regula CORS cu cheia ta, asistentul te duce la pasul CORS. Urmează atunci secțiunea Adaugă regula CORS.

Conectare cu o cheie limitată

Pasul 1: pregătește bucketul și cheia pe serverul tău

  1. Creează bucketul pe serverul tău (în MinIO, de exemplu, cu mc mb).
  2. Creează o cheie cu permisiuni de citire și scriere pe acel bucket.
  3. Notează URL-ul endpointului și regiunea.

Pasul 2: conectează bucketul în Nubbo

  1. În Bucketuri, apasă Conectează bucket, alege S3 personalizat / găzduit propriu și apoi Cu o cheie limitată.
  2. Lipește cheia de acces, cheia secretă, endpointul și regiunea. Apasă Verifică cheia.
  3. Scrie numele exact al bucketului și apasă Verifică accesul.
  4. Asistentul trece la pasul CORS, cu regula pe care trebuie să o adaugi.

Adaugă regula CORS

Regula CORS îi permite browserului să încarce și să descarce fișiere din bucketul tău pe https://nubbo.app. Este aceeași regulă pe care asistentul o arată la pasul CORS.

Modul de configurare a CORS depinde de software:

  • MinIO (ediția community) nu acceptă CORS per bucket: folosește o setare globală (MINIO_API_CORS_ALLOW_ORIGIN) care permite implicit orice origine. Dacă nu ai modificat-o, nu ai nimic de făcut: apasă Am adăugat-o, verifică și verificarea va trece. Dacă ai modificat-o, include https://nubbo.app.
  • Ceph și SeaweedFS acceptă CORS per bucket prin API-ul S3. Aplică această regulă cu unealta pe care o folosești de obicei (de exemplu, aws s3api put-bucket-cors cu endpointul tău) sau lasă Nubbo să o facă pe calea automată.
[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
    "AllowedOrigins": ["https://nubbo.app"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]
Pasul CORS cu regula de adăugat în bucket Pasul CORS cu regula de adăugat în bucket

Când regula este gata, întoarce-te în Nubbo și apasă Am adăugat-o, verifică. În Ceph și SeaweedFS, dacă cheia ta poate modifica CORS, Încearcă configurarea în locul meu o face pentru tine.

Dacă ceva nu merge

Mesajul din NubboCe faci
“Date de conectare nevalide. Verifică cheia de acces și cheia secretă de acces.”Copiază din nou ambele chei, fără spații la început sau la sfârșit.
“Această cheie pare limitată la un singur bucket. Poți continua pe calea limitată sau poți crea o cheie cu acces complet.”Apasă Continuă cu o cheie limitată sau creează o cheie cu acces la tot contul și apasă Încearcă altă cheie.
“Bucket-ul nu a fost găsit. Verifică numele și regiunea.”Verifică numele exact al bucketului și dacă regiunea aleasă este cea a bucketului.
“Cheia ta nu are permisiunea de a crea bucketuri.”Folosește o cheie cu acces complet sau creează bucketul în panoul tău și apasă L-am creat în panoul meu.
“Numele acesta este deja folosit la acest furnizor; încearcă altul.”Numele de bucketuri sunt unice la nivelul furnizorului: alege altul.
“Cheia ta nu are permisiunea de a-l configura.”Adaugă regula CORS manual, cum am explicat mai sus.
“Încă nu funcționează. Revizuiește regula și verifică din nou; unii provideri au nevoie de un minut ca să o aplice.”Verifică dacă originea este exact https://nubbo.app, fără bară la final, așteaptă un minut și verifică din nou.
“Acest bucket este deja folosit.”Bucketul este deja conectat în Nubbo, în contul tău sau în altul.
“Nu am putut ajunge la endpoint-ul S3. Verifică URL-ul endpoint-ului.”Verifică dacă URL-ul este public, folosește HTTPS și răspunde de pe internet, nu doar din rețeaua ta.
“URL-ul endpoint-ului nu este valid. Verifică formatul.”Scrie URL-ul complet, cu https:// și fără numele bucketului. Mesajul apare și când URL-ul indică spre o adresă privată sau locală ori când numele nu se rezolvă.
“Conexiunea a expirat. Încearcă din nou.”Verifică firewallul serverului și dacă portul este accesibil din exterior.

Cât costă

Dacă pui în balanță propria stocare și un furnizor, compară prețurile și limitele în S3 vs R2 vs Spaces vs Wasabi vs Backblaze B2.

Întrebări frecvente

Ce stocare găzduită pe propriile servere funcționează cu Nubbo?

Orice stocare compatibilă cu API-ul S3 cu semnături V4, cum ar fi MinIO, Ceph sau SeaweedFS, precum și furnizorii compatibili S3 care nu apar în listă.

Pot conecta un MinIO din rețeaua mea locală?

Nu. Endpointul trebuie să fie un URL public: Nubbo respinge adresele private și locale, iar browserul trebuie și el să ajungă la el.

Ce regiune folosesc dacă serverul meu nu are regiuni?

us-east-1. Este regiunea implicită a majorității serverelor compatibile S3.

De ce Nubbo nu poate configura CORS în MinIO?

Pentru că ediția community a MinIO nu acceptă CORS per bucket. Folosește o setare globală care permite implicit orice origine, iar Nubbo o verifică.

Surse

Prețurile și limitele provin din paginile oficiale de mai jos. Furnizorii le schimbă, așa că verifică-le înainte să te decizi.