Nubbo maakt verbinding met elke S3-compatibele opslag die met Signature V4 ondertekent, zoals MinIO, Ceph of SeaweedFS, op je eigen server of bij een andere provider. Je hebt alleen de endpoint-URL, een sleutel en de regio nodig. Deze gids volgt de wizard van Nubbo stap voor stap, met beide routes: automatisch of met een sleutel die tot één bucket is beperkt.
Wat je krijgt
- Blader door de bucket alsof het een schijf is: mappen, weergaven, zoeken, prullenbak, labels en favorieten.
- Upload en download bestanden rechtstreeks tussen je browser en je server. Bestanden gaan nooit via de servers van Nubbo.
- Deel bestanden en mappen met een wachtwoord, vervaldatum en downloadlimiet, ontvang bestanden in je bucket en maak galerijen.
- Je sleutels worden versleuteld met AES-256-GCM bewaard en je kunt de bucket op elk moment loskoppelen.
Voordat je begint
Je hebt S3-compatibele opslag en een Nubbo-account nodig. Elke bucket die je koppelt telt mee voor de limiet van je abonnement: het Gratis-abonnement staat er 2 toe, Personal 5 en Pro heeft geen limiet. Het endpoint moet een openbare URL zijn die zowel de servers van Nubbo als de browser kunnen bereiken, en het heeft HTTPS nodig, omdat de browser geen HTTP-inhoud laadt vanaf https://nubbo.app. Nubbo weigert endpoints die naar privé- of lokale adressen verwijzen. Heeft je server geen regio’s, laat dan us-east-1 staan.
Kies hoe je verbindt
De wizard van Nubbo biedt twee routes. Beide eindigen op dezelfde manier: de bucket verbonden en klaar voor uploads vanuit de browser.
| Automatisch | Met een beperkte sleutel | |
|---|---|---|
| Sleutel | Toegang tot het hele account | Beperkt tot één bucket |
| Bucket | Nubbo gebruikt een van de jouwe of maakt een nieuwe | Je maakt hem eerst zelf aan |
| CORS | Nubbo voegt de regel voor je toe | Je voegt de regel zelf toe |
| Wanneer kiezen | De snelste manier | Als je geen toegang tot het hele account wilt geven |
Automatische verbinding
Stap 1: maak de sleutel aan op je server
- Controleer of je server de S3 API met Signature V4 aanbiedt op een openbare HTTPS-URL, bijvoorbeeld
https://s3.your-domain.com. - Maak een sleutel die buckets kan maken en hun CORS kan wijzigen.
- Noteer de endpoint-URL en de regio. Heeft je server geen regio’s, gebruik dan
us-east-1.
Stap 2: verbind de bucket in Nubbo
Open in Nubbo Buckets en klik op Bucket koppelen. Kies Aangepaste S3 / self-hosted en klik op Doorgaan.
Kies Automatisch en klik op Doorgaan.
Plak in de stap Je sleutel de access key, de secret key, de endpoint-URL en de regio. Klik op Sleutel controleren. Nubbo controleert of de sleutel werkt en of hij toegang heeft tot het hele account.
Kies een van je buckets en klik op Deze bucket gebruiken, of selecteer Nieuwe maken, typ een naam (en kies de regio, als daarom wordt gevraagd) en klik op Maken en voorbereiden. Nubbo voegt een CORS-regel aan de bucket toe die alleen uploads en downloads vanuit de app toestaat, en laat de regels die er al zijn staan.
Bekijk de drie controles, wijzig eventueel de Naam in Nubbo en klik op Afronden. De bucket verschijnt in Buckets en je kunt hem openen in de verkenner.
Kan Nubbo de CORS-regel niet toevoegen met je sleutel, dan brengt de wizard je naar de stap CORS. Volg in dat geval Voeg de CORS-regel toe.
Verbinding met een beperkte sleutel
Stap 1: bereid de bucket en de sleutel voor op je server
- Maak de bucket aan op je server (bij MinIO bijvoorbeeld met
mc mb). - Maak een sleutel met lees- en schrijfrechten op die bucket.
- Noteer de endpoint-URL en de regio.
Stap 2: verbind de bucket in Nubbo
- Klik in Buckets op Bucket koppelen, kies Aangepaste S3 / self-hosted en daarna Met een beperkte sleutel.
- Plak de access key, de secret key, het endpoint en de regio. Klik op Sleutel controleren.
- Typ de exacte naam van de bucket en klik op Toegang controleren.
- De wizard gaat naar de stap CORS met de regel die je moet toevoegen.
Voeg de CORS-regel toe
Met de CORS-regel kan de browser bestanden uploaden naar en downloaden uit je bucket op https://nubbo.app. Het is dezelfde regel die de wizard in de stap CORS toont.
Hoe je CORS instelt, hangt af van de software:
- MinIO (community edition) accepteert geen CORS per bucket: het gebruikt een globale instelling (
MINIO_API_CORS_ALLOW_ORIGIN) die standaard elke origin toestaat. Heb je die niet gewijzigd, dan hoef je niets te doen: klik op Toegevoegd, controleren en de controle slaagt. Heb je hem wel gewijzigd, neem danhttps://nubbo.appop. - Ceph en SeaweedFS accepteren CORS per bucket via de S3 API. Pas deze regel toe met je gebruikelijke tool (bijvoorbeeld
aws s3api put-bucket-corsmet je endpoint), of laat Nubbo het doen via de automatische route.
[
{
"AllowedHeaders": ["*"],
"AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
"AllowedOrigins": ["https://nubbo.app"],
"ExposeHeaders": ["ETag"],
"MaxAgeSeconds": 3600
}
]
Is de regel klaar, ga dan terug naar Nubbo en klik op Toegevoegd, controleren. Bij Ceph en SeaweedFS regelt Probeer het voor mij in te stellen het voor je, als je sleutel CORS mag wijzigen.
Als er iets misgaat
| Melding in Nubbo | Wat te doen |
|---|---|
| “Ongeldige gegevens. Controleer de access key en secret access key.” | Kopieer beide sleutels opnieuw, zonder spaties aan het begin of het eind. |
| “Deze sleutel lijkt beperkt tot één bucket. Je kunt doorgaan met de beperkte route of een sleutel met volledige toegang maken.” | Klik op Doorgaan met een beperkte sleutel, of maak een sleutel met toegang tot het hele account en klik op Andere sleutel proberen. |
| “Bucket niet gevonden. Controleer de naam en regio.” | Controleer de exacte naam van de bucket en of de gekozen regio die van de bucket is. |
| “Je sleutel heeft geen toestemming om buckets te maken.” | Gebruik een sleutel met volledige toegang, of maak de bucket aan in je paneel en klik op Ik heb hem in mijn paneel gemaakt. |
| “Die naam is al in gebruik bij deze provider; probeer een andere.” | Bucketnamen zijn uniek binnen de hele provider: kies een andere. |
| “Je sleutel heeft geen toestemming om dit in te stellen.” | Voeg de CORS-regel met de hand toe, zoals hierboven uitgelegd. |
| “Het werkt nog niet. Controleer de regel en probeer het opnieuw; sommige providers hebben een minuut nodig om hem toe te passen.” | Controleer of de origin precies https://nubbo.app is, zonder slash aan het eind, wacht een minuut en controleer opnieuw. |
| “Deze bucket is al in gebruik.” | Die bucket is al gekoppeld in Nubbo, in je eigen account of in een ander account. |
| “Kon het S3-eindpunt niet bereiken. Controleer de eindpunt-URL.” | Controleer of de URL openbaar is, HTTPS gebruikt en vanaf internet antwoordt, niet alleen vanuit je eigen netwerk. |
| “De eindpunt-URL is ongeldig. Controleer het formaat.” | Typ de volledige URL met https:// en zonder de naam van de bucket. Deze melding verschijnt ook als de URL naar een privé- of lokaal adres verwijst of als de naam niet wordt omgezet. |
| “De verbinding is verlopen. Probeer het opnieuw.” | Controleer de firewall van je server en of de poort van buitenaf bereikbaar is. |
Wat het kost
Weeg je eigen opslag af tegen die van een provider? Vergelijk prijzen en limieten in S3 vs R2 vs Spaces vs Wasabi vs Backblaze B2.
Veelgestelde vragen
Welke self-hosted opslag werkt met Nubbo?
Elke opslag die compatibel is met de S3 API met Signature V4, zoals MinIO, Ceph of SeaweedFS, en ook S3-compatibele providers die niet in de lijst staan.
Kan ik een MinIO op mijn lokale netwerk koppelen?
Nee. Het endpoint moet een openbare URL zijn: Nubbo weigert privé- en lokale adressen, en ook de browser moet het kunnen bereiken.
Welke regio gebruik ik als mijn server geen regio's heeft?
us-east-1. Dat is de standaardregio van de meeste S3-compatibele servers.
Waarom kan Nubbo CORS niet instellen op MinIO?
Omdat de community edition van MinIO geen CORS per bucket ondersteunt. Het gebruikt een globale instelling die standaard elke origin toestaat, en Nubbo controleert die.
Bronnen
Prijzen en limieten komen van de officiële pagina's hieronder. Providers passen ze aan, dus controleer ze voordat je een keuze maakt.