Object Storage Service:View options

Format de la commande

./ossfs -h

Exécutez cette commande depuis le répertoire contenant l'exécutable ossfs (généralement /usr/local/bin/, mais cela peut varier selon votre installation).

Options courantes

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

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

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

# 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

ossfs bucket_name mount_point -omax_stat_cache_size=0

ossfs bucket_name mount_point -ourl=endpoint -oallow_other

ossfs bucket_name mount_point -odbglevel=info

ossfs bucket_name mount_point -f

ossfs bucket_name mount_point -d

Liste des options

Dans la plupart des cas, le format de l'option est -ooption_name=option_value ou -o option_name=option_value.

• Options ossfs

  Option	Description
  retries	Spécifie le nombre de tentatives après l'échec d'une requête. La valeur par défaut est 2.
  storage_class	Spécifie la classe de stockage pour les fichiers écrits dans OSS. Les valeurs valides sont : Standard (par défaut) : Standard IA : Infrequent Access Archive : Archive Storage Pour plus d'informations sur les classes de stockage, consultez Classes de stockage.
  public_bucket	Spécifie si l'accès au bucket se fait de manière anonyme. Cette option n'est valide que pour les buckets dont la liste de contrôle d'accès (ACL) est public-read-write. Les valeurs valides sont : 0 (par défaut) : N'accédez pas au bucket de manière anonyme. 1 : Accédez au bucket de manière anonyme.
  passwd_file	Spécifie le fichier qui stocke la paire AccessKey pour le bucket. Le fichier par défaut est /etc/passwd-ossfs.
  connect_timeout	Spécifie le délai de connexion en secondes. La valeur par défaut est 300 secondes.
  readwrite_timeout	Spécifie le délai d'expiration pour les requêtes de lecture ou d'écriture en secondes. La valeur par défaut est 120 secondes.
  max_stat_cache_size	Spécifie le nombre d'entrées de métadonnées de fichiers à mettre en cache. La valeur par défaut est 100 000, ce qui consomme environ 40 Mo d'espace supplémentaire.
  readdir_optimize	Lorsqu'elle est activée, cette option optimise les performances de la commande ls en évitant les requêtes HeadObject pour les métadonnées des fichiers. Les appels HeadObject ne sont effectués que si la taille d'un fichier est égale à 0. Notez que certaines requêtes HeadObject peuvent toujours se produire pour d'autres raisons, comme les vérifications d'autorisations. Sélectionnez ce paramètre en fonction des attributs de votre application. Pour activer cette fonctionnalité, ajoutez -oreaddir_optimize lors du montage du bucket.
  stat_cache_expire	Spécifie la durée d'expiration du cache des métadonnées de fichiers en secondes. La valeur par défaut est 900 secondes.
  no_check_certificate	Désactive la vérification du certificat côté serveur. Cette option n'est valide que lorsque vous utilisez le protocole HTTPS. Par défaut, la vérification du certificat est activée. Cette option ne prend aucune valeur. Pour l'utiliser, ajoutez simplement l'option -ono_check_certificate.
  multireq_max	Spécifie le nombre maximal de requêtes simultanées pour accéder aux métadonnées des fichiers lors de la liste des fichiers. La valeur par défaut est 20.
  parallel_count	Spécifie le nombre de parties concurrentes lors du téléchargement d'un fichier volumineux en mode multipart upload. La valeur par défaut est 5.
  multipart_size	Spécifie la taille de chaque partie en Mo pour les téléchargements multipart. La valeur par défaut est 10. Ce paramètre affecte la taille maximale de fichier prise en charge. Le nombre maximal de parties pour un téléchargement multipart est de 10 000. Avec la valeur par défaut, la taille maximale de fichier prise en charge est de 100 Go. Pour prendre en charge des fichiers plus volumineux, ajustez cette valeur selon vos besoins.
  url	Spécifie l'endpoint du bucket.
  umask	Définit le masque d'autorisations pour les fichiers et les dossiers dans la cible de montage. Par exemple, pour définir les autorisations des fichiers et des dossiers dans la cible de montage sur 770, ajoutez -oumask=007. Pour définir les autorisations sur 700, ajoutez -oumask=077. Remarque Version 1.91.* : L'autorisation par défaut pour les fichiers est 0640 et l'autorisation par défaut pour les dossiers est 0750. Version 1.80.* : L'autorisation par défaut pour les fichiers et les dossiers est 0777.
  enable_content_md5	Spécifie s'il faut définir CONTENT_MD5 lors d'une opération de téléchargement. Par défaut, ce n'est pas défini. Pour définir Content-MD5, ajoutez l'option -oenable_content_md5.
  ram_role	Utilise un rôle RAM pour accéder à OSS. Lorsque vous utilisez cette méthode pour accéder à OSS, l'AccessKey ID et l'AccessKey secret dans le fichier de clé sont ignorés.
  listobjectsv2	Si le versioning est activé pour le bucket, utilisez l'option -olistobjectsv2 pour lister les fichiers.
  notsup_compat_dir	Restreint les types de répertoires incompatibles. Par défaut, ossfs reconnaît dir/, dir et dir_$folder$ comme des répertoires. Si vous souhaitez restreindre ossfs pour qu'il ne reconnaisse que dir/ comme répertoire afin de réduire les interactions entre ossfs et le serveur, utilisez l'option -onotsup_compat_dir.
  direct_read	Active la lecture directe des données depuis OSS sans les mettre en cache sur le disque local. Par défaut, ossfs utilise un répertoire temporaire local. Pour activer ce mode, utilisez -odirect_read. Remarque Si une opération d'écriture, de renommage ou de troncature est détectée sur un fichier pendant une lecture directe, le fichier quitte le mode de lecture directe jusqu'à ce qu'il soit rouvert.
  direct_read_chunk_size	En mode de lecture directe, spécifie la quantité de données à lire depuis OSS en une seule requête de lecture. L'unité est le Mo. La valeur par défaut est 4. La plage de valeurs va de 1 à 32. Cette option s'applique uniquement lorsque -odirect_read est activé.
  direct_read_prefetch_thread	En mode de lecture directe, ossfs effectue des prélectures en tant que tâches asynchrones en arrière-plan. Cette option spécifie le nombre maximal de threads pour les requêtes de prélecture simultanées. La valeur par défaut est 64. Cette option s'applique uniquement lorsque -odirect_read est activé.
  direct_read_prefetch_chunks	En mode de lecture directe, spécifie le nombre de blocs à précharger en mémoire. Cela améliore les performances d'ossfs dans les scénarios de lecture séquentielle. La valeur par défaut est 32. Cette option s'applique uniquement lorsque -odirect_read est activé.
  direct_read_prefetch_limit	En mode de lecture directe, ossfs utilise la mémoire pour mettre en cache les données préchargées depuis OSS. Cette option limite la quantité totale de données qu'ossfs peut précharger. L'unité est le Mo. La valeur par défaut est 1024. Cette option s'applique uniquement lorsque -odirect_read est activé.
  dbglevel	Définit le niveau de journalisation. Les niveaux de journalisation pris en charge sont les suivants : critical (par défaut) error warn info debug
  curldbg	Active la journalisation libcurl. Par défaut, cette fonctionnalité est désactivée. Pour afficher les journaux libcurl, ajoutez l'option -ocurldbg.

• Options de cache de données

  Remarque

  Pour plus d'informations sur les principes de mise en cache des données, consultez Mise en cache des données.

  Option	Description
  use_cache	Active la mise en cache des données et spécifie le chemin du cache de données. Par défaut, cette fonctionnalité est désactivée. Spécifiez cette option pour configurer le chemin du cache. Par exemple, ajoutez -ouse_cache=path lors du montage pour activer la mise en cache des données et définir le chemin du cache de données sur path. Définissez path sur le chemin réel, tel que /tmp/your_foldername.
  ensure_diskfree	Contrôle la quantité d'espace disque réservé. Par défaut, aucun espace n'est réservé. Utilisez cette option pour définir la quantité d'espace disque libre à réserver en Mo. Cela empêche le disque de devenir plein et d'affecter d'autres applications. Par exemple, pour garantir qu'au moins 1 024 Mo d'espace disque libre sont disponibles, ajoutez -oensure_diskfree=1024 lors du montage.
  del_cache	Contrôle la suppression du cache local. Par défaut, le cache n'est pas supprimé. Définissez cette option pour configurer ossfs afin qu'il efface le cache de données local. Par exemple, si vous ajoutez l'option -odel_cache, ossfs efface les fichiers de cache dans le dossier spécifié par use_cache lors des opérations de montage et de démontage.
  max_dirty_data	Lorsque la taille d'un fichier en cours d'écriture dépasse cette valeur, le fichier temporaire intermédiaire est téléchargé avant la fermeture du fichier. La valeur par défaut est 5 120 Mo. Par exemple, pour télécharger un fichier lorsque sa taille dépasse 2 000 Mo, ajoutez -omax_dirty_data=2000 lors du montage. Si vous activez le versioning pour OSS, l'écriture d'un fichier volumineux peut générer des fichiers intermédiaires pour plusieurs versions. Définissez cette option sur une valeur élevée.
  tmpdir	Par défaut, les données sont temporairement mises en cache dans le répertoire /tmp du disque système. Spécifiez cette option pour configurer le chemin de cache temporaire par défaut. Cette option ne peut pas être utilisée avec l'option use_cache. Par exemple, ajoutez -otmpdir=path lors du montage pour définir le chemin de cache temporaire des données par défaut sur path. Définissez path sur le chemin réel, tel que /data/your_foldername.
  free_space_ratio	Contrôle le pourcentage minimal d'espace disque libre à maintenir après la mise en cache. Par exemple, si l'espace disque est de 50 Go et que vous définissez cette option sur -ofree_space_ratio=20, 10 Go d'espace (50 Go × 20 %) sont réservés.
  disable_noobj_cache	Cette option a été ajoutée dans ossfs 1.91.6. Elle désactive ou active la mise en cache des métadonnées noobj. Si elle est activée, les informations sont mises en cache même si le fichier n'existe pas. La valeur par défaut est false (activé). Par exemple, ajoutez -o disable_noobj_cache lors du montage pour désactiver la mise en cache des métadonnées noobj. Dans ossfs 1.91.6 et versions ultérieures, la mise en cache noobj est utilisée par défaut. Pour la désactiver, ajoutez cette option.

• Options FUSE

  Option	Description
  allow_other	Modifie les autorisations de la cible de montage pour permettre à tous les utilisateurs d'accéder au répertoire de montage. Cela n'inclut pas les fichiers du répertoire. Vous devez définir séparément les autorisations pour les fichiers du répertoire. Pour modifier les autorisations d'un fichier spécifique, utilisez la commande chmod. Pour définir les mêmes autorisations pour tous les fichiers, configurez l'option umask. Par défaut, seul l'utilisateur root peut définir l'option -oallow_other. L'option ne prend aucune valeur. Pour l'utiliser, ajoutez simplement l'option -oallow_other.
  uid	Spécifie l'ID utilisateur (UID) de l'utilisateur propriétaire du dossier.
  gid	Spécifie l'ID de groupe (GID) de l'utilisateur propriétaire du dossier.