Use the -h option to view the setting parameters supported by ossfs - Object Storage Service: Central de Documentação do Alibaba Cloud

Use a opção -h e visualize os parâmetros suportados pelo ossfs.

Formato do comando

./ossfs -h

Execute este comando no diretório que contém o executável do ossfs (geralmente /usr/local/bin/, mas isso pode variar dependendo da sua instalação).

Opções comuns

O ossfs é baseado no Filesystem in Userspace (FUSE), portanto, suporta tanto suas opções específicas quanto as opções padrão do FUSE. Combine essas opções conforme necessário ao montar um bucket. O formato das opções é o seguinte:

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

Por exemplo, especifique os parâmetros uid e gid durante a montagem:

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

As opções comuns do ossfs são as seguintes:

Opção	Descrição
url	Defina o endpoint do bucket. O formato é `url=endpoint`. Se você não especificar um protocolo de requisição, o padrão é o HTTP. Exemplos: `-ourl=oss-cn-hangzhou.aliyuncs.com -ourl=http://oss-cn-hangzhou.aliyuncs.com -ourl=https://oss-cn-hangzhou.aliyuncs.com`
passwd_file	Indica o arquivo que armazena o par de AccessKey do bucket. O arquivo padrão é /etc/passwd-ossfs. Defina as permissões do arquivo corretamente. Se o arquivo de chave for /etc/passwd-ossfs, defina as permissões para 640. Se for diferente de /etc/passwd-ossfs, defina as permissões para 600. O formato do arquivo de chave é `${bucket}:${access-key-id}:{access-key-secret}`. Exemplos: # 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	Estabelece o número de entradas de metadados de arquivo para armazenamento em cache. O valor padrão é 100.000. Se um diretório contiver muitos arquivos, aumente este valor para acelerar o comando ls. Para desativar o cache de metadados, defina o valor desta opção como 0. `ossfs bucket_name mount_point -omax_stat_cache_size=0`
allow_other	Permite que todos os usuários no sistema acessem o diretório do ponto de montagem. Note que isso afeta apenas o ponto de montagem em si, e não os arquivos dentro dele. Gerencie as permissões de arquivo separadamente (por meio da opção `umask` ou do `chmod`). Esta opção não aceita valores e basta especificá-la como `-oallow_other`. Por padrão, somente o usuário root pode usá-la. `ossfs bucket_name mount_point -ourl=endpoint -oallow_other`
dbglevel	Configure o nível de log. Os níveis compatíveis são critical, error, warn, info e debug. O valor padrão é critical. Por exemplo, ative o nível de log info adicionando a opção -odbglevel=info. O ossfs grava as informações no log do sistema. Por exemplo, em um sistema CentOS, o sistema registra os logs em /var/log/messages. `ossfs bucket_name mount_point -odbglevel=info`
f	Execute o ossfs em primeiro plano, em vez de um processo daemon. No modo de primeiro plano, o sistema exibe os logs na tela do terminal. Este parâmetro é útil para depuração. `ossfs bucket_name mount_point -f`
d	Ative o registro em log. O ossfs também passa esta opção para o FUSE. No ossfs, esta opção equivale a -odbglevel=info. `ossfs bucket_name mount_point -d`

Lista de opções

Na maioria dos casos, o formato da opção é -ooption_name=option_value ou -o option_name=option_value.

Nota

As descrições das opções a seguir aplicam-se ao ossfs 1.91.2 e versões posteriores. Algumas opções podem não ser compatíveis ou ter valores padrão diferentes em outras versões. Visualize a versão do ossfs; acesse o diretório do programa ossfs e execute o comando ./ossfs --version. O diretório padrão do programa ossfs é /usr/local/bin/. O diretório efetivo depende do seu ambiente de instalação.

Opções do ossfs

Opção	Descrição
retries	Defina o número de tentativas após a falha de uma requisição. O valor padrão é 2.
storage_class	Determina a classe de armazenamento para arquivos gravados no oss. Os valores válidos são: Standard (padrão): Standard IA: Infrequent Access Archive: Archive Storage Para obter mais informações sobre classes de armazenamento, consulte Storage classes.
public_bucket	Indica se o acesso ao bucket será anônimo. Esta opção é válida apenas para buckets cuja lista de controle de acesso (ACL) é public-read-write. Os valores válidos são: 0 (padrão): Não acessa o bucket de forma anônima. 1: Acesse o bucket de forma anônima.
passwd_file	Especifique o arquivo que armazena o par de AccessKey do bucket. O arquivo padrão é /etc/passwd-ossfs.
connect_timeout	Estabelece o tempo limite de conexão em segundos. O valor padrão é 300 segundos.
readwrite_timeout	Defina o tempo limite para requisições de leitura ou gravação em segundos. O valor padrão é 120 segundos.
max_stat_cache_size	Configure o número de entradas de metadados de arquivo para armazenamento em cache. O valor padrão é 100.000, o que consome cerca de 40 MB de espaço extra.
readdir_optimize	Quando ativada, esta opção otimiza o desempenho do comando `ls` ao evitar requisições `HeadObject` para metadados de arquivo. O sistema faz chamadas `HeadObject` apenas se o tamanho do arquivo for 0. Note que algumas requisições `HeadObject` ainda podem ocorrer por outros motivos, como verificações de permissão. Selecione este parâmetro com base nos atributos da sua aplicação. Ative este recurso adicionando `-oreaddir_optimize` ao montar o bucket.
stat_cache_expire	Determina o tempo de expiração do cache de metadados de arquivo em segundos. O valor padrão é 900 segundos.
no_check_certificate	Desativa a verificação de certificado do servidor. Esta opção é válida apenas ao usar o protocolo HTTPS. Por padrão, a verificação de certificado está ativada. Esta opção não aceita valores. Para usá-la, basta adicionar a opção -ono_check_certificate.
multireq_max	Estabelece o número máximo de requisições simultâneas para acessar metadados de arquivo ao listar arquivos. O valor padrão é 20.
parallel_count	Define o número de partes simultâneas durante o upload de um arquivo grande no modo multipart. O valor padrão é 5.
multipart_size	Configura o tamanho de cada parte em MB para uploads multipart. O valor padrão é 10. Este parâmetro afeta o tamanho máximo de arquivo suportado. O número máximo de partes para um upload multipart é 10.000. Com o valor padrão, o tamanho máximo de arquivo suportado é 100 GB. Para aceitar arquivos maiores, ajuste este valor conforme necessário.
url	Indica o endpoint do bucket.
umask	Defina a máscara de permissão para arquivos e pastas no ponto de montagem. Por exemplo, defina as permissões de arquivos e pastas no ponto de montagem para 770 adicionando -oumask=007. Defina as permissões para 700 adicionando -oumask=077. Nota Versão 1.91.: A permissão padrão para arquivos é 0640 e a permissão padrão para pastas é 0750. Versão 1.80.: A permissão padrão para arquivos e pastas é 0777.
enable_content_md5	Determina se deve definir o CONTENT_MD5 durante uma operação de upload. Por padrão, esse valor não é definido. Para definir o Content-MD5, adicione a opção -oenable_content_md5.
ram_role	Usa uma função do RAM para acessar o oss. Ao usar este método para acessar o oss, o sistema ignora o AccessKey ID e o AccessKey Secret no arquivo de chave.
listobjectsv2	Se o versionamento estiver ativado para o bucket, use a opção -olistobjectsv2 para listar arquivos.
notsup_compat_dir	Restringe tipos de diretório incompatíveis. Por padrão, o ossfs reconhece `dir/`, `dir` e `dir_$folder$` como diretórios. Para restringir o ossfs a reconhecer apenas `dir/` como diretório e reduzir as interações entre o ossfs e o servidor, use a opção -onotsup_compat_dir.
direct_read	Ative a leitura de dados diretamente do oss sem armazená-los em cache no disco local. Por padrão, o ossfs usa um diretório temporário local. Ative este modo usando `-odirect_read`. Nota Se o ossfs detectar uma operação de gravação, renomeação ou truncamento em um arquivo durante uma leitura direta, o arquivo sai do modo de leitura direta até ser reaberto.
direct_read_chunk_size	No modo de leitura direta, defina a quantidade de dados para leitura do oss em uma única requisição de leitura. A unidade é MB. O valor padrão é 4. Os valores válidos variam de 1 a 32. Esta opção se aplica apenas quando o `-odirect_read` está ativada.
direct_read_prefetch_thread	No modo de leitura direta, o ossfs realiza pré-leituras como tarefas assíncronas em segundo plano. Esta opção especifica o número máximo de threads para requisições de pré-busca simultâneas. O valor padrão é 64. Esta opção se aplica apenas quando o `-odirect_read` está ativada.
direct_read_prefetch_chunks	No modo de leitura direta, estabelece o número de blocos para pré-busca na memória. Isso melhora o desempenho do ossfs em cenários de leitura sequencial. O valor padrão é 32. Esta opção se aplica apenas quando o `-odirect_read` está ativada.
direct_read_prefetch_limit	No modo de leitura direta, o ossfs usa memória para armazenar em cache os dados pré-buscados do oss. Esta opção limita a quantidade total de dados que o ossfs pode pré-buscar. A unidade é MB. O valor padrão é 1024. Esta opção se aplica apenas quando o `-odirect_read` está ativada.
dbglevel	Configure o nível de log. Os níveis de log compatíveis são os seguintes: critical (padrão) error warn info debug
curldbg	Ative o logging do libcurl. Por padrão, essa opção está desativada. Para gerar os logs do libcurl, adicione a opção -ocurldbg.

Opções de cache de dados

Nota

Para obter mais informações sobre os princípios de cache de dados, consulte Data caching.

Opção	Descrição
use_cache	Ative o cache de dados e especifique o caminho do cache de dados. Por padrão, este recurso está desativado. Especifique esta opção e configure o caminho do cache. Por exemplo, adicione `-ouse_cache=path` durante a montagem para ativar o cache de dados e defina o caminho do cache de dados como path. Substitua path pelo caminho real, como /tmp/your_foldername.
ensure_diskfree	Controla a quantidade de espaço em disco reservado. Por padrão, o sistema não reserva espaço. Use esta opção e defina a quantidade de espaço livre em disco para reservar em MB. Isso evita que o disco fique cheio, o que poderia afetar outras aplicações. Por exemplo, para garantir que pelo menos 1024 MB de espaço livre em disco estejam disponíveis, adicione `-oensure_diskfree=1024` durante a montagem.
del_cache	Controla a exclusão do cache local. Por padrão, o sistema não exclui o cache. Defina esta opção e configure o ossfs para limpar o cache de dados local. Por exemplo, ao adicionar a opção `-odel_cache`, o ossfs limpa os arquivos de cache na pasta especificada por `use_cache` durante as operações de montagem e desmontagem.
max_dirty_data	Quando o tamanho de um arquivo em processo de gravação excede este valor, o sistema envia o arquivo temporário intermediário antes de fechar o arquivo. O valor padrão é 5120 MB. Por exemplo, para enviar um arquivo quando seu tamanho exceder 2000 MB, adicione `-omax_dirty_data=2000` durante a montagem. Se o versionamento do oss estiver ativado, a gravação de um arquivo grande pode gerar arquivos intermediários para várias versões. Defina esta opção com um valor alto.
tmpdir	Por padrão, o ossfs armazena temporariamente os dados em cache no diretório /tmp no disco do sistema. Especifique esta opção e configure o caminho padrão do cache temporário. Esta opção não é compatível com a opção use_cache. Por exemplo, adicione `-otmpdir=path` durante a montagem e defina o caminho padrão do cache temporário de dados como path. Substitua path pelo caminho real, como /data/your_foldername.
free_space_ratio	Controla a porcentagem mínima de espaço livre em disco a manter após o armazenamento em cache. Por exemplo, se o espaço em disco for de 50 GB e você defina esta opção como -ofree_space_ratio=20, 10 GB de espaço (50 GB × 20%) serão reservados.
disable_noobj_cache	Esta opção foi adicionada no ossfs 1.91.6. Ela desativa ou ativa o cache de metadados noobj. Se ativada, o sistema armazena as informações em cache mesmo que o arquivo não exista. O valor padrão é false (ativado). Por exemplo, adicione `-o disable_noobj_cache` durante a montagem para desativar o cache de metadados noobj. No ossfs 1.91.6 e versões posteriores, o ossfs usa o cache noobj por padrão. Para desativá-lo, adicione esta opção.

Opções do FUSE

Opção	Descrição
allow_other	Modifique as permissões do ponto de montagem para permitir que todos os usuários acessem o diretório de montagem. Isso não inclui os arquivos no diretório. Defina as permissões para os arquivos no diretório separadamente. Modifique as permissões de um arquivo específico usando o comando `chmod`. Defina as mesmas permissões para todos os arquivos e configure a opção `umask`. Por padrão, apenas o usuário root pode usar a opção `-oallow_other`; defina a opção `-oallow_other` se tiver permissão. Esta opção não aceita valores. Para usá-la, basta adicionar a opção `-oallow_other`.
uid	Especifique o ID de usuário (UID) do usuário proprietário da pasta.
gid	Especifique o ID de grupo (GID) do usuário proprietário da pasta.