NOTAS DE ENGENHARIA

OpenMacFUSE: FUSE de código aberto para NTFS no Mac, sem extensão de kernel

OpenMacFUSE é uma camada FUSE de código aberto para macOS, executada no espaço do usuário e desenvolvida pela NTFSTool, que monta volumes NTFS, ext, exFAT e BitLocker no macOS pelo cliente NFS integrado ao sistema, sem extensão de kernel. Ela usa a licença MIT, é a camada de montagem padrão do NTFSTool Pro e dispensa o macFUSE e o FUSE-T. Este artigo explica como ela foi construída e a compara com o FUSE-T no mesmo Mac, com o mesmo motor NTFS.

Equipe de engenharia da NTFSTool · novembro de 2026 · Versões testadas: OpenMacFUSE c392a69, FUSE-T 1.0.49 · Código-fonte no GitHub

RESUMO

  • Desenvolvimento próprio. O OpenMacFUSE é um servidor NFSv4.0 incorporado ao processo do driver que expõe a API FUSE 2.x. São cerca de 17.000 linhas de C, implementadas a partir das RFCs 7530, 5531 e 4506 e publicadas sob a licença MIT. É uma das poucas implementações FUSE de código aberto para macOS que dispensam extensão de kernel.
  • Velocidade. A diferença é maior em cargas com muitas operações de metadados: calcular a soma de verificação de todos os arquivos de um volume leva 23 s, contra 797 s no FUSE-T, e apagar 10.000 arquivos pequenos é de 6 a 9 vezes mais rápido. Leituras e gravações sequenciais de arquivos grandes em discos USB reais não mostram diferença mensurável.
  • Memória. O processo do driver usa de 45 a 51 MB de memória física, independentemente do número de arquivos ou do tempo de atividade.
  • Confiabilidade. Se a energia do USB é cortada durante uma gravação, o driver desmonta o volume e encerra em até 0,5 s. Quando a energia volta, o volume monta normalmente e nenhum arquivo fica com conteúdo corrompido; as únicas perdas são gravações concluídas aproximadamente no último segundo.
  • Manutenção. A camada de protocolo, a interface FUSE e o motor NTFS ficam no mesmo código-fonte, então um problema na camada de montagem pode ser rastreado e corrigido diretamente, sem esperar o ciclo de lançamentos de terceiros.
35×Soma de verificação de todos os arquivos de um volume
23 s vs. 797 s
46 MBPico de memória ao ler 300 MB
381 MB com o FUSE-T
0,45 sDo corte de energia durante a gravação até o driver encerrar
medido em um SSD USB
869verificações automatizadas
todas aprovadas no macOS 12

1 Contexto2 Arquitetura3 Desempenho4 Memória5 Comportamento no macOS6 Tratamento de falhas7 Metodologia8 Limitações9 ConclusãoPerguntas frequentes

1Contexto

Desde o macOS 11, carregar uma extensão de kernel exige iniciar o Mac no modo de recuperação do macOS e mudar para Segurança Reduzida. Para um software voltado ao público em geral, esse caminho deixou de ser viável. Há duas formas principais de ficar fora do kernel: o FSKit da Apple (disponível a partir do macOS 15.4 e usado pelo "Driver 2" do NTFSTool) e o cliente NFS integrado ao macOS. A segunda abordagem executa um servidor NFS na própria máquina, converte as operações do sistema de arquivos em chamadas a um driver no espaço do usuário e monta o resultado com mount_nfs. O FUSE-T segue essa abordagem e é a implementação mais madura dela; por isso é a referência de todas as comparações deste artigo.

Decidimos implementar essa camada por conta própria por três motivos de engenharia:

2Arquitetura

O OpenMacFUSE é vinculado ao driver como biblioteca estática. Ao iniciar, o driver escuta em um endpoint local dentro do próprio processo e depois chama o mount_nfs do sistema. Cada requisição COMPOUND do cliente NFS do kernel é decodificada, enviada aos callbacks do FUSE e respondida dentro desse único processo. Não há segundo processo, nem cópia extra, nem troca de contexto pelo caminho.

FUSE-T Apps / Finderchamadas de sistema Cliente NFS do kernelparte do macOS Processo servidor NFSprocesso separado Processo do driverlibfuse-t + motor NTFS Disco TCPIPC Dois processos no espaço do usuário; cada requisição cruza duas fronteiras de processo OpenMacFUSE Apps / Finderchamadas de sistema Cliente NFS do kernelparte do macOS Processo do driver (processo único) OpenMacFUSEServidor NFSv4.0 FUSE 2.xchamadas de função Motor NTFS Disco socket Processo guardião (0,3 MB)remove a montagem se o driver parar
Figura 1 Caminho das requisições. O lado do FUSE-T segue o design publicado (um processo de driver mais um processo servidor NFS separado). O OpenMacFUSE coloca o servidor dentro do processo do driver, então a camada de protocolo chega ao motor do sistema de arquivos por chamadas de função comuns.

Transporte e opções de montagem

O macOS 26 e posteriores usam um socket de domínio Unix (proto=ticotsord). Nenhuma porta é aberta, e outros usuários da máquina não conseguem se conectar. O cliente do kernel no macOS 12 falha em gravações grandes nesse transporte, então as versões anteriores do macOS recorrem a TCP em 127.0.0.1, com duas verificações no servidor de que a conexão vem da montagem local. Estas são as opções que o sistema informou após uma montagem no macOS 27:

Log de teste · macOS 27.0.1 / arm64 · caminhos abreviados
$ nfsstat -m <mount point>
NFS parameters: vers=4.0,ticotsord,port=/var/folders/…/openmacfuse.P1wAL0/s,hard,intr,
  noresvport,nocallback,negnamecache,nonamedattr,noacl,noaclonly,locks,noquota,
  rsize=262144,wsize=262144,readahead=16,dsize=32768,nordirplus,nodumbtimer,
  timeo=10,maxgroups=16,…,deadtimeout=60
Figura 2 Opções de montagem. nonamedattr é o padrão do cliente do sistema e define como os atributos estendidos são tratados na seção 5. nordirplus foi escolha nossa; o custo dela é tratado na seção 8.

Decisões de implementação

3Desempenho

O OpenMacFUSE é de 6 a 35 vezes mais rápido que o FUSE-T 1.0.49 em cargas com muitos metadados e equivalente em leituras e gravações sequenciais em discos USB reais. Método: a mesma máquina, a mesma imagem de volume e o mesmo código-fonte do motor NTFS, compilado uma vez com o OpenMacFUSE e outra com o FUSE-T 1.0.49. A imagem fica no SSD interno e a E/S passa pelo cache de páginas do sistema, então a Figura 3 mede a sobrecarga da camada de montagem mais o motor, não o disco. Os resultados em discos reais estão separados na Tabela 1.

OpenMacFUSEFUSE-T 1.0.49Tempo; menor é melhor
Primeira listagem de um diretório com 40.000 entradas (padrão na época)6,4×
1,36 s
8,69 s
stat + MD5 de cada arquivo do volume35×
22,8 s
796,9 s
Apagar 10.000 arquivos de 4 KB6–9×
1,86–2,26 s
11,2–20,7 s
Criar e apagar arquivos pequenos, 200.000 operações6,5×
205–218 s
1.365 s
Figura 3 Cargas com muitos metadados em uma imagem de volume, Apple M2 / macOS 27. O resultado da primeira listagem foi medido antes de a filtragem de AppleDouble ser ativada; com o padrão atual, é de 3,6 s, pelo motivo explicado na seção 5.
Captura de tela do Terminal: o OpenMacFUSE monta a imagem, lista um diretório com 40.000 arquivos e mostra a memória do driverOpenMacFUSE
Captura de tela do Terminal: o FUSE-T monta a mesma imagem, lista um diretório com 40.000 arquivos e mostra a memória do driverFUSE-T 1.0.49
Captura de tela A A mesma imagem de volume montada por cada camada, em sequência, em um Intel i7 / macOS 12.7.6 (capturas de tela, com os comandos visíveis). A primeira listagem de um diretório com 40.000 entradas leva 4,13 s contra 7,87 s. A segunda listagem, logo em seguida, é atendida pelo cache de diretórios do sistema e leva 0,53 s nos dois casos. A memória após a montagem é de 44 MB contra 210 MB; o valor do FUSE-T soma o processo do driver e o processo do servidor NFS.
Tabela 1 · Discos USB reaisOpenMacFUSEFUSE-T
SSD, gravação sequencial de 4,5 GB293–313 MB/s300 MB/s
SSD, leitura a frio245–251 MB/s236–241 MB/s
SSD, percurso da árvore de diretórios0,25–0,30 s4,1–4,6 s
SSD, apagar 2.000 arquivos pequenos0,82–0,86 s8,4–9,7 s
Disco rígido, gravação / leitura sequencial70 / 97 MB/s74 / 93 MB/s

SSD medido em um Apple M2 / macOS 27; disco rígido em um Intel i7 / macOS 12.7. A velocidade sequencial é limitada pela conexão USB e pelo próprio disco; as diferenças estão dentro da margem de erro das medições.

Um resultado omitido: criação de arquivos pequenos. Depois desses testes, a política padrão de flush do OpenMacFUSE foi tornada mais conservadora (seção 6), o que deixou a criação de arquivos pequenos cerca de duas vezes mais lenta. A comparação em discos reais com o FUSE-T não foi repetida com a nova política, e não citaremos os números antigos até que seja.

4Memória

O OpenMacFUSE se mantém em 45–51 MB de memória física, independentemente da carga ou do tempo de atividade; o FUSE-T usou de 200 MB a 1 GB nos mesmos testes. Todos os valores são a pegada de memória física, a mesma medida da coluna Memória no Monitor de Atividade. No OpenMacFUSE, é o único processo do driver; no FUSE-T, é o processo do driver mais o processo do servidor NFS. Ambos incluem cerca de 35 MB de cache de blocos que pertencem ao motor NTFS.

OpenMacFUSEFUSE-T 1.0.49Pico de memória; menor é melhor
Leitura sequencial, 300 MB
46 MB
381 MB
Gravação sequencial, 4 GB
47,5 MB
275,6 MB
Criar e apagar arquivos pequenos, 200.000 operações
47,5 MB
999,6 MB
Figura 4 Pico de memória, Apple M2 / macOS 27, amostrado a cada 0,2 s; as três cargas usam a mesma escala. Sessenta segundos depois do fim da terceira carga, o FUSE-T ainda estava em 764 MB e o OpenMacFUSE em 46,4 MB.
0 20 40 60 MB 0123456 h Início: 45 MBApós 6 h: 51 MB
Figura 5 Execução de seis horas. Uma carga mista de leituras, gravações, criações e exclusões durante seis horas em um Intel i7 / macOS 12.7, com amostragem a cada minuto (o gráfico mostra um ponto a cada 20 minutos). Um ajuste linear dá +0,27 MB por hora. No fim, todos os arquivos passaram na verificação e o número de descritores de arquivo abertos não mudou.

5Comportamento no macOS

O OpenMacFUSE mantém os arquivos ._ fora do disco e converte os atributos do NTFS nos equivalentes do macOS.

Captura de tela do Finder: um volume NTFS montado pelo OpenMacFUSE, sem arquivos ._ na lista
Captura de tela B Um volume NTFS montado pelo OpenMacFUSE como aparece no Finder (macOS 12.7.6, captura de tela). O volume permite gravação e a lista não contém arquivos ._.

AppleDouble

Por padrão, o cliente NFS do macOS não usa atributos nomeados. Ele empacota os atributos estendidos, a resource fork e as informações do Finder de um arquivo em um arquivo AppleDouble chamado ._nome-do-arquivo e o envia ao servidor com operações OPEN e WRITE comuns. Se o servidor simplesmente guarda o que recebe, esses arquivos vão parar no disco, onde aparecem como arquivos soltos no Windows.

Isso ficou mais evidente com o macOS 26: o sistema anexa um atributo com.apple.provenance a cada arquivo novo, então cada arquivo ganha um arquivo ._ correspondente. Gravar um conjunto de 40.000 arquivos pequenos pelo FUSE-T deixou 40.048 arquivos ._ a mais no disco. Um repositório git no volume mostrou 48 arquivos não rastreados, e o git fsck relatou 67 erros.

O OpenMacFUSE detecta no servidor o acesso a arquivos ._, interpreta o conteúdo AppleDouble e grava cada atributo em um fluxo de dados alternativo (alternate data stream) do NTFS no arquivo principal. Na leitura, ele reconstrói o arquivo AppleDouble sob demanda. Nenhum arquivo separado é criado no disco e nenhum aparece nas listagens de diretório. Em um disco que já contém arquivos ._, eles ficam ocultos e cada um é movido para o fluxo de dados na próxima vez que o arquivo principal for modificado.

Duas gravações do cliente photo.jpg._photo.jpg Gravado como enviado photo.jpg ._photo.jpg visível noWindows OpenMacFUSE photo.jpgfluxo de dados principal photo.jpg:<alternate stream>xattrs, info do Finder, resource fork um arquivono disco
Figura 6 Dois resultados para o mesmo salvamento. Os fluxos de dados alternativos são nativos do NTFS; o Explorador de Arquivos do Windows não os mostra, e eles acompanham o arquivo principal quando ele é copiado.

O custo é a filtragem durante a listagem do diretório: a primeira listagem de um diretório com 40.000 entradas passa de 1,4 s para 3,6 s. Consideramos a troca justa.

Outros comportamentos

RecursoComportamento do OpenMacFUSEObservado com o FUSE-T
Maiúsculas e minúsculas nos nomesNão diferencia maiúsculas de minúsculas, mas preserva a grafia, como no Windows. Se o volume já tem nomes que diferem apenas em maiúsculas e minúsculas, a montagem passa automaticamente a diferenciá-lasDiferencia maiúsculas de minúsculas
Normalização UnicodeAs formas NFC e NFD de um nome chegam ao mesmo arquivo (letras acentuadas, coreano)Não testado
Atributo ocultoO bit HIDDEN do NTFS e o sinalizador de oculto do Finder são convertidos nos dois sentidosNão convertido
Atributo somente leituraO bit READONLY do NTFS impede a gravação do arquivo no macOSNão refletido
Data de criaçãostat -f %B retorna a data de criação gravada no discoSempre 0
Bloqueios de intervalo de bytesCompatível; bancos de dados SQLite podem ser abertos direto no volumeNão testado

6Tratamento de falhas

Discos externos são desconectados sem aviso. Isso é uso normal, não um caso raro, e o OpenMacFUSE tem três mecanismos que removem a montagem quando acontece. Uma camada de montagem baseada em NFS traz um risco inerente: a montagem é hard, então, quando o servidor para de responder, qualquer processo que acessa o volume entra em uma espera ininterruptível e o Finder deixa de responder. A camada de montagem precisa garantir que algo sempre remova o ponto de montagem:

00,10,20,30,40,5 s Energia do USB cortada 0,19 sa gravação recebe erro 0,21 sponto de montagem removido 0,45 so driver encerra
Figura 7 Linha do tempo depois que um relé corta a energia de um SSD USB durante uma gravação (uma execução medida, correspondente ao log da Figura 8). Em cinco execuções, o intervalo é de 0,24–0,47 s. Com o volume ocioso, depende do intervalo de verificação e fica em cerca de 1,3 s.
Log de teste, traduzido · SSD USB de 120 GB · Intel i7 / macOS 12.7.6
== corte de energia: B-write1 (carga: gravação, após as mudanças, NTFSTOOL_DRIVER_FSYNC=bounded)
  - após o corte: erro na gravação em 0,19 s; ponto de montagem removido em 0,21 s;
    driver encerrado em 0,45 s; processos ininterruptíveis: 0
  [pass] do corte de energia à recuperação completa: 0,45 s (limite: 10 s)
  - 303 arquivos com fsync; do último retorno de fsync à detecção da perda do dispositivo: 0,081 s
  [pass] monta após o corte sem ntfsfix (0,33 s)
Figura 8 Trecho do log da mesma execução. "Processos ininterruptíveis: 0" significa que nenhum processo ficou preso em uma espera que sinais não conseguem interromper.

Consistência após queda de energia

Depois de um corte de energia durante uma gravação, o volume agora monta sem ferramenta de reparo em todas as execuções de teste, e nenhum arquivo volta com conteúdo errado. A camada de montagem influencia duas coisas: se o volume monta sem ferramenta de reparo quando a energia volta e quantas das gravações já confirmadas ao aplicativo sobrevivem. O OpenMacFUSE faz três mudanças aqui:

SSD USB, corte de energia durante uma gravaçãoAntes das mudançasDepois (política padrão)
Monta sem ferramenta de reparo quando a energia volta3 de 5 execuções falharam por divergência em $MFTMirrTodas as execuções
Arquivos confirmados perdidos por execução12–191–27, todos gravados aproximadamente no último segundo
Arquivos com conteúdo erradoAlguns arquivos voltaram só com zeros0

"Antes das mudanças" é o comportamento do motor antes deste trabalho; o mesmo motor montado pelo FUSE-T deu os mesmos resultados. Nenhum sistema de arquivos consegue garantir os dados do último instante quando um disco portátil sem bateria perde energia no meio de uma gravação. O objetivo aqui é limitar a perda às gravações mais recentes e manter a estrutura do volume intacta.

7Metodologia

ItemDetalhes
HardwareMacBook Pro (Intel i7-4770HQ, 16 GB, macOS 12.7.6); Mac (Apple M2, 24 GB, macOS 27.0.1); SSD USB de 120 GB, disco rígido USB de 1 TB, pen drive USB
ComparaçãoMesma máquina, mesma imagem, mesmo código-fonte do motor NTFS; só a camada de montagem muda. FUSE-T versão 1.0.49
Medição de tempoOs tempos de gravação incluem o sync; as leituras sequenciais rodam depois de desmontar e montar de novo, para evitar o cache do cliente
Memóriari_phys_footprint de proc_pid_rusage, em intervalos de 0,2 s
Desconexão e queda de energiaUm relé corta a alimentação USB de 5 V sem desmontar antes. Quando a energia volta, a estrutura do volume é verificada em modo somente leitura; depois o volume é montado sem reparo e todos os arquivos são comparados
Correção300 s de comparação aleatória de leitura e gravação (692.000 operações, 0 divergências); 8 gravadores simultâneos mais 2 listagens recursivas; estrutura do volume verificada após cada execução
Regressão15 suítes de scripts com 869 verificações, cobrindo leitura e gravação em NTFS, comportamento no macOS, volumes ext, exFAT e BitLocker, além de injeção de falhas: desconexão, encerramento forçado, travamento e timeout do handshake de montagem
Log de teste, traduzido · Apple M2 / macOS 27.0.1 · uma execução de leitura e gravação (trecho)
07:29:09   [pass] montado
07:29:10   [pass] arquivo grande gravado
07:29:12   [pass] arquivos pequenos gravados
07:29:13   [pass] MD5 do arquivo grande confere
07:29:13   [pass] MD5 de todos os arquivos pequenos conferem
07:29:13   [pass] renomear / acrescentar / truncar / apagar
07:29:13   [pass] abertura sem diferenciar maiúsculas de minúsculas
07:29:13   [pass] nenhum arquivo ._ na listagem
07:29:13   [pass] leitura e gravação de atributos estendidos
07:29:15   [pass] desmontagem normal
07:29:15   [pass] driver encerrado
07:29:15   [pass] processo guardião encerrado
Figura 9 Uma execução só é considerada concluída quando, depois da desmontagem, o driver e o processo guardião encerraram e a verificação da estrutura do volume não aponta erros.

8Limitações

9Conclusão

O OpenMacFUSE é a camada de montagem padrão do Driver 1 no NTFSTool Pro; volumes NTFS, ext, exFAT e BitLocker são todos montados por ele. Manter a camada de montagem no nosso próprio código-fonte traz quatro vantagens:

Perguntas frequentes

O que é o OpenMacFUSE?
OpenMacFUSE é a camada de montagem de código aberto, executada no espaço do usuário, desenvolvida pela NTFSTool e integrada ao NTFSTool Pro. Ela monta volumes NTFS, ext, exFAT e BitLocker no macOS. É um servidor NFSv4.0 que roda dentro do processo do driver e não usa extensão de kernel.
Preciso instalar o macFUSE ou o FUSE-T para usar o NTFSTool Pro?
Não. O OpenMacFUSE, a camada de montagem própria da NTFSTool, já vem dentro do NTFSTool Pro. Ele não depende do macFUSE, do FUSE-T nem de qualquer extensão de kernel, e você nunca precisa iniciar o Mac no modo de recuperação do macOS e reduzir a segurança.
Como o OpenMacFUSE se compara ao FUSE-T em desempenho?
No mesmo Mac e com o mesmo motor NTFS, calcular a soma de verificação de todos os arquivos de um volume leva 23 s com o OpenMacFUSE contra 797 s com o FUSE-T, e apagar 10.000 arquivos pequenos é de 6 a 9 vezes mais rápido. Leituras e gravações sequenciais de arquivos grandes em discos USB reais são equivalentes. O uso de memória do OpenMacFUSE fica em 45 a 51 MB, contra 200 MB a 1 GB do FUSE-T.
O que acontece se eu desconectar um disco no meio de uma gravação?
O driver do OpenMacFUSE desmonta o volume e encerra sozinho em cerca de 0,5 s, então o Finder e outros apps não travam. O volume monta normalmente quando o disco é reconectado. Gravações concluídas aproximadamente no último segundo antes da queda de energia podem não estar lá; o conteúdo dos demais arquivos não é afetado.
Por que a NTFSTool criou a própria camada de montagem em vez de usar um componente de código aberto ou de terceiros?
A camada de montagem determina a velocidade, o uso de memória e o que acontece quando algo falha. Com uma implementação própria, a NTFSTool consegue rastrear e corrigir problemas em um único código-fonte, e o comportamento específico do NTFS (diferenciação de maiúsculas e minúsculas, atributos de oculto e somente leitura, atributos estendidos) é tratado junto com o motor do sistema de arquivos.
O OpenMacFUSE é de código aberto?
Sim. O OpenMacFUSE é de código aberto sob a licença MIT, e o código está no GitHub em ntfstool/openmacfuse. Qualquer sistema de arquivos FUSE 2.x pode ser vinculado a ele.

Todos os dados deste artigo foram medidos pela equipe de engenharia da NTFSTool; a metodologia está na seção 7. O FUSE-T é um projeto do seu autor e não tem vínculo com a NTFSTool. O OpenMacFUSE é um projeto independente e não tem vínculo com o macFUSE nem com seus autores.

Precisa de ajuda? Envie um e-mail para service@ntfstool.com — uma pessoa de verdade responde em até 48 horas.
Central de ajuda