Referência de configuração das opções de montagem do ossfs 2.0 - Object Storage Service: Central de Documentação do Alibaba Cloud

Itens de configuração básica

Categoria	Item de configuração	Obrigatório	Descrição	Valor padrão	Versões compatíveis
Configuração básica do bucket	oss_endpoint	Sim	Endpoint para acessar o bucket.	Nenhum	v2.0.0 e posterior
Configuração básica do bucket	oss_bucket	Sim	Nome do bucket.	Nenhum	v2.0.0 e posterior
Configuração de credenciais de acesso	oss_access_key_id	Condicionalmente obrigatório	AccessKey ID. Obrigatório para autenticação via AccessKey.	Nenhum	v2.0.0 e posterior
	oss_access_key_secret	Condicionalmente obrigatório	Segredo do AccessKey. Obrigatório para autenticação via AccessKey.	Nenhum	v2.0.0 e posterior
	ram_role	Condicionalmente obrigatório	Função RAM do ECS. Obrigatória para autenticação via função RAM do ECS.	Nenhum	v2.0.2 e posterior
	credential_process	Condicionalmente obrigatório	Comando para executar um processo externo e obter credenciais de acesso. Obrigatório para autenticação via processo externo.	Nenhum	v2.0.5 e posterior

Itens de configuração comum

Categoria	Item de configuração	Obrigatório	Descrição	Valor padrão	Versões compatíveis
Configuração do bucket	oss_bucket_prefix	Não	Monta uma pasta específica no bucket.	Vazio	v2.0.0 e posterior
Configuração do bucket	oss_region	Não	ID da região do bucket, usado pelo algoritmo de assinatura V4 do OSS. Se não especificado, reverte para V1.	Vazio	v2.0.0 e posterior
Configuração de cache	attr_timeout	Não	Tempo de vida (TTL) do cache de metadados de arquivo, em segundos.	60	v2.0.0 e posterior
	negative_timeout	Não	TTL do cache de entradas de diretório inválidas, em segundos.	0	v2.0.0 e posterior
	readdirplus	Não	Ativa o readdirplus. Cria o cache de metadados de arquivo sincronamente durante o readdir, aumentando o uso de memória.	true	v2.0.0 e posterior
	disk_data_cache_dir	Sim	Caminho do diretório de cache local. Definir um valor não vazio ativa o cache de dados. Para mais informações, consulte Cache de dados local.	Vazio	v2.0.8 e posterior
	disk_data_cache_size	Sim	Capacidade máxima do cache, alinhada a GiB. Não pode exceder o espaço disponível no disco ou partição onde reside o diretório de cache.	Vazio	v2.0.8 e posterior
	disk_data_cache_io_engine	Não	Mecanismo de E/S para o cache de disco. Valores válidos: psync e libaio.	psync	v2.0.8 e posterior
Configuração de log	log_level	Não	Nível de log. Valores válidos: info e debug.	info	v2.0.0 e posterior
	log_dir	Não	Pasta onde os arquivos de log são armazenados.	/tmp/ossfs2	v2.0.0 e posterior
	log_file_max_size	Não	Tamanho máximo de um único arquivo de log, em bytes.	67.108.864	v2.0.3 e posterior
	log_file_max_count	Não	Número máximo de arquivos de log a serem retidos.	8	v2.0.3 e posterior
Modo de execução	f	Não	Executa o ossfs em primeiro plano.	false	v2.0.0 e posterior
Modo de execução	d	Não	Executa o ossfs em primeiro plano com logs de depuração do FUSE ativados.	false	v2.0.0 e posterior
Modo de montagem	ro	Não	Monta o sistema de arquivos no modo somente leitura.	false	v2.0.0 e posterior
Configuração de permissões	gid	Não	Define o GID para todos os arquivos e diretórios no ponto de montagem.	GID do usuário que monta o sistema de arquivos	v2.0.1 e posterior
	uid	Não	Define o UID para todos os arquivos e diretórios no ponto de montagem.	UID do usuário que monta o sistema de arquivos	v2.0.1 e posterior
	file_mode	Não	Define o modo de permissão para todos os arquivos no ponto de montagem.	0777	v2.0.1 e posterior
	dir_mode	Não	Define o modo de permissão para todos os diretórios no ponto de montagem.	0777	v2.0.1 e posterior
	allow_other	Não	Permite que usuários não root acessem arquivos no ponto de montagem. O acesso é verificado pelas permissões do arquivo.	true	v2.0.1 e posterior

Configuração avançada

Categoria	Item de configuração	Obrigatório	Descrição	Valor padrão	Versões compatíveis
Configuração de rede	bind_ips	Não	Lista separada por vírgulas de endereços IP de origem para acesso ao OSS, como 192.168.0.1,192.168.0.2. Controla qual NIC é usada para aumentar o throughput em ambientes com múltiplas NICs.	Vazio	v2.0.3 e posterior
Configuração de rede	http_proxy	Não	Servidor proxy HTTP usado para encaminhar solicitações ao OSS.	Vazio	v2.0.8 e posterior
Configuração de upload	upload_buffer_size	Não	Tamanho do buffer de upload multipartido (parte) em bytes. O tamanho máximo gravável do arquivo é upload_buffer_size × 10.000.	8.388.608	v2.0.0 e posterior
	upload_concurrency	Não	Concorrência para uploads multipartidos.	64	v2.0.0 e posterior
	sync_upload	Não	Aguarda a conclusão do upload antes de retornar ao fechar o arquivo.	true	v2.0.0 e posterior
Configuração de download/prefetch	prefetch_concurrency	Não	Concorrência global para prefetch de download.	256	v2.0.0 e posterior
	prefetch_concurrency_per_file	Não	Concorrência para prefetch de download por identificador de arquivo.	64	v2.0.0 e posterior
	prefetch_chunk_size	Não	Tamanho de um bloco de prefetch, em bytes.	8.388.608	v2.0.0 e posterior
	prefetch_chunks	Não	Número de blocos de prefetch. O padrão é 3× prefetch_concurrency. Defina como -1 para memória de prefetch ilimitada por identificador de arquivo.	0 (configurado automaticamente com base em prefetch_concurrency)	v2.0.0 e posterior
Configuração de gerenciamento de memória	total_mem_limit	Não	Limite total de memória em bytes. A concorrência de upload e prefetch se ajusta automaticamente a esse limite. Sem essa opção, o prefetch de leitura usa um buffer de `prefetch_chunk_size prefetch_chunks` e as gravações usam `upload_buffer_size upload_concurrency`, alocando até ~8 GB no total. Garanta memória suficiente para evitar OOM. O padrão é metade da memória do sistema para sistemas com 16 GB ou menos. Sem limite para sistemas com mais de 16 GB.	0	v2.0.0 e posterior
Configuração de gerenciamento de memória	max_inode_cache_count	Não	Controla o número de entradas de metadados em cache. 0 (padrão): Sem controle ativo. O SO remove os metadados automaticamente. Inteiro positivo: o ossfs 2.0 remove as entradas excedentes quando a contagem do cache ultrapassa esse valor.	0	v2.0.4 e posterior
Verificação de arquivo/Configuração de metadados	enable_crc64	Não	Ativa a verificação CRC64 para gravações de arquivos.	true	v2.0.0 e posterior
Verificação de arquivo/Configuração de metadados	close_to_open	Não	Ativa a semântica close-to-open. Envia uma solicitação GetObjectMeta ao abrir o arquivo para garantir metadados em tempo real. Desativado por padrão. Nesse modo, a abertura do arquivo verifica o TTL do cache de metadados para decidir se consulta o OSS. Ativar essa opção força a consulta ao OSS sempre que o arquivo for aberto, o que aumenta significativamente a latência para muitos arquivos pequenos.	false	v2.0.0 e posterior
Configuração de operações de arquivo	rename_dir_limit	Não	Número máximo de arquivos e diretórios descendentes em uma pasta de origem para uma operação de renomeação. Exceder esse limite faz com que a renomeação falhe.	2.000.000	v2.0.0 e posterior
	enable_appendable_object	Não	Usa a operação AppendObject para gravações de arquivos, permitindo leitura e gravação simultâneas no mesmo arquivo.	false	v2.0.0 e posterior
	appendable_object_autoswitch_threshold	Não	Quando enable_appendable_object está ativado, objetos não anexáveis ≤ a este tamanho (em bytes) são convertidos automaticamente em objetos anexáveis durante a anexação.	0	v2.0.5 e posterior
Configuração de timeout de solicitação	oss_request_timeout_ms	Não	Timeout para solicitações ao OSS, em milissegundos.	60.000	v2.0.0 e posterior
Configuração de cache	oss_negative_cache_timeout	Não	TTL para itens de solicitação 404 do OSS em cache, em segundos.	0	v2.0.2 e posterior
	oss_negative_cache_size	Não	Número de itens de solicitação 404 do OSS em cache.	10.000	v2.0.2 e posterior
	memory_data_cache_size	Não	Pré-aloca um cache de leitura fixo para reduzir a amplificação de prefetch durante leituras concorrentes. Melhora o desempenho no carregamento de modelos multi-GPU.	0	v2.0.5 e posterior
	kernel_readdir_cache_timeout	Não	TTL para o cache de diretório do kernel, em segundos. Requer kernel Linux 4.20 ou posterior.	0	v2.0.7 e posterior

Referências

Exemplos de arquivos de configuração para cenários comuns: Configurar o ossfs 2.0.
Montar um bucket em um sistema de arquivos local usando o ossfs 2.0.