Správca súborov pre MinIO a vlastné S3: pripojte ho k Nubbo

Nubbo sa pripojí k akémukoľvek S3 kompatibilnému úložisku, ktoré podpisuje pomocou Signature V4, napríklad MinIO, Ceph alebo SeaweedFS, na vašom vlastnom serveri alebo u iného poskytovateľa. Potrebujete len URL adresu endpointu, kľúč a región. Tento návod sleduje sprievodcu Nubbo krok za krokom a pokrýva obe cesty: automatickú aj s kľúčom obmedzeným na jeden bucket.

Čo získate

• Prehliadanie bucketu ako disku: priečinky, zobrazenia, vyhľadávanie, kôš, štítky a obľúbené.
• Nahrávanie a sťahovanie súborov priamo medzi vaším prehliadačom a vaším serverom. Súbory nikdy neprechádzajú cez servery Nubbo.
• Zdieľanie súborov a priečinkov s heslom, dátumom vypršania a limitom stiahnutí, prijímanie súborov do bucketu a vytváranie galérií.
• Vaše kľúče sú uložené zašifrované pomocou AES-256-GCM a bucket môžete kedykoľvek odpojiť.

Skôr než začnete

Potrebujete S3 kompatibilné úložisko a účet v Nubbo. Každý pripojený bucket sa započítava do limitu vášho plánu: Bezplatný plán umožňuje 2, Personal 5 a Pro nemá limit. Endpoint musí byť verejná URL adresa, ku ktorej sa dostanú servery Nubbo aj prehliadač, a musí používať HTTPS, pretože prehliadač nenačíta obsah cez HTTP zo stránky https://nubbo.app. Nubbo odmieta endpointy, ktoré smerujú na súkromné alebo lokálne adresy. Ak váš server regióny nemá, ponechajte us-east-1.

Zvoľte spôsob pripojenia

Sprievodca Nubbo ponúka dve cesty. Obe končia rovnako: bucket je pripojený a pripravený na nahrávanie z prehliadača.

Automatické pripojenie

Krok 1: vytvorte kľúč na svojom serveri

1. Skontrolujte, či váš server sprístupňuje S3 API s podpismi V4 na verejnej HTTPS URL adrese, napríklad https://s3.your-domain.com.
2. Vytvorte kľúč, ktorý môže vytvárať buckety a meniť ich CORS.
3. Poznačte si URL adresu endpointu a región. Ak váš server regióny nemá, použite us-east-1.

Krok 2: pripojte bucket v Nubbo

1. V Nubbo otvorte Buckety a stlačte Pripojiť bucket. Vyberte Vlastné S3 / Self-hosted a stlačte Pokračovať.

   

2. Zvoľte Automaticky a stlačte Pokračovať.

   

3. V kroku Váš kľúč vložte prístupový kľúč, tajný kľúč, URL adresu endpointu a región. Stlačte Overiť kľúč. Nubbo overí, že kľúč funguje a že má prístup k celému účtu.

   

4. Vyberte jeden zo svojich bucketov a stlačte Použiť tento bucket, alebo zvoľte Vytvoriť nový, zadajte názov (a vyberte región, ak sa naň pýta) a stlačte Vytvoriť a pripraviť. Nubbo pridá do bucketu pravidlo CORS, ktoré povoľuje nahrávanie a sťahovanie len z aplikácie, a zachová pravidlá, ktoré už má.

   

5. Skontrolujte tri overenia, ak chcete, zmeňte Názov v Nubbo a stlačte Dokončiť. Bucket sa zobrazí v sekcii Buckety a môžete ho otvoriť v prehliadači súborov.

   

Ak Nubbo s vaším kľúčom nemôže pravidlo CORS pridať, sprievodca vás presunie do kroku CORS. Potom postupujte podľa časti Pridajte pravidlo CORS.

Pripojenie s obmedzeným kľúčom

Krok 1: pripravte bucket a kľúč na svojom serveri

1. Vytvorte bucket na svojom serveri (v MinIO napríklad príkazom mc mb).
2. Vytvorte kľúč s oprávnením na čítanie a zápis v tomto buckete.
3. Poznačte si URL adresu endpointu a región.

Krok 2: pripojte bucket v Nubbo

1. V sekcii Buckety stlačte Pripojiť bucket, vyberte Vlastné S3 / Self-hosted a potom S obmedzeným kľúčom.
2. Vložte prístupový kľúč, tajný kľúč, endpoint a región. Stlačte Overiť kľúč.
3. Zadajte presný názov bucketu a stlačte Overiť prístup.
4. Sprievodca prejde do kroku CORS s pravidlom, ktoré treba pridať.

Pridajte pravidlo CORS

Pravidlo CORS umožňuje prehliadaču nahrávať a sťahovať súbory z vášho bucketu na https://nubbo.app. Je to to isté pravidlo, ktoré sprievodca zobrazuje v kroku CORS.

Spôsob nastavenia CORS závisí od softvéru:

• MinIO (community edition) neprijíma CORS pre jednotlivé buckety: používa globálne nastavenie (MINIO_API_CORS_ALLOW_ORIGIN), ktoré predvolene povoľuje akýkoľvek pôvod. Ak ste ho nemenili, netreba nič robiť: stlačte Pridané, overiť a overenie prejde. Ak ste ho zmenili, pridajte https://nubbo.app.
• Ceph a SeaweedFS prijímajú CORS pre jednotlivé buckety cez S3 API. Použite toto pravidlo svojím obvyklým nástrojom (napríklad aws s3api put-bucket-cors s vaším endpointom), alebo to nechajte na Nubbo pri automatickej ceste.

[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
    "AllowedOrigins": ["https://nubbo.app"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]

Keď je pravidlo pripravené, vráťte sa do Nubbo a stlačte Pridané, overiť. V Ceph a SeaweedFS, ak váš kľúč môže meniť CORS, Skúsiť to nastaviť za mňa to urobí za vás.

Keď niečo zlyhá

Koľko to stojí

Ak zvažujete vlastné úložisko oproti poskytovateľovi, porovnajte ceny a limity v článku S3 vs R2 vs Spaces vs Wasabi vs Backblaze B2.