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.
| Automaticky | S omezeným klíčem | |
|---|---|---|
| Klíč | Přístup k celému účtu | Omezený na jeden bucket |
| Bucket | Nubbo použije některý váš nebo vytvoří nový | Vytvoříte ho předem |
| CORS | Nubbo přidá pravidlo za vás | Pravidlo přidáte vy |
| Kdy ji zvolit | Nejrychlejší cesta | Když nechcete dát přístup k celému účtu |
Automatické připojení
Krok 1: vytvořte klíč na svém serveru
- Ověřte, že váš server poskytuje S3 API s podpisy V4 na veřejné adrese HTTPS, například
https://s3.your-domain.com. - Vytvořte klíč, který může vytvářet buckety a měnit jejich CORS.
- Poznamenejte si URL endpointu a region. Pokud váš server regiony nemá, použijte
us-east-1.
Krok 2: připojte bucket v Nubbo
V Nubbo otevřete Buckety a stiskněte Připojit bucket. Zvolte Vlastní S3 / vlastní hosting a stiskněte Pokračovat.

Zvolte Automaticky a stiskněte Pokračovat.

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.

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á.

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.

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
- Vytvořte bucket na svém serveru (v MinIO například pomocí
mc mb). - Vytvořte klíč s oprávněním ke čtení a zápisu v tomto bucketu.
- Poznamenejte si URL endpointu a region.
Krok 2: připojte bucket v Nubbo
- V sekci Buckety stiskněte Připojit bucket, zvolte Vlastní S3 / vlastní hosting a potom S omezeným klíčem.
- Vložte access key, secret key, endpoint a region. Stiskněte Ověřit klíč.
- Zadejte přesný název bucketu a stiskněte Ověřit přístup.
- 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řidejtehttps://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-corss 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
}
]

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