Tüm Ürünler
Search
Belge Merkezi

Object Storage Service:View options

Son Güncelleme:Oct 01, 2026

ossfs'nin desteklediği parametreleri görüntülemek için -h seçeneğini kullanın.

Komut biçimi

./ossfs -h

Bu komutu ossfs yürütülebilir dosyasını içeren dizinden çalıştırın (genellikle /usr/local/bin/, ancak kurulumunuza göre değişebilir).

Yaygın seçenekler

ossfs, Kullanıcı Alanında Dosya Sistemi (FUSE) üzerine inşa edildiğinden hem kendi özel seçeneklerini hem de standart FUSE seçeneklerini destekler. Bir paketi bağlarken bu seçenekleri ihtiyaca göre birleştirin. Seçenek biçimi aşağıdaki gibidir:

-o option_name[=option_value]  or  -ooption_name[=option_value]

Örneğin, bağlama sırasında uid ve gid parametrelerini belirtmek için:

ossfs bucket_name mount_point -ourl=endpoint -ouid=uid -ogid=gid

Yaygın ossfs seçenekleri şunlardır:

Seçenek

Açıklama

url

Paketin uç noktasını belirtir. Biçim url=endpoint şeklindedir. Bir istek protokolü belirtmezseniz varsayılan olarak HTTP kullanılır.

Örnekler:

-ourl=oss-cn-hangzhou.aliyuncs.com
-ourl=http://oss-cn-hangzhou.aliyuncs.com
-ourl=https://oss-cn-hangzhou.aliyuncs.com

passwd_file

Paket için AccessKey çiftini depolayan dosyayı belirtir. Varsayılan dosya /etc/passwd-ossfs şeklindedir. Dosya izinlerini doğru şekilde ayarlamanız gerekir. Anahtar dosyası /etc/passwd-ossfs ise izinleri 640 olarak ayarlayın. Anahtar dosyası /etc/passwd-ossfs değilse izinleri 600 olarak ayarlayın. Anahtar dosyasının biçimi ${bucket}:${access-key-id}:{access-key-secret} şeklindedir.

Örnekler:

# Write the key to the /etc/passwd-ossfs file and set the permissions to 640.
echo bucket-test:yourAccessKeyID:yourAccessKeySecret > /etc/passwd-ossfs
chmod 640 /etc/passwd-ossfs

# Write the key to the /passwd-path/passwd-ossfs file and set the permissions to 600.
echo bucket-test:yourAccessKeyID:yourAccessKeySecret > /passwd-path/passwd-ossfs
chmod 600 /passwd-path/passwd-ossfs

# Define the opasswd_file variable and set its value to /passwd-path/passwd-ossfs.
-opasswd_file=/passwd-path/passwd-ossfs

max_stat_cache_size

Önbelleğe alınabilecek dosya meta verisi girişlerinin sayısını belirtir. Varsayılan değer 100.000'dir. Bir dizin çok sayıda dosya içeriyorsa ls komutunun hızını artırmak için bu değeri artırın. Meta veri önbelleğini devre dışı bırakmak için bu seçeneği 0 olarak ayarlayın.

ossfs bucket_name mount_point -omax_stat_cache_size=0

allow_other

Sistemdeki tüm kullanıcıların bağlama noktası dizinine erişmesine izin verir. Bu ayarın yalnızca bağlama noktasının kendisini etkilediğini, içindeki dosyaları etkilemediğini unutmayın. Dosya izinleri ayrı olarak yönetilmelidir (örneğin umask seçeneği veya chmod aracılığıyla). Bu seçenek bir değer almaz ve yalnızca -oallow_other olarak belirtilir. Varsayılan olarak yalnızca root kullanıcısı bunu kullanabilir.

ossfs bucket_name mount_point -ourl=endpoint -oallow_other

dbglevel

Günlük düzeyini ayarlar. Desteklenen düzeyler critical, error, warn, info ve debug şeklindedir. Varsayılan değer critical'dir. Örneğin, info günlük düzeyini etkinleştirmek için -odbglevel=info seçeneğini ekleyin. Günlük bilgileri sistem günlüğüne yazılır. Örneğin, bir CentOS sisteminde günlükler /var/log/messages konumuna yazılır.

ossfs bucket_name mount_point -odbglevel=info

f

ossfs'yi bir arka plan işlemi olarak değil, ön planda çalıştırır. Ön plan modunda günlükler terminal ekranına çıkarılır. Bu parametre genellikle hata ayıklama amacıyla kullanılır.

ossfs bucket_name mount_point -f

d

Günlük kaydını etkinleştirir. Bu seçenek FUSE'a da iletilir. ossfs'de bu seçenek -odbglevel=info seçeneğine eşdeğerdir.

ossfs bucket_name mount_point -d

Seçenek listesi

Çoğu durumda seçenek biçimi -ooption_name=option_value veya -o option_name=option_value şeklindedir.

Not

Aşağıdaki seçenek açıklamaları ossfs 1,91.2 ve sonraki sürümler için geçerlidir. Bazı seçenekler diğer sürümlerde desteklenmeyebilir veya farklı varsayılan değerlere sahip olabilir. ossfs sürümünü görüntülemek için ossfs programının bulunduğu dizine gidin ve ./ossfs --version komutunu çalıştırın. ossfs programının varsayılan dizini /usr/local/bin/ şeklindedir. Gerçek dizin, kurulum ortamınıza bağlıdır.

  • ossfs seçenekleri

    Seçenek

    Açıklama

    retries

    Bir istek başarısız olduktan sonra yapılacak yeniden deneme sayısını belirtir. Varsayılan değer 2'dir.

    storage_class

    OSS'e yazılan dosyalar için depolama sınıfını belirtir. Geçerli değerler şunlardır:

    • Standard (varsayılan): Standard

    • IA: Infrequent Access

    • Archive: Archive Storage

    Depolama sınıfları hakkında daha fazla bilgi için bkz. Depolama sınıfları.

    public_bucket

    Pakete anonim olarak erişilip erişilmeyeceğini belirtir. Bu seçenek yalnızca erişim kontrol listesi (ACL) public-read-write olan paketler için geçerlidir. Geçerli değerler şunlardır:

    • 0 (varsayılan): Pakete anonim olarak erişme.

    • 1: Pakete anonim olarak eriş.

    passwd_file

    Paket için AccessKey çiftini depolayan dosyayı belirtir. Varsayılan dosya /etc/passwd-ossfs şeklindedir.

    connect_timeout

    Saniye cinsinden bağlantı zaman aşımı süresini belirtir. Varsayılan değer 300 saniyedir.

    readwrite_timeout

    Saniye cinsinden okuma veya yazma istekleri için zaman aşımı süresini belirtir. Varsayılan değer 120 saniyedir.

    max_stat_cache_size

    Önbelleğe alınacak dosya meta verisi girişlerinin sayısını belirtir. Varsayılan değer 100.000'dir ve bu yaklaşık 40 MB ek alan tüketir.

    readdir_optimize

    Etkinleştirildiğinde bu seçenek, dosya meta verileri için HeadObject isteklerinden kaçınarak ls komutu performansını optimize eder. HeadObject çağrıları yalnızca bir dosya boyutu 0 ise yapılır. İzin kontrolleri gibi diğer nedenlerle bazı HeadObject isteklerinin yine de gerçekleşebileceğini unutmayın. Bu parametreyi uygulama niteliklerinize göre seçin. Bu özelliği etkinleştirmek için paketi bağlarken -oreaddir_optimize ekleyin.

    stat_cache_expire

    Dosya meta verisi önbelleğinin saniye cinsinden sona erme süresini belirtir. Varsayılan değer 900 saniyedir.

    no_check_certificate

    Sunucu tarafı sertifika doğrulamasını devre dışı bırakır. Bu seçenek yalnızca HTTPS protokolünü kullandığınızda geçerlidir. Varsayılan olarak sertifika doğrulaması etkindir. Bu seçenek bir değer almaz. Kullanmak için yalnızca -ono_check_certificate seçeneğini ekleyin.

    multireq_max

    Dosyaları listelerken dosya meta verilerine erişmek için eşzamanlı isteklerin maksimum sayısını belirtir. Varsayılan değer 20'dir.

    parallel_count

    Parçalı yükleme modunda büyük bir dosya yüklerken eşzamanlı parça sayısını belirtir. Varsayılan değer 5'tir.

    multipart_size

    Parçalı yüklemeler için her bir parçanın MB cinsinden boyutunu belirtir. Varsayılan değer 10'dur. Bu parametre desteklenen maksimum dosya boyutunu etkiler. Parçalı bir yükleme için maksimum parça sayısı 10.000'dir. Varsayılan değerle desteklenen maksimum dosya boyutu 100 GB'dir. Daha büyük dosyaları desteklemek için bu değeri gerektiği gibi ayarlayın.

    url

    Paketin uç noktasını belirtir.

    umask

    Hedefteki dosya ve klasörler için izin maskesini ayarlar.

    Örneğin, hedefteki dosya ve klasörlerin izinlerini 770 olarak ayarlamak için -oumask=007 ekleyin. İzinleri 700 olarak ayarlamak için -oumask=077 ekleyin.

    Not
    • Sürüm 1,91.*: Dosyalar için varsayılan izin 0640, klasörler için varsayılan izin 0750'dir.

    • Sürüm 1,80.*: Hem dosyalar hem de klasörler için varsayılan izin 0777'dir.

    enable_content_md5

    Yükleme işlemi sırasında CONTENT_MD5 ayarlanıp ayarlanmayacağını belirtir. Varsayılan olarak bu ayarlanmaz. Content-MD5 ayarlamak için -oenable_content_md5 seçeneğini ekleyin.

    ram_role

    OSS'e erişmek için bir RAM rolü kullanır. OSS'e erişmek için bu yöntemi kullandığınızda anahtar dosyasındaki AccessKey ID ve AccessKey secret yoksayılır.

    listobjectsv2

    Paket için sürüm oluşturma etkinleştirildiyse dosyaları listelemek için -olistobjectsv2 seçeneğini kullanın.

    notsup_compat_dir

    Uyumsuz dizin türlerini kısıtlar. Varsayılan olarak ossfs dir/, dir ve dir_$folder$ öğelerini dizin olarak tanır.

    ossfs'nin sunucuyla etkileşimini azaltmak için yalnızca dir/ öğesini dizin olarak tanımasını kısıtlamak istiyorsanız -onotsup_compat_dir seçeneğini kullanın.

    direct_read

    Verilerin yerel diske önbelleğe alınmadan doğrudan OSS'ten okunmasını etkinleştirir. Varsayılan olarak ossfs yerel bir geçici dizin kullanır. Bu modu etkinleştirmek için -odirect_read kullanın.

    Not

    Doğrudan okuma sırasında bir dosyada yazma, yeniden adlandırma veya kesme işlemi algılanırsa dosya yeniden açılana kadar doğrudan okuma modundan çıkar.

    direct_read_chunk_size

    Doğrudan okuma modunda, tek bir okuma isteğinde OSS'ten okunacak veri miktarını belirtir. Birim MB'dir. Varsayılan değer 4'tür. Değer aralığı 1 ile 32 arasındadır.

    Bu seçenek yalnızca -odirect_read etkinleştirildiğinde uygulanır.

    direct_read_prefetch_thread

    Doğrudan okuma modunda ossfs, arka plan eşzamansız görevleri olarak ön okuma işlemleri gerçekleştirir. Bu seçenek, aynı anda gerçekleştirilecek ön getirme istekleri için maksimum iş parçacığı sayısını belirtir. Varsayılan değer 64'tür.

    Bu seçenek yalnızca -odirect_read etkinleştirildiğinde uygulanır.

    direct_read_prefetch_chunks

    Doğrudan okuma modunda, belleğe önceden getirilecek yığın sayısını belirtir. Bu, ossfs'nin sıralı okuma senaryolarındaki performansını artırır. Varsayılan değer 32'dir.

    Bu seçenek yalnızca -odirect_read etkinleştirildiğinde uygulanır.

    direct_read_prefetch_limit

    Doğrudan okuma modunda ossfs, OSS'ten önceden getirilen verileri önbelleğe almak için belleği kullanır. Bu seçenek, ossfs'nin önceden getirebileceği toplam veri miktarını sınırlar. Birim MB'dir. Varsayılan değer 1024'tür.

    Bu seçenek yalnızca -odirect_read etkinleştirildiğinde uygulanır.

    dbglevel

    Günlük düzeyini ayarlar. Desteklenen günlük düzeyleri şunlardır:

    • critical (varsayılan)

    • error

    • warn

    • info

    • debug

    curldbg

    libcurl günlük kaydını etkinleştirir. Varsayılan olarak bu özellik devre dışıdır. libcurl günlüklerini çıkarmak için -ocurldbg seçeneğini ekleyin.

  • Veri önbelleği seçenekleri

    Not

    Veri önbelleğe alma ilkeleri hakkında daha fazla bilgi için bkz. Veri önbelleğe alma.


    Seçenek


    Açıklama


    use_cache

    Veri önbelleğe almayı etkinleştirir ve veri önbelleği yolunu belirtir. Varsayılan olarak bu özellik devre dışıdır. Önbellek yolunu yapılandırmak için bu seçeneği belirtin.

    Örneğin, bağlama sırasında -ouse_cache=path ekleyerek veri önbelleğe almayı etkinleştirin ve veri önbelleği yolunu path olarak ayarlayın. Path'i /tmp/your_foldername gibi gerçek bir yola ayarlayın.


    ensure_diskfree

    Ayrılmış disk alanı miktarını kontrol eder. Varsayılan olarak hiçbir alan ayrılmaz. MB cinsinden ayrılacak boş disk alanı miktarını ayarlamak için bu seçeneği kullanın. Bu, diskin dolmasını ve diğer uygulamaları etkilemesini önler.

    Örneğin, en az 1024 MB boş disk alanının mevcut olduğundan emin olmak için bağlama sırasında -oensure_diskfree=1024 ekleyin.


    del_cache

    Yerel önbelleğin silinmesini kontrol eder. Varsayılan olarak önbellek silinmez. ossfs'nin yerel veri önbelleğini temizlemesini yapılandırmak için bu seçeneği ayarlayın.

    Örneğin, -odel_cache seçeneğini eklerseniz ossfs, bağlama ve bağlamayı kaldırma işlemleri sırasında use_cache tarafından belirtilen klasördeki önbellek dosyalarını temizler.


    max_dirty_data

    Yazılan bir dosyanın boyutu bu değeri aştığında, dosya kapatılmadan önce ara geçici dosya yüklenir. Varsayılan değer 5120 MB'dir.

    Örneğin, boyutu 2000 MB'ı aşan bir dosyayı yüklemek için bağlama sırasında -omax_dirty_data=2000 ekleyin. OSS için sürüm oluşturmayı etkinleştirirseniz büyük bir dosya yazmak birden çok sürüm için ara dosyalar oluşturabilir. Bu seçeneği büyük bir değere ayarlayın.


    tmpdir

    Varsayılan olarak veriler sistem diskindeki /tmp dizininde geçici olarak önbelleğe alınır. Varsayılan geçici önbellek yolunu yapılandırmak için bu seçeneği belirtin. Bu seçenek use_cache seçeneğiyle birlikte kullanılamaz.

    Örneğin, bağlama sırasında -otmpdir=path ekleyerek varsayılan geçici veri önbelleği yolunu path olarak ayarlayın. Path'i /data/your_foldername gibi gerçek bir yola ayarlayın.


    free_space_ratio

    Önbelleğe aldıktan sonra korunacak minimum boş disk alanı yüzdesini kontrol eder.

    Örneğin, disk alanı 50 GB ise ve bu seçeneği -ofree_space_ratio=20 olarak ayarlarsanız 10 GB alan (50 GB × %20) ayrılır.


    disable_noobj_cache

    Bu seçenek ossfs 1,91.6 sürümünde eklenmiştir. noobj meta veri önbelleğe almayı devre dışı bırakır veya etkinleştirir. Etkinleştirilirse dosya mevcut olmasa bile bilgiler önbelleğe alınır. Varsayılan değer false (etkin) şeklindedir.

    Örneğin, noobj meta veri önbelleğe almayı devre dışı bırakmak için bağlama sırasında -o disable_noobj_cache ekleyin. ossfs 1,91.6 ve sonraki sürümlerde noobj önbelleğe alma varsayılan olarak kullanılır. Devre dışı bırakmak için bu seçeneği ekleyin.

  • FUSE seçenekleri


    Seçenek


    Açıklama


    allow_other


    Tüm kullanıcıların bağlama dizinine erişmesine izin vermek için hedefin izinlerini değiştirir. Bu, dizindeki dosyaları kapsamaz. Dizindeki dosyaların izinlerini ayrı olarak ayarlamanız gerekir. Belirli bir dosyanın izinlerini değiştirmek için chmod komutunu kullanın. Tüm dosyalar için aynı izinleri ayarlamak üzere umask seçeneğini yapılandırın. Varsayılan olarak yalnızca root kullanıcısı -oallow_other seçeneğini ayarlayabilir. Seçenek bir değer almaz. Kullanmak için yalnızca -oallow_other seçeneğini ekleyin.


    uid


    Klasörün sahibi olan kullanıcının kullanıcı kimliğini (UID) belirtir.


    gid


    Klasörün sahibi olan kullanıcının grup kimliğini (GID) belirtir.