All Products
Search
Document Center

Cloud Storage Gateway:Catatan penggunaan

Last Updated:Sep 21, 2026

Sebelum menggunakan Cloud Storage Gateway (CSG), kami menyarankan Anda membaca catatan penggunaan berikut.

File gateway

  • Hindari sering menginterupsi unggahan file besar ke share Network File System (NFS) atau Server Message Block (SMB). Sistem melakukan unggahan file menggunakan multipart upload. Jika unggahan file besar diinterupsi, bagian-bagian (parts) akan tersisa di bucket Object Storage Service (OSS) terkait. Bagian-bagian tersebut mengonsumsi kapasitas bucket OSS sehingga penggunaan penyimpanan bucket menjadi sedikit lebih tinggi daripada ukuran total file. Gunakan aturan siklus hidup untuk menghapus bagian-bagian tersebut secara otomatis. Untuk informasi selengkapnya, lihat Delete parts.

  • Kapasitas cache sebuah share dihitung berdasarkan rumus berikut: Kapasitas cache lokal yang direkomendasikan = (Bandwidth aplikasi dalam MB/s – Bandwidth backend gerbang dalam MB/s) × Durasi penulisan dalam detik × 1,2.

    Untuk mengoptimalkan kinerja akses lokal, atur kapasitas cache lokal ke nilai yang lebih tinggi antara perkiraan jumlah data aktif (hot data) dan kapasitas cache lokal yang direkomendasikan.

  • Saat menulis file besar menggunakan file gateway, pastikan ukuran file lebih kecil dari 30% kapasitas disk cache. Selain itu, hindari menulis beberapa file besar secara bersamaan karena hal ini dapat dengan cepat menghabiskan ruang disk cache yang tersedia.

  • File gateway versi 1.0.38 dan yang lebih baru mendukung unggahan file hingga 30 TB. Saat mengunggah file berukuran lebih dari 2 TB, kami menyarankan Anda menyediakan bandwidth Internet minimal 500 MB/s atau terhubung ke Alibaba Cloud melalui sirkuit Express Connect. Jika tidak, kesalahan timeout unggah mungkin terjadi.

  • File gateway mendukung sparse file. Jika sparse file gagal diunggah ke file gateway, jalankan perintah berikut untuk mengonversi format sparse file tersebut:

    dd if=<sparse file name> of=<sparse file name> conv=notrunc bs=1M

    Ukuran sparse file tidak boleh melebihi kapasitas disk cache yang tersedia.

  • Nama file dan direktori pada file gateway harus dikodekan dalam UTF-8. File gateway tidak mendukung nama file dan direktori yang dikodekan dalam format selain UTF-8. Misalnya, jika Anda memasang share NFS file gateway pada klien Windows, pembuatan file atau direktori yang namanya mengandung karakter Tionghoa akan gagal dengan kode kesalahan 0x8007045D.

  • Jika ukuran file pada file gateway melebihi 256 MB, kami menyarankan Anda menonaktifkan Pengendalian versi untuk bucket OSS terkait. Jika tidak, kesalahan timeout mungkin terjadi saat gerbang mengunggah metadata, yang mengakibatkan penurunan kinerja keseluruhan gerbang.

  • File gateway menerapkan isolasi izin pada Active Directory (AD) Windows berdasarkan POSIX Access Control Lists (ACLs). File gateway tidak memungkinkan pemberian otorisasi kepada beberapa pengguna AD lintas direktori. Misalnya, direktori AA/BB/CC dimiliki oleh Pengguna 1. Jika Anda memberi otorisasi kepada Pengguna 2 untuk mengakses hanya direktori CC, Pengguna 2 tidak dapat mengakses data di direktori CC melalui path AA/BB/CC. Dalam skenario ini, Anda juga harus memberi otorisasi kepada Pengguna 2 untuk mengakses direktori AA dan BB.

  • Jika bucket terkait berisi lebih dari satu juta file, kami menyarankan Anda mengatur interval sinkronisasi balik (reverse synchronization) lebih dari 3.600 detik.

  • Untuk file gateway versi 1.0.36 dan yang lebih baru, tipe Multipurpose Internet Mail Extensions (MIME) secara otomatis ditentukan dalam metadata OSS berdasarkan ekstensi file.

  • Jika sinkronisasi balik diaktifkan, direktori lokal kosong yang belum diunggah ke Alibaba Cloud mungkin dihapus oleh proses sinkronisasi balik selama siklus pemindaian. Untuk mengatasi masalah ini, buat kembali direktori tersebut.

  • Secara default, Anda dapat mengganti nama direktori yang berisi tidak lebih dari 5 juta subdirektori dan file. Jika ingin mengganti nama direktori yang berisi lebih dari 5 juta subdirektori dan file, kirimkan Tiket.

  • Saat sinkronisasi balik diaktifkan, beberapa operasi penggantian nama direktori mungkin gagal karena cache metadata yang tidak lengkap di sisi gerbang.

File gateway yang dideploy di Alibaba Cloud

  • Bandwidth sinkronisasi gerbang terkait dengan bandwidth OSS. OSS menyediakan hingga 10 Gbit/s untuk setiap pengguna. Bandwidth OSS sedikit berbeda antar kluster di wilayah yang berbeda. Untuk informasi selengkapnya, kirimkan tiket.

  • Secara default, lebar pita unggah gerbang yang dideploy di Alibaba Cloud adalah 1 Mbit/s. Gerbang ini mengakses bucket OSS lintas wilayah melalui Internet. Akibatnya, kinerja transmisi data mungkin tidak stabil.

  • Protokol penyimpanan jaringan seperti NFS dan SMB memerlukan port khusus, sehingga Anda harus mengonfigurasi aturan grup keamanan untuk membuka port-port tersebut.

    • Setelah membuat file gateway di Alibaba Cloud, grup keamanan dengan awalan Cloud_Storage_Gateway_Usage dikonfigurasi secara default untuk gerbang tersebut. Jangan gunakan grup keamanan ini saat membuat instans Elastic Compute Service (ECS). Port yang diperlukan untuk NFS dan SMB dikonfigurasi secara otomatis dalam grup keamanan ini.

    • CSG mendukung domain AD. Anda perlu mengonfigurasi port tertentu untuk mendukung protokol berikut: AD, Domain Name System (DNS), dan Kerberos. Untuk informasi tentang cara menggabungkan gerbang ke domain AD, lihat Join a file gateway to an AD domain. Tabel berikut menjelaskan port yang diperlukan oleh berbagai protokol.

    Protocol

    Port

    NFS

    111 (TCP dan UDP), 2049 (TCP dan UDP), 32887 (TCP dan UDP), 32888 (TCP dan UDP), dan 32889 (TCP dan UDP)

    SMB

    137 (UDP), 138 (UDP), 139 (TCP), 389 (TCP), 445 (TCP), dan 901 (TCP)

    AD

    389 (TCP dan UDP), 445 (TCP dan UDP)

    DNS

    53 (UDP dan TCP)

    Kerberos

    88 (UDP dan TCP)

File gateway on-premises

Konsol untuk file gateway on-premises menggunakan protokol HTTPS. Protokol penyimpanan jaringan seperti NFS dan SMB memerlukan port khusus. Anda perlu mengonfigurasi firewall untuk mendukung port-port tersebut.

File gateway on-premises mendukung domain AD. Anda perlu mengonfigurasi port tertentu untuk mendukung protokol berikut: AD, DNS, dan Kerberos. Jika ingin menggabungkan file gateway on-premises ke domain AD, Anda harus membuka port yang sesuai di firewall klien.

Protocol

Port

HTTPS

443

NFS

111 (TCP dan UDP), 2049 (TCP dan UDP), 32887 (TCP dan UDP), 32888 (TCP dan UDP), dan 32889 (TCP dan UDP)

SMB

137 (UDP), 138 (UDP), 139 (TCP), 389 (TCP), 445 (TCP), dan 901 (TCP)

AD

389 (TCP dan UDP), 445 (TCP dan UDP)

DNS

53 (UDP dan TCP)

Kerberos

88 (UDP dan TCP)

Gerbang iSCSI

  • Kapasitas cache volume Internet Small Computer Systems Interface (iSCSI) dihitung berdasarkan rumus berikut: Kapasitas cache lokal yang direkomendasikan = (Bandwidth aplikasi dalam MB/s – Bandwidth backend gerbang dalam MB/s) × Durasi penulisan dalam detik × 1,2.

    Untuk mengoptimalkan kinerja akses lokal, atur kapasitas cache lokal ke nilai yang lebih tinggi antara perkiraan jumlah data aktif (hot data) dan kapasitas cache lokal yang direkomendasikan.

  • Bandwidth sinkronisasi iSCSI gateway terkait dengan bandwidth OSS. OSS mendukung bandwidth maksimum 10 Gbit/s untuk setiap pengguna. Bandwidth OSS sedikit berbeda antar kluster di wilayah yang berbeda. Untuk informasi selengkapnya, hubungi dukungan teknis OSS.

  • Operasi input/output per detik (IOPS) default bergantung pada kapasitas disk backend. Untuk informasi selengkapnya, lihat ESSDs.