全部产品
Search

搜索本产品

    Object Storage Service：Memasang bucket ke sistem file lokal di Linux menggunakan ossfs 1.0

    文档中心

    Object Storage Service：Memasang bucket ke sistem file lokal di Linux menggunakan ossfs 1.0

    更新时间：Nov 10, 2025

    Topik ini menjelaskan cara menggunakan ossfs untuk memasang bucket Object Storage Service (OSS) ke dalam sistem file lokal di Linux.

    Prasyarat

    ossfs 1.0 telah terinstal dan terkonfigurasi.

    Format Perintah

    • Format: ossfs bucket_name /tmp/ossfs -o url=http://oss-cn-hangzhou.aliyuncs.com -o sigv4 -o region=cn-hangzhou

    • Deskripsi Parameter

      • ossfs: Program yang digunakan.

      • bucket_name: Nama bucket yang ingin dipasang ke sistem file lokal.

      • /tmp/ossfs: Direktori lokal dalam sistem file tempat bucket akan dipasang.

      • -o: Awalan untuk opsi pemasangan.

      • url=http://oss-cn-hangzhou.aliyuncs.com: Titik akhir wilayah bucket, dalam format http://Endpoint.

        Masuk ke Konsol OSS, pilih bucket di halaman Buckets, dan lihat titik akhir pada bagian Port di halaman Overview. Contoh ini menggunakan bucket di Wilayah China (Hangzhou).

        image

      • sigv4: Mengontrol penggunaan tanda tangan V4. Saat memasang, tambahkan -osigv4. Secara default, ossfs menggunakan tanda tangan OSS V1. Setelah menambahkan opsi ini, ossfs akan menggunakan alur tanda tangan OSS V4 untuk mengirim permintaan terkait ke OSS.

      • region=cn-hangzhou: Pengenal wilayah permintaan OSS Bucket. Saat memasang, tambahkan -oregion=<region_id>. Secara default kosong. Saat menggunakan tanda tangan V4, opsi ini harus ditambahkan sebagai pengenal wilayah untuk mengirim permintaan.

    Operasi mount dasar

    Gunakan file konfigurasi untuk memasang bucket ke direktori lokal

    1. Buat direktori lokal tempat bucket akan dipasang.

      Jalankan perintah berikut untuk membuat direktori /tmp/ossfs-1 dan /tmp/ossfs-2, yang akan digunakan sebagai lokasi pemasangan bucket:

      mkdir /tmp/ossfs-1 /tmp/ossfs-2

    2. Jalankan perintah mount.

      Gunakan perintah berikut untuk memasang bucket bucket-test-1 dan bucket-test-2 dari file konfigurasi default ke direktori /tmp/ossfs-1 dan /tmp/ossfs-2, masing-masing.

      ossfs bucket-test-1 /tmp/ossfs-1/ -o url=http://oss-cn-hangzhou.aliyuncs.com -o sigv4 -o region=cn-hangzhou
ossfs bucket-test-2 /tmp/ossfs-2/ -o url=http://oss-cn-hangzhou.aliyuncs.com -o sigv4 -o region=cn-hangzhou

    3. Hasil pemasangan ditampilkan pada gambar berikut.

      image

    Gunakan Peran RAM dari Instance ECS untuk memasang bucket ke sistem file lokal

    1. Buat direktori lokal untuk memasang bucket.

      Jalankan perintah berikut untuk membuat direktori lokal bernama /tmp/ossfs:

      mkdir /tmp/ossfs

    2. Jalankan perintah mount.

      Catatan

      Gunakan ossfs untuk memasang bucket ke direktori lokal berdasarkan URL metadata instans. Hanya mode Normal yang didukung. Untuk informasi lebih lanjut, lihat Mode akses metadata.

      Jalankan perintah berikut untuk memasang bucket bucket1 ke direktori /tmp/ossfs:

      Catatan: Jika Anda menggunakan Peran RAM dari Instance ECS untuk memasang bucket ke sistem file lokal, Anda harus menentukan URL metadata instans dengan parameter ram_role. Alamat IP default untuk metadata instans adalah 100.100.100.200. Tidak perlu mengubah alamat IP ini. Atur parameter EcsRamRoleOssTest ke nama peran yang terhubung ke Instance ECS. Jangan ubah konfigurasi lainnya.

      ossfs bucket1 /tmp/ossfs -o url=http://oss-cn-hangzhou.aliyuncs.com -o ram_role=http://100.100.100.200/latest/meta-data/ram/security-credentials/EcsRamRoleOssTest -o sigv4 -o region=cn-hangzhou

    3. Hasil pemasangan ditunjukkan pada gambar berikut:

      image

    Pemasangan berbasis skenario

    Anda dapat memasang bucket hanya ke direktori lokal tertentu atau menggunakan opsi yang didukung oleh ossfs untuk memasang bucket ke sistem file lokal sesuai dengan skenario Anda. Catatan: Pastikan direktori lokal kosong sebelum menjalankan perintah pemasangan.

    Memasang bucket ke direktori dalam sistem file lokal

    Jalankan perintah berikut untuk memasang direktori folder di bucket bucket-ossfs-test ke direktori lokal /tmp/ossfs-folder:

    ossfs bucket-ossfs-test:/folder /tmp/ossfs-folder -o url=http://oss-cn-hangzhou.aliyuncs.com

    Gunakan file konfigurasi untuk memasang bucket ke direktori lokal

    • Opsi Pemasangan: Gunakan opsi passwd_file untuk menentukan jalur kustom file konfigurasi ossfs 1.0 dan atur izin file konfigurasi menjadi 600.

    • Contoh Mount

      Jalankan perintah berikut untuk memasang bucket bucket-test-3 yang dikonfigurasi dalam file konfigurasi ke direktori lokal /tmp/ossfs-3:

      ossfs bucket-test-3 /tmp/ossfs-3 -o url=http://oss-cn-hangzhou.aliyuncs.com -o passwd_file=/etc/passwd-ossfs-3

    Aktifkan pencatatan debug saat Anda memasang bucket ke sistem file lokal

    • Opsi Pemasangan: Opsi dbglevel menentukan tingkat log. Nilai valid: critical, error, warn, info, dan debug. Nilai default: critical. Jalur penyimpanan log default: Log disimpan di /var/log/messages untuk CentOS dan log disimpan di /var/log/syslog untuk Ubuntu. Anda juga dapat menentukan jalur penyimpanan log dengan menggunakan opsi logfile.

    • Contoh Pemasangan 1

      Jalankan perintah berikut untuk memasang bucket bucket-ossfs-test-1 ke direktori lokal /tmp/ossfs-1, aktifkan log debug libfuse dengan menentukan opsi -d, dan atur tingkat log ke debug dengan menentukan opsi dbglevel.

      ossfs bucket-ossfs-test-1 /tmp/ossfs-1 -d -o dbglevel=debug

    • Contoh Pemasangan 2

      Jalankan perintah berikut untuk memasang bucket bucket-ossfs-test-2 ke direktori lokal /tmp/ossfs-2, atur tingkat log ke debug, aktifkan log debug libfuse, dan tampilkan log di terminal dengan menentukan opsi -f.

      ossfs bucket-ossfs-test-2 /tmp/ossfs-2 -d -o dbglevel=debug -f

    Konfigurasikan izin akses saat Anda memasang bucket ke sistem file lokal

    Secara default, direktori tempat ossfs memasang bucket hanya dapat diakses oleh pemilik titik pemasangan. Pemilik titik pemasangan adalah pengguna yang melakukan operasi pemasangan. Untuk mengubah konfigurasi izin default dan mengizinkan pengguna lain atau kelompok pengguna mengakses titik pemasangan, Anda dapat menggunakan opsi berikut saat menjalankan ossfs:

    Opsi Pemasangan

    Deskripsi

    allow_other

    Mengubah izin pada titik pemasangan untuk mengizinkan semua pengguna mengakses direktori alih-alih objek dalam direktori. Anda harus menentukan izin objek dalam direktori. Untuk mengubah izin objek, jalankan perintah chmod. Untuk mengubah izin semua objek, gunakan opsi umask.

    uid

    Menentukan ID pengguna (UID) dari pemilik direktori.

    gid

    Menentukan ID grup (GID) dari pemilik direktori.

    umask

    Menentukan masker izin file dan direktori pada titik pemasangan. Sebagai contoh, Anda dapat menggunakan -oumask=007 untuk mengatur izin file pada titik pemasangan menjadi 770 atau menggunakan -oumask=077 untuk mengatur izin file pada titik pemasangan menjadi 700.

    • Contoh Pemasangan 1

      Jalankan perintah berikut untuk memasang bucket bucket_name ke direktori mount_point dan atur izin direktori menjadi 777 dengan menentukan opsi allow_other. Dalam hal ini, semua pengguna dapat mengakses direktori.

      ossfs bucket_name mount_point -o url=endpoint -o allow_other

    • Contoh Pemasangan 2

      Jalankan perintah berikut untuk memasang bucket bucket_name ke direktori mount_point dan atur izin direktori dan objek dalam direktori menjadi 770 dengan menentukan opsi umask. Dalam hal ini, pengguna dari kelompok tertentu dapat mengakses direktori dan objek dalam direktori.

      ossfs bucket_name mount_point -o url=endpoint -o umask=007

    • Contoh Pemasangan 3

      1. Jalankan perintah berikut untuk mendapatkan UID dan GID dari pengguna www:

        id www

        Gambar berikut menunjukkan hasil perintah.

        image

      2. Jalankan perintah berikut untuk memasang bucket bucket_name ke direktori mount_point, tentukan parameter uid dan gid, dan atur izin direktori dan objek dalam direktori menjadi 770. Dalam hal ini, pengguna dari kelompok tertentu dapat mengakses direktori dan objek dalam direktori. Dalam contoh ini, uid dan gid diatur menjadi 1000. Ganti UID dan GID sebenarnya sesuai dengan skenario bisnis Anda.

        ossfs bucket_name mount_point -o url=endpoint -o allow_other -o uid=1000 -o gid=1000 -o umask=007

    Keterampilan Memasang

    Aktifkan pemasangan otomatis saat startup

    Setelah memasang bucket secara manual, bucket tersebut tidak akan dipasang ulang secara otomatis ketika sistem di-restart. Untuk memastikan bucket dipasang secara otomatis setelah restart, ikuti langkah-langkah berikut: Sebelum mengaktifkan pemasangan otomatis saat startup, pastikan operasi pemasangan manual sebelumnya berhasil untuk mencegah kegagalan startup pada Instance ECS. Contoh berikut menunjukkan cara mengaktifkan pemasangan otomatis saat startup menggunakan Pasangan Kunci Akses dari Akun Alibaba Cloud untuk memasang bucket ke sistem file lokal.

    1. Tambahkan informasi seperti nama bucket, ID AccessKey, dan Rahasia AccessKey ke file /etc/passwd-ossfs dan atur izin file menjadi 640.

      Untuk informasi lebih lanjut, lihat Konfigurasikan ossfs 1.0.

    2. Aktifkan pemasangan otomatis saat startup.

      Catatan

      Contoh berikut menunjukkan cara mengaktifkan pemasangan otomatis saat startup untuk distribusi dan versi umum. Untuk distribusi dan versi lainnya, merujuk pada dokumen yang relevan.

      Aktifkan pemasangan otomatis saat startup dengan menggunakan file fstab untuk Ubuntu 14.04 atau lebih baru dan CentOS 6.5 atau lebih baru

      1. Tambahkan perintah berikut ke file /etc/fstab: 

        ossfs#bucket_name mount_point fuse _netdev,url=url,allow_other 0 0

        Tabel berikut menjelaskan parameter.

        Parameter

        Deskripsi

        bucket_name

        Nama bucket.

        mount_point

        Direktori lokal tempat Anda ingin memasang bucket.

        url=url

        Titik akhir Wilayah tempat bucket berada.

        0 0

        Opsi untuk sistem file.

      2. Simpan file /etc/fstab. Jalankan perintah mount -a -t fuse. Jika tidak ada kesalahan yang dilaporkan, pengaturan telah dikonfigurasi dengan benar.

      3. Setelah menyelesaikan langkah-langkah sebelumnya, pemasangan otomatis saat startup diaktifkan untuk Ubuntu 14.04 atau lebih baru. Untuk CentOS 6.5 atau lebih baru, jalankan juga perintah berikut: 

        chkconfig netfs on

      Aktifkan pemasangan otomatis saat startup dengan menggunakan skrip untuk CentOS 7.0 atau lebih baru

      1. Buat file ossfs di direktori /etc/init.d/, dan salin perintah berikut ke file ini. Ubah informasi dalam perintah mount sesuai dengan informasi bucket tujuan Anda. 

        #!  /bin/bash
#
# ossfs      Automount Aliyun OSS Bucket in the specified direcotry.
#
# chkconfig: 2345 90 10
# description: Activates/Deactivates ossfs configured to start at boot time.

ossfs your_bucket your_mountpoint -ourl=your_url -oallow_other

      2. Jalankan perintah berikut untuk memberikan izin eksekusi ke skrip ossfs: 

        chmod a+x /etc/init.d/ossfs

        Setelah menjalankan perintah sebelumnya, Anda dapat mengeksekusi skrip. Jika isi skrip benar, bucket akan dipasang ke direktori yang ditentukan.

      3. Jalankan perintah berikut untuk memulai skrip ossfs sebagai layanan yang secara otomatis diaktifkan saat startup: 

        chkconfig ossfs on

      4. Setelah menyelesaikan langkah-langkah sebelumnya, ossfs secara otomatis memasang bucket saat startup.

    Unmount a bucket

    Jalankan perintah berikut untuk melepas pemasangan bucket yang dipasang pada direktori /tmp/ossfs:

    umount /tmp/ossfs

    Referensi

    • Untuk memasang bucket ke sistem file lokal di Windows, gunakan Cloud Storage Gateway (CSG). Untuk detail lebih lanjut, lihat Mengelola file gateway di Konsol CSG dan Mengakses berbagi SMB.

    • Anda tidak dikenakan biaya trafik saat menggunakan Peran RAM dari Instance ECS untuk memasang bucket ke sistem file lokal melalui Titik akhir internal. Untuk informasi lebih lanjut, lihat Biaya trafik.

    • Jika Instance ECS Anda dan bucket tidak berada di Wilayah yang sama dan Anda ingin memasang bucket ke sistem file lokal lintas wilayah, pastikan koneksi jaringan stabil. Anda dapat menggunakan titik akhir publik untuk memasang bucket ke sistem file lokal. Selain itu, Anda dapat mengaktifkan Instance ECS untuk mengakses OSS lintas wilayah melalui koneksi VPC.

    • Untuk informasi lebih lanjut tentang cara membangun situs web yang di-host menggunakan Internet Information Services (IIS) dengan Cloud Storage Gateway (CSG) dan menyimpan data di OSS, lihat Bangun situs web berbasis IIS berdasarkan CSG.

    • Untuk informasi lebih lanjut tentang cara memasang bucket ke sistem file lokal yang menjalankan Windows, lihat Rclone.

    • Untuk informasi lebih lanjut tentang pemasangan dan izin, lihat FAQ.