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 para visualizar os parâmetros compatíveis com o 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 o caminho pode variar conforme a instalação).

Opções comuns

O ossfs baseia-se no Filesystem in Userspace (FUSE) e suporta tanto 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 da opção é:

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

Por exemplo, para especificar 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:

Opção	Descrição
url	Define o endpoint do bucket. O formato é `url=endpoint`. Se nenhum protocolo de requisição for especificado, o HTTP será usado por padrão. Exemplos: `-ourl=oss-cn-hangzhou.aliyuncs.com -ourl=http://oss-cn-hangzhou.aliyuncs.com -ourl=https://oss-cn-hangzhou.aliyuncs.com`
passwd_file	Especifica o arquivo que armazena o par de AccessKey do bucket. O arquivo padrão é /etc/passwd-ossfs. Configure as permissões do arquivo corretamente. Se o arquivo de chave for /etc/passwd-ossfs, defina as permissões como 640. Caso contrário, defina as permissões como 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	Define a quantidade de entradas de metadados de arquivos armazenáveis em cache. O valor padrão é 100.000. Se um diretório contiver muitos arquivos, aumente esse valor para acelerar o comando ls. Para desativar o cache de metadados, defina esta opção como 0. `ossfs bucket_name mount_point -omax_stat_cache_size=0`
allow_other	Permite que todos os usuários do sistema acessem o diretório do ponto de montagem. Isso afeta apenas o ponto de montagem, não os arquivos internos. Gerencie as permissões dos arquivos separadamente (por exemplo, via opção `umask` ou `chmod`). Esta opção não recebe valor e deve ser especificada simplesmente como `-oallow_other`. Por padrão, apenas o usuário root pode usá-la. `ossfs bucket_name mount_point -ourl=endpoint -oallow_other`
dbglevel	Configura o nível de log. Os níveis suportados são critical, error, warn, info e debug. O valor padrão é critical. Por exemplo, para ativar o nível de log info, adicione a opção -odbglevel=info. As informações de log são gravadas no log do sistema. Em sistemas CentOS, por exemplo, os logs vão para /var/log/messages. `ossfs bucket_name mount_point -odbglevel=info`
f	Executa o ossfs em primeiro plano, em vez de como um processo daemon. No modo de primeiro plano, os logs aparecem na tela do terminal. Use este parâmetro geralmente para depuração. `ossfs bucket_name mount_point -f`
d	Ativa o registro de logs. Esta opção também é passada para o FUSE. No ossfs, 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 de opções a seguir aplicam-se ao ossfs 1.91.2 e versões posteriores. Algumas opções podem não ser suportadas ou ter valores padrão diferentes em outras versões. Para verificar a versão do ossfs, acesse o diretório onde o programa está localizado e execute o comando ./ossfs --version. O diretório padrão do programa ossfs é /usr/local/bin/. O diretório real depende do seu ambiente de instalação.

Opções do ossfs

Opção	Descrição
retries	Define o número de novas tentativas após falha na requisição. O valor padrão é 2.
storage_class	Especifica 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 Classes de armazenamento.
public_bucket	Determina 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 acessar o bucket anonimamente. 1: Acessar o bucket anonimamente.
passwd_file	Especifica o arquivo que armazena o par de AccessKey do bucket. O arquivo padrão é /etc/passwd-ossfs.
connect_timeout	Define o tempo limite de conexão em segundos. O valor padrão é 300 segundos.
readwrite_timeout	Define o tempo limite para requisições de leitura ou gravação em segundos. O valor padrão é 120 segundos.
max_stat_cache_size	Limita o número de entradas de metadados de arquivos mantidas em cache. O valor padrão é 100.000, o que consome cerca de 40 MB de espaço adicional.
readdir_optimize	Quando ativada, otimiza o desempenho do comando `ls` ao evitar requisições `HeadObject` para metadados de arquivos. Chamadas `HeadObject` ocorrem apenas se o tamanho do arquivo for 0. 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. Para ativar esse recurso, adicione `-oreaddir_optimize` ao montar o bucket.
stat_cache_expire	Define o tempo de expiração do cache de metadados de arquivos em segundos. O valor padrão é 900 segundos.
no_check_certificate	Desativa a verificação de certificado no lado 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 possui valor. Para usá-la, basta adicionar a opção -ono_check_certificate.
multireq_max	Define o número máximo de requisições simultâneas para acessar metadados de arquivos ao listar arquivos. O valor padrão é 20.
parallel_count	Especifica o número de partes simultâneas ao enviar um arquivo grande no modo de upload multipart. O valor padrão é 5.
multipart_size	Define 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 suportar arquivos maiores, ajuste este valor conforme necessário.
url	Especifica o endpoint do bucket.
umask	Define a máscara de permissão para arquivos e pastas no destino de montagem. Por exemplo, para definir as permissões de arquivos e pastas no destino de montagem como 770, adicione -oumask=007. Para definir as permissões como 700, adicione -oumask=077. Nota Versão 1.91.: A permissão padrão para arquivos é 0640 e para pastas é 0750. Versão 1.80.: A permissão padrão para arquivos e pastas é 0777.
enable_content_md5	Determina se o CONTENT_MD5 será definido durante uma operação de upload. Por padrão, isso não é definido. Para configurar 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 de acesso, o AccessKey ID e o AccessKey secret presentes no arquivo de chave são ignorados.
listobjectsv2	Se o versionamento estiver ativado para o bucket, use a opção -olistobjectsv2 para listar arquivos.
notsup_compat_dir	Restringe tipos de diretórios incompatíveis. Por padrão, o ossfs reconhece `dir/`, `dir` e `dir_$folder$` como diretórios. Para restringir o reconhecimento do ossfs apenas a `dir/` como diretório e reduzir interações entre o ossfs e o servidor, use a opção -onotsup_compat_dir.
direct_read	Permite ler dados diretamente do OSS sem armazenamento em cache no disco local. Por padrão, o ossfs usa um diretório temporário local. Para ativar este modo, use `-odirect_read`. Nota Se uma operação de escrita, renomeação ou truncamento for detectada em um arquivo durante uma leitura direta, o arquivo sairá do modo de leitura direta até ser reaberto.
direct_read_chunk_size	No modo de leitura direta, define a quantidade de dados lidos do OSS em uma única requisição de leitura. A unidade é MB. O valor padrão é 4. O intervalo válido é de 1 a 32. Esta opção aplica-se apenas quando `-odirect_read` está ativado.
direct_read_prefetch_thread	No modo de leitura direta, o ossfs executa 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 aplica-se apenas quando `-odirect_read` está ativado.
direct_read_prefetch_chunks	No modo de leitura direta, define o número de blocos a serem pré-carregados na memória. Isso melhora o desempenho do ossfs em cenários de leitura sequencial. O valor padrão é 32. Esta opção aplica-se apenas quando `-odirect_read` está ativado.
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 aplica-se apenas quando `-odirect_read` está ativado.
dbglevel	Define o nível de log. Os níveis de log suportados são: critical (padrão) error warn info debug
curldbg	Ativa o registro de logs da libcurl. Por padrão, isso está desativado. Para gerar logs da 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 Cache de dados.

Opção	Descrição
use_cache	Ativa o cache de dados e especifica o caminho do cache. Por padrão, este recurso está desativado. Especifique esta opção para configurar o caminho do cache. Por exemplo, adicione `-ouse_cache=path` durante a montagem para ativar o cache de dados e definir o caminho do cache como path. Defina path como o caminho real, como /tmp/your_foldername.
ensure_diskfree	Controla a quantidade de espaço em disco reservado. Por padrão, nenhum espaço é reservado. Use esta opção para definir a quantidade de espaço livre em disco a ser reservada em MB. Isso evita que o disco fique cheio e afete outros aplicativos. Por exemplo, para garantir pelo menos 1024 MB de espaço livre em disco, adicione `-oensure_diskfree=1024` durante a montagem.
del_cache	Controla a exclusão do cache local. Por padrão, o cache não é excluído. Configure esta opção para que o ossfs limpe o cache de dados local. Por exemplo, se você adicionar a opção `-odel_cache`, o ossfs limpará 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 gravação excede este valor, o arquivo temporário intermediário é enviado antes do fechamento do 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, gravar 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, os dados são temporariamente armazenados em cache no diretório /tmp no disco do sistema. Especifique esta opção para configurar o caminho padrão do cache temporário. Esta opção não pode ser usada junto com a opção use_cache. Por exemplo, adicione `-otmpdir=path` durante a montagem para definir o caminho padrão do cache temporário de dados como path. Defina path como o caminho real, como /data/your_foldername.
free_space_ratio	Controla a porcentagem mínima de espaço livre em disco a ser mantida após o armazenamento em cache. Por exemplo, se o espaço em disco for de 50 GB e você definir esta opção como -ofree_space_ratio=20, 10 GB de espaço (50 GB × 20%) serão reservados.
disable_noobj_cache	Adicionada no ossfs 1.91.6. Desativa ou ativa o cache de metadados noobj. Se ativada, as informações são armazenadas 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 posterior, o cache noobj é usado por padrão. Para desativá-lo, adicione esta opção.

Opções do FUSE

Opção	Descrição
allow_other	Altera as permissões do destino de montagem para permitir que todos os usuários acessem o diretório de montagem. Isso não inclui os arquivos dentro do diretório. Defina as permissões para os arquivos no diretório separadamente. Para modificar as permissões de um arquivo específico, use o comando `chmod`. Para definir as mesmas permissões para todos os arquivos, configure a opção `umask`. Por padrão, apenas o usuário root pode definir a opção `-oallow_other`. A opção não possui valor. Para usá-la, basta adicionar a opção `-oallow_other`.
uid	Especifica o ID de usuário (UID) do proprietário da pasta.
gid	Especifica o ID de grupo (GID) do proprietário da pasta.