NOTE DI INGEGNERIA

OpenMacFUSE: FUSE open source per NTFS su Mac, senza estensione del kernel

OpenMacFUSE è un livello FUSE open source in user space per macOS, sviluppato da NTFSTool, che monta volumi NTFS, ext, exFAT e BitLocker tramite il client NFS integrato in macOS invece di un'estensione del kernel. È rilasciato con licenza MIT, è il livello di montaggio predefinito di NTFSTool Pro e non richiede né macFUSE né FUSE-T. Questo articolo ne spiega la struttura e lo confronta con FUSE-T sullo stesso Mac, con lo stesso motore NTFS.

Team di ingegneria di NTFSTool · novembre 2026 · Versioni testate: OpenMacFUSE c392a69, FUSE-T 1.0.49 · Codice sorgente su GitHub

IN SINTESI

  • Sviluppo interno. OpenMacFUSE è un server NFSv4.0 collegato al processo del driver che espone l'API FUSE 2.x. Conta circa 17.000 righe di C, è implementato a partire dalle RFC 7530, 5531 e 4506 ed è rilasciato con licenza MIT. È uno dei pochi livelli FUSE open source per macOS che non richiedono alcuna estensione del kernel.
  • Velocità. Il divario è maggiore nei carichi ricchi di metadati: calcolare il checksum di ogni file di un volume richiede 23 s contro 797 s con FUSE-T, mentre l'eliminazione di 10.000 file piccoli è da 6 a 9 volte più rapida. Nella lettura e scrittura sequenziale di file grandi su dischi USB reali non emerge alcuna differenza misurabile.
  • Memoria. Il processo del driver usa da 45 a 51 MB di memoria fisica, a prescindere dal numero di file e dal tempo di attività.
  • Affidabilità. Se durante una scrittura viene tolta l'alimentazione USB, il driver smonta il volume ed esce entro 0,5 s. Al ripristino dell'alimentazione il volume si monta normalmente e nessun file ha un contenuto danneggiato; si perdono soltanto le scritture completate nell'ultimo secondo circa.
  • Manutenibilità. Il livello di protocollo, l'interfaccia FUSE e il motore NTFS stanno nello stesso codebase: un problema del livello di montaggio si traccia e si corregge direttamente, senza attendere il calendario di rilascio di terzi.
35×Checksum di ogni file di un volume
23 s contro 797 s
46 MBPicco di memoria in lettura di 300 MB
381 MB con FUSE-T
0,45 sDall'interruzione dell'alimentazione durante la scrittura all'uscita del driver
misurato su un SSD USB
869verifiche automatiche
tutte superate su macOS 12

1 Contesto2 Architettura3 Prestazioni4 Memoria5 Comportamento su macOS6 Gestione dei guasti7 Metodologia8 Limiti9 ConclusioniFAQ

1Contesto

Da macOS 11, per caricare un'estensione del kernel bisogna avviare il Mac da Recupero di macOS e impostare la «Sicurezza ridotta». Per un software destinato agli utenti di tutti i giorni, questa strada non è più praticabile. Per restare fuori dal kernel ci sono due vie principali: FSKit di Apple (disponibile da macOS 15.4 e usato dal «Driver 2» di NTFSTool) e il client NFS integrato in macOS. La seconda avvia un server NFS sul Mac stesso, traduce le operazioni sul file system in chiamate a un driver in user space e monta il risultato con mount_nfs. FUSE-T segue questa strada ed è l'implementazione più matura; in questo articolo è il termine di paragone per ogni confronto.

Abbiamo scelto di realizzare questo livello internamente per tre ragioni tecniche:

2Architettura

OpenMacFUSE è collegato al driver come libreria statica. All'avvio, il driver si mette in ascolto su un endpoint locale all'interno del proprio processo e poi chiama mount_nfs di macOS. Ogni richiesta COMPOUND del client NFS del kernel viene decodificata, inoltrata alle callback FUSE e risolta nello stesso processo. Non c'è un secondo processo, né copie aggiuntive o cambi di contesto lungo il percorso.

FUSE-T App / Finderchiamate di sistema Client NFS del kernelparte di macOS Processo server NFSprocesso separato Processo del driverlibfuse-t + motore NTFS Disco TCPIPC Due processi in user space; ogni richiesta attraversa due confini di processo OpenMacFUSE App / Finderchiamate di sistema Client NFS del kernelparte di macOS Processo del driver (un solo processo) OpenMacFUSEServer NFSv4.0 FUSE 2.xchiamate di funzione Motore NTFS Disco socket Processo di guardia (0,3 MB)rimuove il montaggio se il driver termina
Figura 1 Percorso di una richiesta. Il lato FUSE-T è disegnato in base al suo progetto pubblicato (un processo driver più un processo server NFS separato). OpenMacFUSE porta il server dentro il processo del driver, quindi il livello di protocollo raggiunge il motore del file system con normali chiamate di funzione.

Trasporto e opzioni di montaggio

Da macOS 26 in poi si usa un socket di dominio Unix (proto=ticotsord): non si apre alcuna porta e gli altri utenti del Mac non possono connettersi. Il client del kernel di macOS 12 non gestisce le scritture di grandi dimensioni su quel trasporto, perciò le versioni precedenti di macOS ripiegano su TCP su 127.0.0.1, con due controlli lato server che verificano che la connessione provenga dal montaggio locale. Queste sono le opzioni riportate dal sistema dopo un montaggio su macOS 27:

Registro di test · macOS 27.0.1 / arm64 · percorsi abbreviati
$ nfsstat -m <punto di montaggio>
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 Opzioni di montaggio. nonamedattr è il valore predefinito del client di sistema e determina come vengono gestiti gli attributi estesi nella sezione 5. nordirplus è una nostra scelta; il suo costo è descritto nella sezione 8.

Scelte di implementazione

3Prestazioni

OpenMacFUSE è da 6 a 35 volte più veloce di FUSE-T 1.0.49 nei carichi ricchi di metadati e alla pari nella lettura e scrittura sequenziale su dischi USB reali. Metodo: stesso Mac, stessa immagine del volume e stesso codice sorgente del motore NTFS, collegato una volta a OpenMacFUSE e una volta a FUSE-T 1.0.49. L'immagine si trova sull'SSD interno e l'I/O passa dalla cache di pagina del sistema, quindi la Figura 3 misura il carico aggiuntivo del livello di montaggio e del motore, non il disco. I risultati su dischi reali sono riportati a parte nella Tabella 1.

OpenMacFUSEFUSE-T 1.0.49Tempo; più basso è meglio
Primo elenco di una cartella con 40.000 voci (impostazione predefinita di allora)6,4×
1,36 s
8,69 s
stat + MD5 di ogni file del volume35×
22,8 s
796,9 s
Eliminazione di 10.000 file da 4 KB6–9×
1,86–2,26 s
11,2–20,7 s
Creazione ed eliminazione di file piccoli, 200.000 operazioni6,5×
205–218 s
1.365 s
Figura 3 Carichi ricchi di metadati su un'immagine di volume, Apple M2 / macOS 27. Il risultato del primo elenco è stato misurato prima di attivare il filtro AppleDouble; con l'impostazione attuale è di 3,6 s, per il motivo spiegato nella sezione 5.
Schermata del Terminale: OpenMacFUSE monta l'immagine, elenca una cartella con 40.000 file e mostra la memoria del driverOpenMacFUSE
Schermata del Terminale: FUSE-T monta la stessa immagine, elenca una cartella con 40.000 file e mostra la memoria del driverFUSE-T 1.0.49
Schermata A La stessa immagine di volume montata a turno con ciascun livello su Intel i7 / macOS 12.7.6 (schermate, con i comandi ben visibili). Il primo elenco di una cartella con 40.000 voci richiede 4,13 s contro 7,87 s. Il secondo elenco, subito dopo, viene servito dalla cache delle cartelle del sistema e richiede 0,53 s con entrambi. La memoria dopo il montaggio è di 44 MB contro 210 MB; il valore di FUSE-T comprende il processo del driver più il suo processo server NFS.
Tabella 1 · Dischi USB realiOpenMacFUSEFUSE-T
SSD, scrittura sequenziale di 4,5 GB293–313 MB/s300 MB/s
SSD, lettura a freddo245–251 MB/s236–241 MB/s
SSD, scansione dell'albero di cartelle0,25–0,30 s4,1–4,6 s
SSD, eliminazione di 2.000 file piccoli0,82–0,86 s8,4–9,7 s
Hard disk, scrittura / lettura sequenziale70 / 97 MB/s74 / 93 MB/s

SSD misurato su Apple M2 / macOS 27; hard disk su Intel i7 / macOS 12.7. La velocità sequenziale è limitata dal collegamento USB e dal disco stesso; le differenze rientrano nella variabilità di misura.

Un risultato escluso: la creazione di file piccoli. Dopo questi benchmark, la politica di flush predefinita di OpenMacFUSE è stata resa più prudente (sezione 6) e la creazione di file piccoli è diventata circa due volte più lenta. Il confronto su dischi reali con FUSE-T non è stato ripetuto con la nuova politica e non citeremo i vecchi valori finché non lo sarà.

4Memoria

OpenMacFUSE resta tra 45 e 51 MB di memoria fisica a prescindere dal carico e dal tempo di attività; FUSE-T ha usato da 200 MB a 1 GB negli stessi test. Tutti i valori sono l'impronta fisica, la stessa misura della colonna Memoria in Monitoraggio Attività. Per OpenMacFUSE è l'unico processo del driver; per FUSE-T è il processo del driver più il suo processo server NFS. Entrambi includono circa 35 MB di cache di blocchi che appartengono al motore NTFS.

OpenMacFUSEFUSE-T 1.0.49Picco di memoria; più basso è meglio
Lettura sequenziale, 300 MB
46 MB
381 MB
Scrittura sequenziale, 4 GB
47,5 MB
275,6 MB
Creazione ed eliminazione di file piccoli, 200.000 operazioni
47,5 MB
999,6 MB
Figura 4 Picco di memoria, Apple M2 / macOS 27, campionata ogni 0,2 s; i tre carichi condividono la stessa scala. Sessanta secondi dopo la fine del terzo carico, FUSE-T era ancora a 764 MB e OpenMacFUSE a 46,4 MB.
0 20 40 60 MB 0123456 h Inizio: 45 MBDopo 6 h: 51 MB
Figura 5 Prova di sei ore. Un carico misto di letture, scritture, creazioni ed eliminazioni per sei ore su Intel i7 / macOS 12.7, campionato una volta al minuto (nel grafico un punto ogni 20 minuti). Un'interpolazione lineare dà +0,27 MB all'ora. Al termine, tutti i file hanno superato la verifica e il numero di descrittori di file aperti era invariato.

5Comportamento su macOS

OpenMacFUSE tiene i file ._ fuori dal disco e associa gli attributi NTFS ai loro equivalenti di macOS.

Schermata del Finder: un volume NTFS montato con OpenMacFUSE, senza file ._ nell'elenco
Schermata B Un volume NTFS montato con OpenMacFUSE come appare nel Finder (macOS 12.7.6, schermata). Il volume è scrivibile e l'elenco non contiene file ._.

AppleDouble

Per impostazione predefinita il client NFS di macOS non usa gli attributi con nome. Raccoglie gli attributi estesi, la resource fork e le informazioni del Finder di un file in un file AppleDouble chiamato ._nomefile e lo invia al server con normali operazioni OPEN e WRITE. Se il server si limita a salvare quello che riceve, quei file finiscono sul disco, dove in Windows risultano file superflui.

Con macOS 26 la cosa è diventata più evidente: il sistema aggiunge un attributo com.apple.provenance a ogni nuovo file, quindi ogni file è accompagnato da un file ._. Scrivendo con FUSE-T un insieme di 40.000 file piccoli, sul disco sono rimasti 40.048 file ._ in più. Un repository git sul volume mostrava 48 file non tracciati e git fsck segnalava 67 errori.

OpenMacFUSE rileva sul server l'accesso ai file ._, analizza il contenuto AppleDouble e scrive ogni attributo in un flusso di dati alternativo NTFS del file principale. In lettura ricostruisce il file AppleDouble al momento. Sul disco non viene creato alcun file separato e negli elenchi delle cartelle non ne compare nessuno. Su un disco che contiene già file ._, questi vengono nascosti e ognuno è spostato nel flusso di dati alla successiva modifica del suo file principale.

Due scritture dal client photo.jpg._photo.jpg Salvato così com'è photo.jpg ._photo.jpg visibile inWindows OpenMacFUSE photo.jpgflusso dati principale photo.jpg:<flusso alternativo>xattr, info del Finder, resource fork un filesu disco
Figura 6 Due esiti dello stesso salvataggio. I flussi di dati alternativi sono nativi di NTFS; Esplora file di Windows non li mostra e, quando il file principale viene copiato, lo seguono.

Il costo è il filtraggio durante l'elenco delle cartelle: il primo elenco di una cartella con 40.000 voci passa da 1,4 s a 3,6 s. Per noi è un compromesso accettabile.

Altri comportamenti

FunzioneComportamento di OpenMacFUSEOsservato con FUSE-T
Maiuscole e minuscole nei nomiPer impostazione predefinita non distingue maiuscole e minuscole ma le conserva, come in Windows. Se il volume contiene già nomi che differiscono solo per maiuscole e minuscole, il montaggio passa automaticamente a distinguere maiuscole e minuscoleDistingue maiuscole e minuscole
Normalizzazione UnicodeLe forme NFC e NFD di un nome portano allo stesso file (lettere accentate, coreano)Non testato
Attributo nascostoIl bit NTFS HIDDEN e il flag «nascosto» del Finder si associano in entrambe le direzioniNon associato
Attributo di sola letturaIl bit NTFS READONLY rende il file non scrivibile su macOSNon riflesso
Data di creazionestat -f %B restituisce la data di creazione salvata sul discoSempre 0
Lock di intervalli di byteSupportati; i database SQLite si possono aprire direttamente sul volumeNon testato

6Gestione dei guasti

I dischi esterni vengono scollegati senza preavviso. È un uso normale, non un caso limite, e OpenMacFUSE ha tre meccanismi che rimuovono il montaggio quando succede. Un livello di montaggio basato su NFS comporta un rischio intrinseco: il montaggio è hard, quindi quando il server smette di rispondere, ogni processo che tocca il volume entra in un'attesa non interrompibile e il Finder smette di rispondere. Il livello di montaggio deve garantire che qualcosa rimuova sempre il punto di montaggio:

00,10,20,30,40,5 s Alimentazione USB interrotta 0,19 sil processo in scrittura riceve un errore 0,21 spunto di montaggio rimosso 0,45 sil driver esce
Figura 7 Sequenza temporale dopo che un relè toglie l'alimentazione a un SSD USB durante una scrittura (una prova misurata, corrispondente al registro della Figura 8). Su cinque prove l'intervallo va da 0,24 a 0,47 s. A volume inattivo dipende dall'intervallo di verifica ed è di circa 1,3 s.
Registro di test, tradotto · SSD USB da 120 GB · Intel i7 / macOS 12.7.6
== taglio di corrente: B-write1 (carico: scrittura, dopo le modifiche, NTFSTOOL_DRIVER_FSYNC=bounded)
  - dopo il taglio: errore di scrittura a 0,19 s; punto di montaggio rimosso a 0,21 s;
    uscita del driver a 0,45 s; processi non interrompibili: 0
  [pass] dal taglio di corrente al ripristino completo 0,45 s (limite 10 s)
  - 303 file con fsync; dall'ultimo ritorno di fsync al rilevamento della perdita del dispositivo 0,081 s
  [pass] si monta dopo il taglio senza ntfsfix (0,33 s)
Figura 8 Estratto dal registro della stessa prova. «Processi non interrompibili: 0» significa che nessun processo è rimasto bloccato in un'attesa che i segnali non possono interrompere.

Coerenza dopo un'interruzione dell'alimentazione

Dopo un'interruzione dell'alimentazione durante una scrittura, il volume ora si monta senza strumenti di riparazione in ogni prova e nessun file torna con un contenuto sbagliato. Il livello di montaggio può influire su due cose: se il volume si monta senza strumenti di riparazione al ritorno dell'alimentazione e quante delle scritture già confermate all'applicazione sopravvivono. OpenMacFUSE introduce qui tre modifiche:

SSD USB, interruzione dell'alimentazione durante una scritturaPrima delle modificheDopo (politica predefinita)
Si monta senza strumenti di riparazione al ritorno dell'alimentazione3 prove su 5 non riuscite per una discordanza di $MFTMirrOgni prova
File confermati persi per prova12–191–27, tutti scritti nell'ultimo secondo circa
File con contenuto sbagliatoAlcuni file sono tornati con tutti zeri0

«Prima delle modifiche» indica il comportamento del motore prima di questo lavoro; lo stesso motore montato con FUSE-T ha dato gli stessi risultati. Nessun file system può garantire i dati dell'ultimo istante quando un disco portatile senza batteria perde l'alimentazione durante una scrittura. L'obiettivo qui è limitare la perdita alle scritture più recenti e lasciare intatta la struttura del volume.

7Metodologia

VoceDettagli
HardwareMacBook Pro (Intel i7-4770HQ, 16 GB, macOS 12.7.6); Mac (Apple M2, 24 GB, macOS 27.0.1); SSD USB da 120 GB, hard disk USB da 1 TB, chiavetta USB
ConfrontoStesso Mac, stessa immagine, stesso codice sorgente del motore NTFS; cambia solo il livello di montaggio. FUSE-T versione 1.0.49
Misura dei tempiI tempi di scrittura includono sync; le letture sequenziali vengono eseguite dopo uno smontaggio e un nuovo montaggio, per evitare la cache del client
Memoriari_phys_footprint da proc_pid_rusage, a intervalli di 0,2 s
Scollegamento e interruzione dell'alimentazioneUn relè interrompe l'alimentazione USB a 5 V senza smontare prima. Al ritorno dell'alimentazione, la struttura del volume viene controllata in sola lettura, poi il volume viene montato senza riparazione e ogni file viene confrontato
Correttezza300 s di confronto casuale tra letture e scritture (692.000 operazioni, 0 discrepanze); 8 processi di scrittura simultanei più 2 elenchi ricorsivi; struttura del volume controllata dopo ogni prova
Regressione15 suite di script con 869 verifiche che coprono lettura e scrittura NTFS, comportamento su macOS, volumi ext, exFAT e BitLocker, più l'iniezione di guasti: scollegamento, terminazione forzata, blocco e timeout dell'handshake di montaggio
Registro di test, tradotto · Apple M2 / macOS 27.0.1 · una prova di lettura e scrittura (estratto)
07:29:09   [pass] montato
07:29:10   [pass] file grande scritto
07:29:12   [pass] file piccoli scritti
07:29:13   [pass] MD5 del file grande corretto
07:29:13   [pass] MD5 di tutti i file piccoli corretti
07:29:13   [pass] rinomina / aggiunta / troncamento / eliminazione
07:29:13   [pass] apertura senza distinzione tra maiuscole e minuscole
07:29:13   [pass] nessun file ._ nell'elenco
07:29:13   [pass] lettura e scrittura degli attributi estesi
07:29:15   [pass] smontaggio normale
07:29:15   [pass] driver terminato
07:29:15   [pass] processo di guardia terminato
Figura 9 Una prova si considera completata solo quando, dopo lo smontaggio, sia il driver sia il processo di guardia sono terminati e il controllo della struttura del volume non segnala errori.

8Limiti

9Conclusioni

OpenMacFUSE è il livello di montaggio predefinito del Driver 1 in NTFSTool Pro; vi vengono montati tutti i volumi NTFS, ext, exFAT e BitLocker. Tenere il livello di montaggio nel nostro codebase dà quattro vantaggi:

FAQ

Che cos'è OpenMacFUSE?
OpenMacFUSE è il livello di montaggio open source in user space sviluppato da NTFSTool e integrato in NTFSTool Pro. Monta volumi NTFS, ext, exFAT e BitLocker su macOS. È un server NFSv4.0 che viene eseguito all'interno del processo del driver e non usa alcuna estensione del kernel.
Devo installare macFUSE o FUSE-T per usare NTFSTool Pro?
No. OpenMacFUSE, il livello di montaggio di NTFSTool, è incluso in NTFSTool Pro. Non dipende da macFUSE, da FUSE-T né da alcuna estensione del kernel e non devi mai avviare il Mac da Recupero di macOS per ridurre le impostazioni di sicurezza.
Come si confronta OpenMacFUSE con FUSE-T in termini di prestazioni?
Sullo stesso Mac e con lo stesso motore NTFS, calcolare il checksum di ogni file di un volume richiede 23 s con OpenMacFUSE contro 797 s con FUSE-T, e l'eliminazione di 10.000 file piccoli è da 6 a 9 volte più rapida. La lettura e la scrittura sequenziale di file grandi su dischi USB reali sono alla pari. L'uso di memoria di OpenMacFUSE resta tra 45 e 51 MB, contro i 200 MB–1 GB di FUSE-T.
Che cosa succede se scollego un disco durante una scrittura?
Il driver di OpenMacFUSE smonta il volume ed esce da solo in circa 0,5 s, quindi il Finder e le altre app non si bloccano. Il volume si monta normalmente quando ricolleghi il disco. Le scritture completate nell'ultimo secondo circa prima della interruzione dell'alimentazione potrebbero mancare; il contenuto degli altri file non viene toccato.
Perché NTFSTool ha scritto un proprio livello di montaggio invece di usare un componente open source o di terzi?
Il livello di montaggio determina velocità, uso di memoria e che cosa succede in caso di guasto. Con un'implementazione propria, NTFSTool può tracciare e correggere i problemi in un unico codebase e gestire insieme al motore del file system i comportamenti specifici di NTFS (distinzione tra maiuscole e minuscole, attributi nascosto e sola lettura, attributi estesi).
OpenMacFUSE è open source?
Sì. OpenMacFUSE è open source con licenza MIT e il codice è su GitHub all'indirizzo ntfstool/openmacfuse. Qualsiasi file system FUSE 2.x può collegarsi a OpenMacFUSE.

Tutti i dati di questo articolo sono stati misurati dal team di ingegneria di NTFSTool; la metodologia è nella sezione 7. FUSE-T è un progetto indipendente del suo autore e non è affiliato a NTFSTool. OpenMacFUSE è un progetto indipendente e non è affiliato a macFUSE né ai suoi autori.

Serve aiuto? Scrivi a service@ntfstool.com: una persona reale risponde entro 48 ore.
Centro assistenza