Návody

Správce souborů pro MinIO a self-hosted S3: připojte ho k Nubbo

Jak připojit k Nubbo vlastní úložiště kompatibilní s S3, například MinIO, Ceph nebo SeaweedFS: endpoint, klíč, region, CORS a co dělat, když něco selže.

Nubbo se připojí k jakémukoli úložišti kompatibilnímu s S3, které podepisuje pomocí Signature V4, například MinIO, Ceph nebo SeaweedFS, na vašem vlastním serveru nebo u jiného poskytovatele. Stačí vám URL endpointu, klíč a region. Tento návod prochází průvodce Nubbo krok za krokem, a to oběma cestami: automaticky, nebo s klíčem omezeným na jeden bucket.

Co získáte

  • Procházejte bucket jako disk: složky, zobrazení, vyhledávání, koš, štítky a oblíbené.
  • Nahrávejte a stahujte soubory přímo mezi prohlížečem a vaším serverem. Soubory nikdy neprocházejí servery Nubbo.
  • Sdílejte soubory a složky s heslem, datem vypršení a limitem stažení, přijímejte soubory do svého bucketu a vytvářejte galerie.
  • Vaše klíče se ukládají zašifrované pomocí AES-256-GCM a bucket můžete kdykoli odpojit.

Než začnete

Potřebujete úložiště kompatibilní s S3 a účet Nubbo. Každý připojený bucket se započítává do limitu vašeho tarifu: tarif Zdarma umožňuje 2, Personal 5 a Pro nemá limit. Endpoint musí být veřejná adresa, na kterou se dostanou servery Nubbo i prohlížeč, a musí používat HTTPS, protože prohlížeč z https://nubbo.app nenačítá obsah přes HTTP. Nubbo odmítá endpointy, které míří na soukromé nebo lokální adresy. Pokud váš server regiony nemá, nechte us-east-1.

Zvolte způsob připojení

Průvodce Nubbo nabízí dvě cesty. Obě končí stejně: bucket je připojený a připravený na nahrávání z prohlížeče.

AutomatickyS omezeným klíčem
KlíčPřístup k celému účtuOmezený na jeden bucket
BucketNubbo použije některý váš nebo vytvoří novýVytvoříte ho předem
CORSNubbo přidá pravidlo za vásPravidlo přidáte vy
Kdy ji zvolitNejrychlejší cestaKdyž nechcete dát přístup k celému účtu

Automatické připojení

Krok 1: vytvořte klíč na svém serveru

  1. Ověřte, že váš server poskytuje S3 API s podpisy V4 na veřejné adrese HTTPS, například https://s3.your-domain.com.
  2. Vytvořte klíč, který může vytvářet buckety a měnit jejich CORS.
  3. Poznamenejte si URL endpointu a region. Pokud váš server regiony nemá, použijte us-east-1.

Krok 2: připojte bucket v Nubbo

  1. V Nubbo otevřete Buckety a stiskněte Připojit bucket. Zvolte Vlastní S3 / vlastní hosting a stiskněte Pokračovat.

    Krok Poskytovatel v průvodci Nubbo s vybraným Vlastní S3 / vlastní hosting Krok Poskytovatel v průvodci Nubbo s vybraným Vlastní S3 / vlastní hosting
  2. Zvolte Automaticky a stiskněte Pokračovat.

    Krok Způsob připojení s možnostmi Automaticky a S omezeným klíčem Krok Způsob připojení s možnostmi Automaticky a S omezeným klíčem
  3. V kroku Váš klíč vložte access key, secret key, URL endpointu a region. Stiskněte Ověřit klíč. Nubbo ověří, že klíč funguje a má přístup k celému účtu.

    Krok Váš klíč pro Vlastní S3 / vlastní hosting s rychlým průvodcem a poli pro klíč Krok Váš klíč pro Vlastní S3 / vlastní hosting s rychlým průvodcem a poli pro klíč
  4. Vyberte jeden ze svých bucketů a stiskněte Použít tento bucket, nebo zvolte Vytvořit nový, zadejte název (a vyberte region, pokud se na něj průvodce zeptá) a stiskněte Vytvořit a připravit. Nubbo přidá do bucketu pravidlo CORS, které povoluje nahrávání a stahování jen z aplikace, a zachová pravidla, která už bucket má.

    Krok Váš bucket se seznamem bucketů a možností Vytvořit nový Krok Váš bucket se seznamem bucketů a možností Vytvořit nový
  5. Projděte tři kontroly, případně změňte Název v Nubbo a stiskněte Dokončit. Bucket se objeví v sekci Buckety a můžete ho otevřít v průzkumníku.

    Krok Hotovo s kontrolami připojení, bucketu a CORS Krok Hotovo s kontrolami připojení, bucketu a CORS

Pokud Nubbo s vaším klíčem nemůže pravidlo CORS přidat, průvodce vás přesune do kroku CORS. Pak postupujte podle části Přidejte pravidlo CORS.

Připojení s omezeným klíčem

Krok 1: připravte bucket a klíč na svém serveru

  1. Vytvořte bucket na svém serveru (v MinIO například pomocí mc mb).
  2. Vytvořte klíč s oprávněním ke čtení a zápisu v tomto bucketu.
  3. Poznamenejte si URL endpointu a region.

Krok 2: připojte bucket v Nubbo

  1. V sekci Buckety stiskněte Připojit bucket, zvolte Vlastní S3 / vlastní hosting a potom S omezeným klíčem.
  2. Vložte access key, secret key, endpoint a region. Stiskněte Ověřit klíč.
  3. Zadejte přesný název bucketu a stiskněte Ověřit přístup.
  4. Průvodce přejde do kroku CORS s pravidlem, které musíte přidat.

Přidejte pravidlo CORS

Pravidlo CORS umožňuje prohlížeči nahrávat a stahovat soubory z vašeho bucketu na https://nubbo.app. Je to stejné pravidlo, jaké průvodce ukazuje v kroku CORS.

Způsob nastavení CORS závisí na softwaru:

  • MinIO (community edition) nepřijímá CORS pro jednotlivé buckety: používá globální nastavení (MINIO_API_CORS_ALLOW_ORIGIN), které ve výchozím stavu povoluje jakýkoli origin. Pokud jste ho neměnili, není co dělat: stiskněte Přidáno, ověřit a kontrola projde. Pokud jste ho změnili, přidejte https://nubbo.app.
  • Ceph a SeaweedFS přijímají CORS pro jednotlivé buckety přes S3 API. Použijte toto pravidlo svým obvyklým nástrojem (například aws s3api put-bucket-cors s vaším endpointem), nebo to na automatické cestě nechte na Nubbo.
[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
    "AllowedOrigins": ["https://nubbo.app"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]
Krok CORS s pravidlem, které je třeba přidat do bucketu Krok CORS s pravidlem, které je třeba přidat do bucketu

Jakmile je pravidlo připravené, vraťte se do Nubbo a stiskněte Přidáno, ověřit. U Ceph a SeaweedFS, pokud váš klíč může měnit CORS, to tlačítko Zkusit to nastavit za mě udělá za vás.

Když něco selže

Zpráva v NubboCo dělat
“Neplatné přihlašovací údaje. Zkontrolujte přístupový klíč a tajný přístupový klíč.”Zkopírujte oba klíče znovu, bez mezer na začátku a na konci.
“Tento klíč se zdá být omezený na jeden bucket. Můžete pokračovat omezenou cestou, nebo vytvořit klíč s plným přístupem.”Stiskněte Pokračovat s omezeným klíčem, nebo vytvořte klíč s přístupem k celému účtu a stiskněte Zkusit jiný klíč.
“Bucket nebyl nalezen. Ověřte název a region.”Zkontrolujte přesný název bucketu a že zvolený region je region bucketu.
“Váš klíč nemá oprávnění vytvářet buckety.”Použijte klíč s plným přístupem, nebo vytvořte bucket ve svém panelu a stiskněte Už ho mám ve svém panelu.
“Tento název už se u tohoto poskytovatele používá; zkuste jiný.”Názvy bucketů jsou u poskytovatele jedinečné: zvolte jiný.
“Váš klíč nemá oprávnění to nastavit.”Přidejte pravidlo CORS ručně, jak je popsáno výše.
“Zatím to nefunguje. Zkontrolujte pravidlo a ověřte znovu; některým poskytovatelům trvá minutu, než ho použijí.”Zkontrolujte, že origin je přesně https://nubbo.app bez lomítka na konci, počkejte minutu a ověřte znovu.
“Tento bucket je již používán.”Tento bucket je už v Nubbo připojený, ve vašem účtu nebo v jiném.
“Nepodařilo se navázat spojení s koncovým bodem S3. Ověřte URL koncového bodu.”Zkontrolujte, že adresa je veřejná, používá HTTPS a odpovídá z internetu, nejen z vaší sítě.
“URL koncového bodu není platná. Zkontrolujte formát.”Zadejte celou adresu s https:// a bez názvu bucketu. Zpráva se objeví také tehdy, když adresa míří na soukromou nebo lokální adresu nebo když se název nepřeloží.
“Vypršel časový limit připojení. Zkuste to znovu.”Zkontrolujte firewall svého serveru a že je port dostupný zvenčí.

Kolik to stojí

Pokud zvažujete vlastní úložiště oproti poskytovateli, porovnejte ceny a limity v článku S3 vs R2 vs Spaces vs Wasabi vs Backblaze B2.

Časté dotazy

Které self-hosted úložiště funguje s Nubbo?

Jakékoli úložiště kompatibilní s S3 API s podpisy V4, například MinIO, Ceph nebo SeaweedFS, a také poskytovatelé kompatibilní s S3, kteří nejsou v seznamu.

Mohu připojit MinIO ve své lokální síti?

Ne. Endpoint musí být veřejná adresa: Nubbo odmítá soukromé a lokální adresy a prohlížeč se k němu také musí dostat.

Jaký region použít, když můj server regiony nemá?

us-east-1. Je to výchozí region většiny serverů kompatibilních s S3.

Proč Nubbo nemůže nastavit CORS v MinIO?

Protože komunitní edice MinIO nepodporuje CORS pro jednotlivé buckety. Používá globální nastavení, které ve výchozím stavu povoluje jakýkoli origin, a Nubbo ho ověří.

Zdroje

Ceny a limity pocházejí z níže uvedených oficiálních stránek. Poskytovatelé je mění, proto si je před rozhodnutím ověřte.