Tüm Ürünler
Search
Belge Merkezi

Object Storage Service:Mount a bucket to a local Linux system by using ossfs 1.0

Son Güncelleme:Oct 01, 2026

Bu konu, ossfs 1,0 kullanarak bir OSS paketini Linux'ta yerel dosya sistemine nasıl bağlayacağınızı açıklar.

Ön koşullar

ossfs 1,0'ı yüklediniz ve ossfs 1,0'ı yapılandırdınız.

Bağlama komutu biçimi

  • Komut biçimi: ossfs bucket_name /tmp/ossfs -o url=http://oss-cn-hangzhou.aliyuncs.com -o sigv4 -o region=cn-hangzhou

  • Parametre açıklaması

    • ossfs: ossfs komutu.

    • bucket_name: Bağlanacak paketin adı.

    • /tmp/ossfs: Paketi bağlamak için kullanılan yerel dizin (bağlama noktası olarak da bilinir).

    • -o: Bağlama seçenekleri için gerekli ön ek.

    • url=http://oss-cn-hangzhou.aliyuncs.com: url bağlama seçeneği, hedef paketin uç noktasını belirtir. Değer biçimi http://endpoint şeklindedir.

      Paketinizin uç noktasını bulmak için Bucket List sayfasına gidin, paketinizi seçin ve sol gezinme bölmesinde Overview öğesini tıklayın. Port bölümünde uç nokta görüntülenir. Bu örnekte Çin (Hangzhou) bölgesindeki bir paket kullanılmaktadır.

      Belirli ağ ortamları için başka uç noktalar da mevcuttur: oss-cn-hangzhou-internal.aliyuncs.com Klasik ağ veya VPC ağı üzerinden bir ECS örneğinden erişim için (dahili), oss-accelerate.aliyuncs.com küresel Transfer Acceleration alan adı için ve cn-hangzhou-internal.oss-data-acc.aliyuncs.com OSS Accelerator için. Ağ ortamınıza göre bir uç nokta seçin.

    • sigv4: V4 imzasını etkinleştirir. Bağlama komutuna -osigv4 ekleyin. Varsayılan olarak ossfs V1 imzasını kullanır. Bu bağlama seçeneğini eklerseniz ossfs, istekleri OSS'ye V4 imzalama sürecini kullanarak gönderir.

    • region=cn-hangzhou: OSS paketi isteği için bölge kimliği. Paketi bağlarken -oregion=<region_id> ekleyin. Varsayılan değer boştur. Bu seçenek, istek için bölgeyi belirtmek amacıyla V4 imzaları kullanılırken gereklidir.

Temel bağlama

Yapılandırma dosyası kullanarak bağlama

  1. Bağlama dizinlerini oluşturun.

    Paketleriniz için bağlama noktası olarak kullanmak üzere /tmp/ossfs-1 ve /tmp/ossfs-2 boş dizinlerini oluşturmak için aşağıdaki komutu çalıştırın.

    mkdir /tmp/ossfs-1 /tmp/ossfs-2
  2. Bağlama örneği.

    Varsayılan yapılandırma dosyasında yapılandırılmış olan bucket-test-1 ve bucket-test-2 paketlerini sırasıyla /tmp/ossfs-1 ve /tmp/ossfs-2 dizinlerine bağlamak için aşağıdaki komutları çalıştırın.

    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. Çıktı aşağıdaki gibidir.

    root@i-xxx:~# ossfs xxx /tmp/ossfs-1 -o url=http://oss-cn-hangzhou.aliyuncs.com -o sigv4 -o region=cn-hangzhou
    [NOTICE] OSS signature V1 service will not be available for new uids since March 1st, 2025. It is recommended to mount with OSS signature V4:
        ossfs [oss-bucket] [mount-path] [options] -osigv4 -oregion=[your-region-id]
    root@i-xxx:~#
    root@i-xxx                :~# df -h /tmp/ossfs-1
    Filesystem      Size  Used Avail Use% Mounted on
    ossfs            16E     0   16E   0% /tmp/ossfs-1

ECS RAM rolü kullanarak bağlama

  1. Bir bağlama dizini oluşturun.

    Paketiniz için bağlama noktası olarak kullanmak üzere /tmp/ossfs boş dizinini oluşturmak için aşağıdaki komutu çalıştırın.

    mkdir /tmp/ossfs
  2. Bağlama örneği.

    Not

    Bir örnek meta verileri URL'si kullanarak ossfs bağlarken yalnızca normal erişim modu desteklenir. Meta veri erişim modları hakkında daha fazla bilgi için bkz. Örnek meta verileri.

    bucket1 adlı bir paketi yerel /tmp/ossfs dizinine bağlamak için aşağıdaki komutu çalıştırın.

    Not: Bir ECS RAM rolü kullanarak paket bağlarken, örnek meta verileri URL'sini ram_role parametresiyle belirtmeniz gerekir. 100.100.100.200 IP adresi, Alibaba Cloud ECS örnek meta verileri hizmeti için varsayılan değerdir ve değiştirilmemelidir. EcsRamRoleOssTest ifadesini ECS örneğinize eklenen rolün adıyla değiştirin. Diğer bilgileri değiştirmeyin.

    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. Çıktı aşağıdaki gibidir.

    root@xxx         xxx:~# ossfs  xxx  /tmp/ossfs -o url=http://oss-cn-hangzhou.aliyuncs.com -o ram role=http://100.100.100.200/latest/meta-data/ram/security-credentials/xxx  -o sigv4 -o region=cn-hangzhou
    [NOTICE] OSS signature V1 service will not be available for new uids since March 1st, 2025. It is recommended to mount with OSS signature V4:
            ossfs [oss-bucket] [mount-path] [options] -osigv4 -oregion=[your-region-id]
    root@xxx         xxx:~#
    root@xxx         xxx:~# df -h /tmp/ossfs
    Filesystem  Size  Used  Avail Use% Mounted on
    ossfs       16E   0     16E   0%   /tmp/ossfs

Belirli senaryolarda bağlama

Belirli bir dizini bağlayabilir veya bağlama seçenekleri ekleyebilirsiniz. Seçeneklerin listesi için bkz. bağlama seçenekleri. Not: Bağlama komutunu çalıştırmadan önce yerel bağlama dizininin boş olduğundan emin olun.

Belirli bir dizini bağlama

bucket-ossfs-test paketindeki folder dizinini yerel /tmp/ossfs-folder dizinine bağlamak için aşağıdaki komutu çalıştırın.

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

Belirtilen bir yapılandırma dosyası kullanarak bağlama

  • Bağlama seçeneği: Varsayılan olmayan bir ossfs 1,0 yapılandırma dosyasının yolunu belirtmek için passwd_file bağlama seçeneğini kullanın. Dosyanın izinlerini 600 olarak ayarlayın.

  • Bağlama örneği

    Belirtilen yapılandırma dosyasında yapılandırılmış olan bucket-test-3 paketini yerel /tmp/ossfs-3 dizinine bağlamak için aşağıdaki komutu çalıştırın.

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

Bağlama sırasında hata ayıklama günlüklerini etkinleştirme

  • Bağlama seçeneği: dbglevel bağlama seçeneği günlük düzeyini ayarlar. Aşağıdaki günlük düzeyleri desteklenir: critical, error, warn, info ve debug. Varsayılan değer critical değeridir. Varsayılan olarak günlükler CentOS sistemlerinde /var/log/messages dosyasına ve Ubuntu sistemlerinde /var/log/syslog dosyasına kaydedilir. Günlük dosyası için özel bir yol belirtmek amacıyla logfile bağlama seçeneğini de kullanabilirsiniz.

  • Bağlama örneği 1

    bucket-ossfs-test-1 paketini yerel /tmp/ossfs-1 dizinine bağlamak için aşağıdaki komutu çalıştırın. Bu komutta, libfuse hata ayıklama günlüğünü etkinleştirmek için -d seçeneği eklenir ve günlük düzeyini debug olarak ayarlamak için dbglevel bağlama seçeneği kullanılır.

    ossfs bucket-ossfs-test-1 /tmp/ossfs-1 -d -o dbglevel=debug -o sigv4 -o region=cn-hangzhou
  • Bağlama örneği 2

    bucket-ossfs-test-2 paketini yerel /tmp/ossfs-2 dizinine bağlamak için aşağıdaki komutu çalıştırın. Günlük düzeyi debug olarak ayarlanır ve libfuse hata ayıklama günlüğü etkinleştirilir. Günlük iletileri -f seçeneği kullanılarak ön plan terminaline yazdırılır.

    ossfs bucket-ossfs-test-2 /tmp/ossfs-2 -d -o dbglevel=debug -f -o sigv4 -o region=cn-hangzhou

Bağlama sırasında erişim izinlerini yapılandırma

Varsayılan olarak, bağlama komutunu çalıştıran kullanıcı (sahip) dışında hiç kimse bağlanan dizine erişemez. Diğer kullanıcıların bağlama noktasına erişmesine izin vermek için paketi bağlarken aşağıda açıklanan parametreleri yapılandırın.


Parametre


Açıklama


allow_other


Tüm kullanıcıların bağlama noktası dizinine kendisine erişmesine izin verir ancak dizindeki dosyalara erişmesine izin vermez. Dosyalar için izinleri ayrı olarak ayarlamanız gerekir. Tek tek dosyaların izinlerini değiştirmek için chmod komutunu kullanın. Tüm dosyalara uniform izinler uygulamak için umask seçeneğini yapılandırın.


uid


Dizinin sahibi olan kullanıcının UID'si.


gid


Dizinin sahibi olan grubun GID'si.


umask


Bağlama noktasındaki dosyalar ve dizinler için izin maskesini ayarlar. Örneğin, bağlama noktasındaki izinleri 770 olarak ayarlamak için -o umask=007 ekleyin. İzinleri 700 olarak ayarlamak için -o umask=077 ekleyin.

  • Bağlama örneği 1

    bucket_name paketini yerel mount_point dizinine bağlamak ve tüm kullanıcılara erişim izni vermek için allow_other bağlama seçeneğini kullanmak üzere aşağıdaki komutu çalıştırın. Bu işlem, bağlama dizininin izinlerini 777 olarak ayarlar.

    ossfs bucket_name mount_point -o url=endpoint -o allow_other -o sigv4 -o region=cn-hangzhou
  • Bağlama örneği 2

    bucket_name paketini yerel mount_point dizinine bağlamak ve bağlama dizini ile içindeki dosyaların izinlerini 770 olarak ayarlamak için umask bağlama seçeneğini kullanmak üzere aşağıdaki komutu çalıştırın. Bu işlem, erişimi yalnızca aynı gruptaki kullanıcılarla sınırlar.

    ossfs bucket_name mount_point -o url=endpoint -o umask=007 -o sigv4 -o region=cn-hangzhou
  • Bağlama örneği 3

    1. Belirli bir kullanıcının UID, GID ve gruplarını almak için aşağıdaki komutu çalıştırın. Bu örnekte www kullanıcısı kullanılmaktadır.

      id www

      Komut çıktısı aşağıdaki gibidir.

      root@iZbp1325rf1sja6ye4kbm2Z:~# id www
      uid=xxx(www) gid=xxx(www) groups=xxx(www)
    2. bucket_name paketini yerel mount_point dizinine bağlamak ve kullanıcı ile grubu belirtmek için uid ve gid bağlama seçeneklerini kullanmak üzere aşağıdaki komutu çalıştırın. Bu yapılandırma, erişimi yalnızca aynı gruptaki kullanıcılarla sınırlar ve izinleri 770 olarak ayarlar. Bu örnekte uid ve gid değerleri 1000'dir. Bağlama komutunu çalıştırmadan önce bu değerleri hedef kullanıcının uid ve gid değerleriyle değiştirin.

      ossfs bucket_name mount_point -o url=endpoint -o allow_other -o uid=1000 -o gid=1000 -o umask=007 -o sigv4 -o region=cn-hangzhou

Kullanışlı ipuçları

Başlangıçta otomatik bağlama

El ile bağlanan bir paket, sistem yeniden başlatıldığında otomatik olarak yeniden bağlanmaz. Başlangıçta otomatik bağlamayı etkinleştirmek için şu adımları izleyin. Otomatik bağlamayı etkinleştirmeden önce el ile bağlamanın başarılı olduğundan emin olun. Bu, ECS başlatma hatalarını önler. Aşağıdaki yöntem, ossfs'yi bir AccessKey çiftiyle yapılandırdıktan sonra otomatik bağlamayı etkinleştirir.

  1. Paket adını, AccessKey ID'sini, AccessKey gizli anahtarını ve diğer bilgileri /etc/passwd-ossfs dosyasına yazın ve dosya izinlerini 640 olarak ayarlayın.

    Yapılandırma adımları hakkında daha fazla bilgi için bkz. Configure ossfs 1,0.

  2. Başlangıçta otomatik bağlamayı ayarlayın.

    Not

    Aşağıdaki örnekler, yaygın dağıtımlar ve sürümler için başlangıçta otomatik bağlamayı nasıl etkinleştireceğinizi gösterir. Diğer dağıtımlar ve sürümler için dağıtımınızın belgelerine bakın.

    Mount with fstab

    1. /etc/fstab dosyasına aşağıdaki satırı ekleyin:

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

      Aşağıdaki tabloda parametreler açıklanmaktadır.


      Parametre


      Açıklama


      bucket_name


      Bağlanacak paketin adı. bucket_name ifadesini paketinizin adıyla değiştirin.


      mount_point


      Yerel bağlama dizini. mount_point ifadesini yerel bağlama dizininizin yoluyla değiştirin.


      url=url


      Hedef paketin uç noktası.


      0 0


      Dosya sistemi seçenekleri.

    2. /etc/fstab dosyasını kaydedin. mount -a -t fuse komutunu çalıştırın. Hata bildirilmezse yapılandırma doğrudur.

    3. Önceki adım tamamlandıktan sonra Ubuntu 14.04'te otomatik bağlama etkinleştirilir. CentOS 6.5 için ayrıca aşağıdaki komutu çalıştırmanız gerekir:

      chkconfig netfs on

    Mount with a startup script

    1. /etc/init.d/ dizininde ossfs adlı bir dosya oluşturun ve aşağıdaki içeriği dosyaya kopyalayın. Bağlama komutundaki değerleri hedef paket bilgilerinizle değiştirin.

      #! /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. Yeni ossfs betiğine yürütme izni verin:

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

      Komut çalıştırıldıktan sonra betiği çalıştırmayı deneyebilirsiniz. Betik içeriği doğruysa OSS paketi belirtilen dizine bağlanır.

    3. ossfs betiğini bir hizmet olarak önyüklemede başlayacak şekilde yapılandırın:

      chkconfig ossfs on
    4. Yukarıdaki adımları uyguladıktan sonra ossfs başlangıçta otomatik olarak bağlanır.

    Önemli

    chkconfig ossfs beklenmedik şekilde çıkış yaparsa otomatik olarak yeniden başlatmaz. Yalnızca ossfs'nin önyüklemede otomatik olarak başlamasını sağlar.

Paketin bağlantısını kaldırma

Bir paketin bağlantısını kaldırmak için aşağıdaki komutu çalıştırın. Örneğin, /tmp/ossfs konumuna bağlanan dosya sisteminin bağlantısını kaldırmak için:

umount /tmp/ossfs

SSS