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 de acesso ao 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	AccessKey Secret. 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 comuns

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 do bucket.	Vazio	v2.0.0 e posterior
Configuração do bucket	oss_region	Não	ID da região do bucket, usado no 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 consumo de memória.	true	v2.0.0 e posterior
	disk_data_cache_dir	Não	Caminho do diretório de cache local. Definir um valor não vazio ativa o cache de dados. Para mais informações, consulte Local data cache.	Vazio	v2.0.8 e posterior
	disk_data_cache_size	Condicionalmente obrigatório	Capacidade máxima de 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. O parâmetro disk_data_cache_dir pode ficar vazio. Se disk_data_cache_dir for especificado, defina este parâmetro com um valor válido.	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 do modo de gravação	temp_dir	Não	Caminho do diretório temporário local. Deve ser um caminho absoluto. Definir um valor não vazio ativa o modo de gravação aleatória baseado em diretório temporário local, com suporte completo à semântica de gravação POSIX (gravações em offsets arbitrários e truncamento para qualquer tamanho). Deixe vazio para desativar esse recurso. Para mais informações, consulte Configure a local temporary directory to support random writes.	Vazio	v2.0.9 e posterior
	temp_dir_free_bytes	Não	Espaço livre mínimo reservado no disco onde reside o diretório temporário, em bytes (aceita unidades como K, M e G). Quando o espaço livre cai abaixo deste limiar, novas gravações retornam ENOSPC. Se o espaço livre já estiver abaixo desse valor no momento da montagem, a operação falha. Valor mínimo: 64 MiB.	1 GiB	v2.0.9 e posterior
	random_write_max_file_size	Não	Tamanho lógico máximo de um único objeto no modo de gravação aleatória, em bytes (aceita unidades como K, M e G). Gravações ou truncamentos que excedam esse limite retornam EFBIG. O limite físico superior é a capacidade de upload multipart do OSS (10.000 partes × 5 GiB, cerca de 48,8 TiB).	100 GiB	v2.0.9 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 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	Defina 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	Defina 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	Defina o modo de permissão para todos os arquivos no ponto de montagem.	0777	v2.0.1 e posterior
	dir_mode	Não	Defina 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 é validado pelas permissões do arquivo.	true	v2.0.1 e posterior

Nota

Os parâmetros gid e uid têm efeito apenas no momento da montagem. Após montar o sistema de arquivos, executar chown ou chmod em arquivos ou diretórios no ponto de montagem retorna sucesso (código de saída 0), mas não altera efetivamente o UID, GID ou as permissões. Para alterar o UID ou GID, execute fusermount -u <mount point> para desmontar o sistema de arquivos e, em seguida, execute novamente o comando ossfs2 mount com novos valores de --uid e --gid. Após a remontagem, todos os arquivos no ponto de montagem, incluindo os existentes e os recém-criados, exibirão o novo UID e GID.

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 source 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 requisições ao OSS.	Vazio	v2.0.8 e posterior
Configuração de upload	upload_buffer_size	Não	Tamanho do buffer de upload multipart (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 multipart.	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 handle 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 handle 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 metadados automaticamente. Inteiro positivo: o ossfs 2.0 remove entradas excedentes quando a contagem de 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 arquivo.	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 requisiçã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 esta 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 source 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 arquivo, 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 ao anexar.	0	v2.0.5 e posterior
	enable_symlink	Não	Ativa o recurso de symlink. Symlinks só podem ser criados dentro do ponto de montagem usando caminhos relativos.	false	v2.0.6 e posterior
Configuração de timeout de requisição	oss_request_timeout_ms	Não	Timeout para requisiçõ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 requisição OSS 404 em cache, em segundos.	0	v2.0.2 e posterior
	oss_negative_cache_size	Não	Número de itens de requisição OSS 404 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: Configure ossfs 2.0.
Mount a bucket to a local file system using ossfs 2.0.