Nubbo
MasukDaftar

Panduan

Pengelola file untuk MinIO dan S3 self-hosted: hubungkan ke Nubbo

Cara menghubungkan penyimpanan kompatibel S3 Anda sendiri, seperti MinIO, Ceph atau SeaweedFS, ke Nubbo: endpoint, key, region, CORS dan solusi jika gagal.

Nubbo terhubung ke penyimpanan apa pun yang kompatibel dengan S3 dan menandatangani dengan Signature V4, seperti MinIO, Ceph atau SeaweedFS, baik di server Anda sendiri maupun di provider lain. Yang Anda perlukan hanyalah URL endpoint, sebuah key dan region. Panduan ini mengikuti wizard Nubbo langkah demi langkah, dengan kedua jalurnya: otomatis atau dengan key yang dibatasi ke satu bucket.

Yang Anda dapatkan

  • Jelajahi bucket seperti sebuah drive: folder, tampilan, pencarian, sampah, label dan favorit.
  • Unggah dan unduh file langsung antara browser Anda dan server Anda. File tidak pernah melewati server Nubbo.
  • Bagikan file dan folder dengan kata sandi, masa berlaku dan batas unduhan, terima file ke bucket Anda dan buat galeri.
  • Key Anda disimpan terenkripsi dengan AES-256-GCM dan Anda dapat memutuskan bucket kapan saja.

Sebelum memulai

Anda memerlukan penyimpanan kompatibel S3 dan akun Nubbo. Setiap bucket yang Anda hubungkan dihitung dalam batas paket Anda: paket Gratis mengizinkan 2, Personal 5 dan Pro tanpa batas. Endpoint harus berupa URL publik yang dapat dijangkau oleh server Nubbo maupun browser, dan harus menggunakan HTTPS, karena browser tidak memuat konten HTTP dari https://nubbo.app. Nubbo menolak endpoint yang mengarah ke alamat privat atau lokal. Jika server Anda tidak memiliki region, biarkan us-east-1.

Pilih cara menghubungkan

Wizard Nubbo menawarkan dua jalur. Keduanya berakhir dengan cara yang sama: bucket terhubung dan siap menerima unggahan dari browser.

OtomatisDengan key terbatas
KeyAkses ke seluruh akunDibatasi ke satu bucket
BucketNubbo menggunakan bucket Anda atau membuat baruAnda membuatnya terlebih dahulu
CORSNubbo menambahkan aturannya untuk AndaAnda yang menambahkan aturannya
Kapan memilihnyaCara tercepatSaat Anda tidak ingin memberi akses ke seluruh akun

Koneksi otomatis

Langkah 1: buat key di server Anda

  1. Pastikan server Anda menyediakan API S3 dengan tanda tangan V4 di URL HTTPS publik, misalnya https://s3.your-domain.com.
  2. Buat key yang dapat membuat bucket dan mengubah CORS-nya.
  3. Catat URL endpoint dan region. Jika server Anda tidak memiliki region, gunakan us-east-1.

Langkah 2: hubungkan bucket di Nubbo

  1. Di Nubbo, buka Bucket dan tekan Hubungkan bucket. Pilih S3 Kustom / Self-hosted dan tekan Lanjutkan.

    Langkah Provider di wizard Nubbo dengan S3 Kustom / Self-hosted terpilih Langkah Provider di wizard Nubbo dengan S3 Kustom / Self-hosted terpilih

  2. Pilih Otomatis dan tekan Lanjutkan.

    Langkah Cara menghubungkan dengan opsi Otomatis dan Dengan key terbatas Langkah Cara menghubungkan dengan opsi Otomatis dan Dengan key terbatas

  3. Di langkah Key Anda, tempel access key, secret key, URL endpoint dan region. Tekan Periksa key. Nubbo memeriksa bahwa key berfungsi dan memiliki akses ke seluruh akun.

    Langkah Key Anda untuk S3 Kustom / Self-hosted dengan panduan cepat dan kolom key Langkah Key Anda untuk S3 Kustom / Self-hosted dengan panduan cepat dan kolom key

  4. Pilih salah satu bucket Anda dan tekan Gunakan bucket ini, atau pilih Buat yang baru, ketik nama (dan pilih wilayah, jika diminta), lalu tekan Buat dan siapkan. Nubbo menambahkan aturan CORS ke bucket yang hanya mengizinkan unggahan dan unduhan dari aplikasi, dan tetap mempertahankan aturan yang sudah ada.

    Langkah Bucket Anda dengan daftar bucket dan opsi Buat yang baru Langkah Bucket Anda dengan daftar bucket dan opsi Buat yang baru

  5. Tinjau ketiga pemeriksaan, ubah Nama di Nubbo jika Anda mau, lalu tekan Selesai. Bucket akan muncul di halaman Bucket dan Anda dapat membukanya di explorer.

    Langkah Selesai dengan pemeriksaan koneksi, bucket dan CORS Langkah Selesai dengan pemeriksaan koneksi, bucket dan CORS

Jika Nubbo tidak dapat menambahkan aturan CORS dengan key Anda, wizard akan membawa Anda ke langkah CORS. Kemudian ikuti bagian Tambahkan aturan CORS.

Koneksi dengan key terbatas

Langkah 1: siapkan bucket dan key di server Anda

  1. Buat bucket di server Anda (di MinIO, misalnya, dengan mc mb).
  2. Buat key dengan izin baca dan tulis pada bucket tersebut.
  3. Catat URL endpoint dan region.

Langkah 2: hubungkan bucket di Nubbo

  1. Di Bucket, tekan Hubungkan bucket, pilih S3 Kustom / Self-hosted, lalu Dengan key terbatas.
  2. Tempel access key, secret key, endpoint dan region. Tekan Periksa key.
  3. Ketik nama bucket yang persis dan tekan Periksa akses.
  4. Wizard berpindah ke langkah CORS dengan aturan yang perlu Anda tambahkan.

Tambahkan aturan CORS

Aturan CORS memungkinkan browser mengunggah dan mengunduh file dari bucket Anda di https://nubbo.app. Ini adalah aturan yang sama dengan yang ditampilkan wizard di langkah CORS.

Cara mengatur CORS bergantung pada perangkat lunaknya:

  • MinIO (edisi komunitas) tidak menerima CORS per bucket: MinIO menggunakan pengaturan global (MINIO_API_CORS_ALLOW_ORIGIN) yang secara default mengizinkan origin apa pun. Jika Anda belum mengubahnya, tidak ada yang perlu dilakukan: tekan Sudah ditambahkan, periksa dan pemeriksaan akan lolos. Jika Anda sudah mengubahnya, sertakan https://nubbo.app.
  • Ceph dan SeaweedFS menerima CORS per bucket melalui API S3. Terapkan aturan ini dengan alat yang biasa Anda gunakan (misalnya, aws s3api put-bucket-cors dengan endpoint Anda), atau biarkan Nubbo melakukannya di jalur otomatis.
[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
    "AllowedOrigins": ["https://nubbo.app"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]
Langkah CORS dengan aturan yang perlu ditambahkan ke bucket Langkah CORS dengan aturan yang perlu ditambahkan ke bucket

Setelah aturannya siap, kembali ke Nubbo dan tekan Sudah ditambahkan, periksa. Di Ceph dan SeaweedFS, jika key Anda dapat mengubah CORS, Coba konfigurasikan untuk saya akan melakukannya untuk Anda.

Jika ada masalah

Pesan di NubboYang harus dilakukan
“Kredensial tidak valid. Periksa access key dan secret access key.”Salin kembali kedua key, tanpa spasi di awal atau di akhir.
“Key ini tampaknya dibatasi ke satu bucket. Anda dapat melanjutkan dengan jalur terbatas atau membuat key dengan akses penuh.”Tekan Lanjutkan dengan key terbatas, atau buat key dengan akses ke seluruh akun dan tekan Coba key lain.
“Bucket tidak ditemukan. Periksa nama dan region.”Periksa nama bucket yang persis dan pastikan region yang dipilih adalah region bucket tersebut.
“Key Anda tidak diizinkan membuat bucket.”Gunakan key dengan akses penuh, atau buat bucket di panel Anda dan tekan Saya sudah membuatnya di panel saya.
“Nama itu sudah digunakan di provider ini; coba nama lain.”Nama bucket bersifat unik di seluruh provider: pilih nama lain.
“Key Anda tidak diizinkan untuk mengaturnya.”Tambahkan aturan CORS secara manual, seperti dijelaskan di atas.
“Belum berfungsi. Tinjau aturannya lalu periksa lagi; beberapa provider memerlukan waktu satu menit untuk menerapkannya.”Pastikan origin persis https://nubbo.app tanpa garis miring di akhir, tunggu satu menit dan periksa lagi.
“Bucket ini sudah digunakan.”Bucket tersebut sudah terhubung di Nubbo, di akun Anda atau di akun lain.
“Tidak dapat menjangkau endpoint S3. Periksa URL endpoint.”Pastikan URL bersifat publik, menggunakan HTTPS dan merespons dari internet, bukan hanya dari jaringan Anda.
“URL endpoint tidak valid. Periksa formatnya.”Ketik URL lengkap dengan https:// dan tanpa nama bucket. Pesan ini juga muncul jika URL mengarah ke alamat privat atau lokal, atau jika namanya tidak dapat di-resolve.
“Koneksi habis waktu. Coba lagi.”Periksa firewall server Anda dan pastikan port dapat dijangkau dari luar.

Berapa biayanya

Jika Anda sedang menimbang antara penyimpanan sendiri dan sebuah provider, bandingkan harga dan batasnya di S3 vs R2 vs Spaces vs Wasabi vs Backblaze B2.

Pertanyaan yang sering diajukan

Penyimpanan self-hosted apa yang berfungsi dengan Nubbo?

Penyimpanan apa pun yang kompatibel dengan API S3 dengan tanda tangan V4, seperti MinIO, Ceph atau SeaweedFS, serta provider kompatibel S3 yang tidak ada dalam daftar.

Bisakah saya menghubungkan MinIO di jaringan lokal saya?

Tidak. Endpoint harus berupa URL publik: Nubbo menolak alamat privat dan lokal, dan browser juga harus dapat menjangkaunya.

Region mana yang saya gunakan jika server saya tidak memiliki region?

us-east-1. Ini adalah region default sebagian besar server kompatibel S3.

Mengapa Nubbo tidak dapat mengatur CORS di MinIO?

Karena edisi komunitas MinIO tidak mendukung CORS per bucket. MinIO menggunakan pengaturan global yang secara default mengizinkan origin apa pun, dan Nubbo memeriksanya.

Sumber

Harga dan batas berasal dari halaman resmi di bawah ini. Provider dapat mengubahnya, jadi periksa sebelum Anda memutuskan.