TECHNISCHE NOTITIES

OpenMacFUSE: open-source FUSE voor NTFS op de Mac, zonder kernelextensie

OpenMacFUSE is een open-source FUSE-laag in userspace voor macOS, ontwikkeld door NTFSTool, waarmee NTFS-, ext-, exFAT- en BitLocker-volumes worden gekoppeld via de NFS-client die in macOS zit, in plaats van via een kernelextensie. De laag valt onder de MIT-licentie, is de standaard koppellaag in NTFSTool Pro en heeft geen macFUSE of FUSE-T nodig. Dit artikel legt uit hoe OpenMacFUSE is opgebouwd en vergelijkt het met FUSE-T op dezelfde Mac, met dezelfde NTFS-engine.

Technisch team van NTFSTool · november 2026 · Geteste versies: OpenMacFUSE c392a69, FUSE-T 1.0.49 · Broncode op GitHub

SAMENVATTING

  • Zelf ontwikkeld. OpenMacFUSE is een NFSv4.0-server die in het driverproces zit en de FUSE 2.x-API aanbiedt. De code bestaat uit ongeveer 17.000 regels C, is geschreven volgens RFC 7530, 5531 en 4506 en valt onder de MIT-licentie. Het is een van de weinige open-source FUSE-implementaties voor macOS die zonder kernelextensie werken.
  • Snelheid. Het verschil is het grootst bij taken met veel metadata: een checksum van elk bestand op een volume duurt 23 s tegenover 797 s met FUSE-T, en 10.000 kleine bestanden verwijderen gaat 6 tot 9 keer sneller. Bij het sequentieel lezen en schrijven van grote bestanden op echte USB-schijven is geen meetbaar verschil.
  • Geheugen. Het driverproces gebruikt 45–51 MB fysiek geheugen, ongeacht het aantal bestanden of hoe lang het draait.
  • Betrouwbaarheid. Als tijdens het schrijven de USB-voeding wegvalt, ontkoppelt de driver het volume en stopt hij binnen 0,5 s. Zodra de voeding terug is, wordt het volume gewoon gekoppeld en heeft geen enkel bestand een beschadigde inhoud; verloren gaan alleen schrijfacties uit ongeveer de laatste seconde.
  • Onderhoudbaarheid. De protocollaag, de FUSE-interface en de NTFS-engine zitten in één codebase. Een probleem in de koppellaag is dus direct te herleiden en te verhelpen, zonder te wachten op de releaseplanning van een externe partij.
35×Checksum van elk bestand op een volume
23 s versus 797 s
46 MBPiekgeheugen bij het lezen van 300 MB
381 MB met FUSE-T
0,45 sVan stroomuitval tijdens het schrijven tot het stoppen van de driver
gemeten op een USB-SSD
869geautomatiseerde controles
allemaal geslaagd op macOS 12

1 Achtergrond2 Architectuur3 Prestaties4 Geheugen5 macOS-gedrag6 Foutafhandeling7 Testmethode8 Beperkingen9 ConclusieFAQ

1Achtergrond

Sinds macOS 11 moet je voor het laden van een kernelextensie opstarten in macOS-herstel en de Mac op Verminderde beveiliging zetten. Voor software voor gewone gebruikers is die route niet meer werkbaar. Er zijn twee manieren om buiten de kernel te blijven: FSKit van Apple (beschikbaar vanaf macOS 15.4 en gebruikt voor "Driver 2" van NTFSTool) en de NFS-client die in macOS zit. Bij de tweede aanpak draait er een NFS-server op de Mac zelf, die bestandssysteembewerkingen omzet in aanroepen naar een driver in userspace en het resultaat koppelt met mount_nfs. FUSE-T werkt zo en is de meest volwassen implementatie ervan; het is de referentie voor elke vergelijking in dit artikel.

We hebben deze laag om drie technische redenen zelf gebouwd:

2Architectuur

OpenMacFUSE wordt als statische bibliotheek in de driver gelinkt. Zodra de driver start, luistert hij op een lokaal eindpunt binnen zijn eigen proces en roept daarna mount_nfs van het systeem aan. Elk COMPOUND-verzoek van de NFS-client in de kernel wordt gedecodeerd, doorgegeven aan de FUSE-callbacks en beantwoord binnen datzelfde proces. Er is geen tweede proces en onderweg wordt niets extra gekopieerd of van context gewisseld.

FUSE-T Apps / Findersysteemaanroepen NFS-client (kernel)onderdeel van macOS NFS-serverprocesapart proces Driverproceslibfuse-t + NTFS-engine Schijf TCPIPC Twee userspace-processen; elk verzoek passeert twee procesgrenzen OpenMacFUSE Apps / Findersysteemaanroepen NFS-client (kernel)onderdeel van macOS Driverproces (één proces) OpenMacFUSENFSv4.0-server FUSE 2.xfunctieaanroepen NTFS-engine Schijf socket Bewakingsproces (0,3 MB)ruimt de koppeling op als de driver crasht
Afbeelding 1 Het pad van een verzoek. De FUSE-T-kant is getekend volgens het gepubliceerde ontwerp (een driverproces plus een apart NFS-serverproces). OpenMacFUSE zet de server in het driverproces, zodat de protocollaag de engine van het bestandssysteem met gewone functieaanroepen bereikt.

Transport en koppelopties

macOS 26 en nieuwer gebruiken een Unix-domeinsocket (proto=ticotsord). Er wordt geen poort geopend en andere gebruikers op de Mac kunnen geen verbinding maken. De kernelclient in macOS 12 faalt bij grote schrijfacties over dat transport, dus oudere macOS-versies vallen terug op TCP op 127.0.0.1, met twee controles aan de serverkant dat de verbinding van de lokale koppeling komt. Dit zijn de opties die het systeem meldde na het koppelen op macOS 27:

Testlog · macOS 27.0.1 / arm64 · paden ingekort
$ 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
Afbeelding 2 Koppelopties. nonamedattr is de standaardwaarde van de systeemclient en bepaalt hoe uitgebreide attributen worden verwerkt (zie sectie 5). nordirplus is onze eigen keuze; de prijs daarvan staat in sectie 8.

Ontwerpkeuzes

3Prestaties

OpenMacFUSE is 6 tot 35 keer sneller dan FUSE-T 1.0.49 bij taken met veel metadata en even snel bij sequentieel lezen en schrijven op echte USB-schijven. Methode: dezelfde Mac, hetzelfde volume-image en dezelfde broncode van de NTFS-engine, één keer gelinkt met OpenMacFUSE en één keer met FUSE-T 1.0.49. Het image staat op de interne SSD en de I/O loopt via de paginacache van het systeem, dus Afbeelding 3 meet de overhead van de koppellaag plus de engine, niet van de schijf. Resultaten op echte schijven staan apart in Tabel 1.

OpenMacFUSEFUSE-T 1.0.49Tijd; lager is beter
Eerste weergave van een map met 40.000 items (toen de standaardinstelling)6,4×
1,36 s
8,69 s
stat + MD5 van elk bestand op het volume35×
22,8 s
796,9 s
10.000 bestanden van 4 KB verwijderen6–9×
1,86–2,26 s
11,2–20,7 s
Kleine bestanden maken en verwijderen, 200.000 bewerkingen6,5×
205–218 s
1.365 s
Afbeelding 3 Taken met veel metadata op een volume-image, Apple M2 / macOS 27. Het resultaat voor de eerste weergave is gemeten voordat AppleDouble-filtering was ingeschakeld; met de huidige standaardinstelling is het 3,6 s, om de reden die in sectie 5 staat.
Schermafbeelding van Terminal: OpenMacFUSE koppelt het image, toont een map met 40.000 bestanden en het geheugen van de driverOpenMacFUSE
Schermafbeelding van Terminal: FUSE-T koppelt hetzelfde image, toont een map met 40.000 bestanden en het geheugen van de driverFUSE-T 1.0.49
Schermafbeelding A Hetzelfde volume-image, om de beurt gekoppeld via elke laag, op Intel i7 / macOS 12.7.6 (schermafbeeldingen, met de commando's in beeld). De eerste weergave van een map met 40.000 items duurt 4,13 s tegenover 7,87 s. De tweede weergave, direct erna, komt uit de mapcache van het systeem en duurt bij beide 0,53 s. Het geheugen na het koppelen is 44 MB tegenover 210 MB; het cijfer voor FUSE-T is het driverproces plus het bijbehorende NFS-serverproces.
Tabel 1 · Echte USB-schijvenOpenMacFUSEFUSE-T
SSD, sequentieel schrijven 4,5 GB293–313 MB/s300 MB/s
SSD, koud lezen245–251 MB/s236–241 MB/s
SSD, mapstructuur doorlopen0,25–0,30 s4,1–4,6 s
SSD, 2.000 kleine bestanden verwijderen0,82–0,86 s8,4–9,7 s
Harde schijf, sequentieel schrijven / lezen70 / 97 MB/s74 / 93 MB/s

SSD gemeten op Apple M2 / macOS 27; harde schijf op Intel i7 / macOS 12.7. De sequentiële doorvoer wordt begrensd door de USB-verbinding en de schijf zelf; de verschillen vallen binnen de meetruis.

Eén resultaat weggelaten: kleine bestanden maken. Na deze benchmarks is de standaardstrategie voor flushen van OpenMacFUSE voorzichtiger gemaakt (sectie 6), waardoor het maken van kleine bestanden ongeveer twee keer zo traag werd. De vergelijking met FUSE-T op echte schijven is niet herhaald met de nieuwe strategie, en de oude cijfers noemen we pas weer als dat is gebeurd.

4Geheugen

OpenMacFUSE blijft op 45–51 MB fysiek geheugen, ongeacht de belasting of hoe lang het draait; FUSE-T gebruikte in dezelfde tests 200 MB tot 1 GB. Alle waarden zijn de fysieke footprint, dezelfde maat als de kolom Geheugen in Activiteitenweergave. Bij OpenMacFUSE is dat het ene driverproces; bij FUSE-T het driverproces plus het NFS-serverproces. Beide bevatten ongeveer 35 MB blokcache die bij de NTFS-engine hoort.

OpenMacFUSEFUSE-T 1.0.49Piekgeheugen; lager is beter
Sequentieel lezen, 300 MB
46 MB
381 MB
Sequentieel schrijven, 4 GB
47,5 MB
275,6 MB
Kleine bestanden maken en verwijderen, 200.000 bewerkingen
47,5 MB
999,6 MB
Afbeelding 4 Piekgeheugen, Apple M2 / macOS 27, elke 0,2 s gemeten; alle drie de taken delen één schaal. Zestig seconden nadat de derde taak klaar was, zat FUSE-T nog op 764 MB en OpenMacFUSE op 46,4 MB.
0 20 40 60 MB 0123456 u Begin: 45 MBNa 6 u: 51 MB
Afbeelding 5 Test van zes uur. Zes uur lang een gemengde belasting van lezen, schrijven, aanmaken en verwijderen op Intel i7 / macOS 12.7, eens per minuut gemeten (in de grafiek staat één punt per 20 minuten). Een lineaire trendlijn geeft +0,27 MB per uur. Aan het einde klopte elk bestand bij de controle en was het aantal geopende bestandsdescriptors ongewijzigd.

5macOS-gedrag

OpenMacFUSE houdt ._-bestanden van de schijf af en zet NTFS-attributen om naar hun macOS-tegenhangers.

Schermafbeelding van Finder: een NTFS-volume gekoppeld via OpenMacFUSE, zonder ._-bestanden in de lijst
Schermafbeelding B Een NTFS-volume, gekoppeld via OpenMacFUSE, zoals het in Finder staat (macOS 12.7.6, schermafbeelding). Het volume is beschrijfbaar en de lijst bevat geen ._-bestanden.

AppleDouble

De NFS-client van macOS gebruikt standaard geen named attributes. Hij verpakt de uitgebreide attributen, de resource fork en de Finder-info van een bestand in een AppleDouble-bestand met de naam ._bestandsnaam en stuurt dat met gewone OPEN- en WRITE-bewerkingen naar de server. Slaat de server wat hij ontvangt gewoon op, dan belanden die bestanden op de schijf en verschijnen ze in Windows als rommel.

Dit viel meer op vanaf macOS 26: het systeem voegt aan elk nieuw bestand een com.apple.provenance-attribuut toe, zodat bij elk bestand ook een ._-bestand hoort. Een dataset van 40.000 kleine bestanden die via FUSE-T werd geschreven, liet 40.048 extra ._-bestanden op de schijf achter. Een git-repository op het volume toonde 48 niet-gevolgde bestanden en git fsck meldde 67 fouten.

OpenMacFUSE herkent op de server toegang tot ._-bestanden, leest de AppleDouble-inhoud uit en schrijft elk attribuut naar een NTFS alternate data stream van het hoofdbestand. Bij het lezen bouwt hij het AppleDouble-bestand op aanvraag opnieuw op. Er wordt geen apart bestand op de schijf gemaakt en er verschijnt er ook geen in mapoverzichten. Staan er op een schijf al ._-bestanden, dan worden die verborgen en wordt elk ervan naar de data stream verplaatst zodra het bijbehorende hoofdbestand weer wordt gewijzigd.

Twee schrijfacties van de client photo.jpg._photo.jpg Opgeslagen zoals verstuurd photo.jpg ._photo.jpg zichtbaar inWindows OpenMacFUSE photo.jpghoofddatastroom photo.jpg:<alternate stream>xattrs, Finder-info, resource fork één bestandop schijf
Afbeelding 6 Twee uitkomsten van dezelfde opslagactie. Alternate data streams zijn een ingebouwd onderdeel van NTFS; Windows Verkenner toont ze niet en ze gaan mee met het hoofdbestand wanneer dat wordt gekopieerd.

De prijs is het filteren bij het weergeven van mappen: de eerste weergave van een map met 40.000 items gaat van 1,4 s naar 3,6 s. Wij vinden dat een redelijke afweging.

Overig gedrag

FunctieGedrag van OpenMacFUSEWaargenomen bij FUSE-T
Hoofdletters in bestandsnamenStandaard niet hoofdlettergevoelig maar wel hoofdletterbehoudend, zoals in Windows. Bevat het volume al namen die alleen in hoofdletters verschillen, dan schakelt het volume automatisch over op hoofdlettergevoeligHoofdlettergevoelig
Unicode-normalisatieDe NFC- en NFD-vorm van een naam leiden naar hetzelfde bestand (letters met accenten, Koreaans)Niet getest
Attribuut VerborgenDe NTFS-bit HIDDEN en de vlag voor verborgen items van Finder worden in beide richtingen omgezetNiet omgezet
Attribuut Alleen-lezenDe NTFS-bit READONLY maakt het bestand in macOS niet beschrijfbaarNiet overgenomen
Aanmaaktijdstat -f %B geeft de op schijf opgeslagen aanmaaktijd terugAltijd 0
Byte-range locksOndersteund; SQLite-databases kunnen rechtstreeks op het volume worden geopendNiet getest

6Foutafhandeling

Externe schijven worden zonder waarschuwing losgetrokken. Dat is gewoon gebruik, geen uitzonderlijk geval, en OpenMacFUSE heeft drie mechanismen die dan de koppeling opruimen. Een koppellaag op basis van NFS heeft één inherent risico: de koppeling is hard, dus zodra de server niet meer antwoordt, belandt elk proces dat het volume aanraakt in een niet-onderbreekbare wachtstand en reageert Finder niet meer. De koppellaag moet garanderen dat altijd iets het koppelpunt opruimt:

00,10,20,30,40,5 s USB-voeding weg 0,19 sschrijver krijgt een foutmelding 0,21 skoppelpunt weg 0,45 sdriver stopt
Afbeelding 7 Tijdlijn nadat een relais tijdens het schrijven de stroom van een USB-SSD afsnijdt (één gemeten testrun, overeenkomend met de log in Afbeelding 8). Over vijf runs ligt het bereik tussen 0,24 en 0,47 s. Als het volume niet in gebruik is, hangt het af van het controle-interval en is het ongeveer 1,3 s.
Testlog, vertaald · 120 GB USB-SSD · Intel i7 / macOS 12.7.6
== stroomuitval: B-write1 (belasting: schrijven, na de wijzigingen, NTFSTOOL_DRIVER_FSYNC=bounded)
  - na de uitval: schrijffout na 0,19 s; koppelpunt weg na 0,21 s;
    driver gestopt na 0,45 s; niet-onderbreekbare processen: 0
  [pass] van stroomuitval tot volledig herstel 0,45 s (limiet 10 s)
  - 303 bestanden gefsynct; laatste fsync-terugkeer tot detectie van apparaatverlies 0,081 s
  [pass] koppelt na de uitval zonder ntfsfix (0,33 s)
Afbeelding 8 Fragment uit de log van dezelfde run. “Niet-onderbreekbare processen: 0” betekent dat er geen proces is blijven hangen in een wachtstand die signalen niet kunnen onderbreken.

Consistentie na stroomuitval

Na stroomuitval tijdens het schrijven koppelt het volume nu in elke testrun zonder reparatieprogramma, en komt geen enkel bestand terug met een verkeerde inhoud. De koppellaag kan twee dingen beïnvloeden: of het volume zonder reparatieprogramma wordt gekoppeld zodra de voeding terug is, en hoeveel van de schrijfacties die al aan de app waren bevestigd behouden blijven. OpenMacFUSE past hier drie dingen aan:

USB-SSD, stroomuitval tijdens het schrijvenVóór de wijzigingenErna (standaardstrategie)
Te koppelen zonder reparatieprogramma zodra de voeding terug is3 van 5 runs mislukten door een verschil in $MFTMirrElke run
Verloren bevestigde bestanden per run12–191–27, allemaal geschreven in ongeveer de laatste seconde
Bestanden met een verkeerde inhoudSommige bestanden kwamen terug als louter nullen0

“Vóór de wijzigingen” is het gedrag van de engine vóór dit werk; dezelfde engine, via FUSE-T gekoppeld, gaf dezelfde resultaten. Geen enkel bestandssysteem kan de gegevens van het allerlaatste moment garanderen als een draagbare schijf zonder batterij midden in het schrijven zonder stroom komt te zitten. Het doel is het verlies te beperken tot de meest recente schrijfacties en de structuur van het volume intact te laten.

7Testmethode

OnderdeelToelichting
HardwareMacBook Pro (Intel i7-4770HQ, 16 GB, macOS 12.7.6); Mac (Apple M2, 24 GB, macOS 27.0.1); 120 GB USB-SSD, 1 TB USB-harde schijf, USB-stick
VergelijkingDezelfde Mac, hetzelfde image, dezelfde broncode van de NTFS-engine; alleen de koppellaag verschilt. FUSE-T versie 1.0.49
TijdmetingBij schrijfmetingen is sync inbegrepen; sequentiële leesmetingen draaien na ontkoppelen en opnieuw koppelen, om de clientcache te omzeilen
Geheugenri_phys_footprint uit proc_pid_rusage, met intervallen van 0,2 s
Loskoppelen en stroomuitvalEen relais schakelt de 5 V-USB-voeding uit zonder eerst te ontkoppelen. Zodra de voeding terug is, wordt de volumestructuur alleen-lezen gecontroleerd, daarna wordt het volume zonder reparatie gekoppeld en wordt elk bestand vergeleken
Correctheid300 s willekeurige lees-/schrijfvergelijking (692.000 bewerkingen, 0 verschillen); 8 gelijktijdige schrijvers plus 2 recursieve mapweergaven; volumestructuur gecontroleerd na elke run
Regressie15 scriptsuites met 869 controles voor NTFS-lezen/schrijven, macOS-gedrag en ext-, exFAT- en BitLocker-volumes, plus foutinjectie: loskoppelen, geforceerd beëindigen, vastlopen en time-out van de handshake bij het koppelen
Testlog, vertaald · Apple M2 / macOS 27.0.1 · één lees-/schrijfrun (fragment)
07:29:09   [pass] gekoppeld
07:29:10   [pass] groot bestand geschreven
07:29:12   [pass] kleine bestanden geschreven
07:29:13   [pass] MD5 van groot bestand klopt
07:29:13   [pass] alle MD5's van kleine bestanden kloppen
07:29:13   [pass] hernoemen / toevoegen / inkorten / verwijderen
07:29:13   [pass] openen zonder hoofdlettergevoeligheid
07:29:13   [pass] geen ._-bestanden in de lijst
07:29:13   [pass] uitgebreide attributen lezen en schrijven
07:29:15   [pass] normaal ontkoppeld
07:29:15   [pass] driver gestopt
07:29:15   [pass] bewakingsproces gestopt
Afbeelding 9 Een run geldt pas als voltooid wanneer na het ontkoppelen zowel de driver als het bewakingsproces zijn gestopt en de controle van de volumestructuur geen fouten meldt.

8Beperkingen

9Conclusie

OpenMacFUSE is de standaard koppellaag voor Driver 1 in NTFSTool Pro; NTFS-, ext-, exFAT- en BitLocker-volumes worden er allemaal mee gekoppeld. Het loont om de koppellaag in een eigen codebase te houden, op vier punten:

FAQ

Wat is OpenMacFUSE?
OpenMacFUSE is de open-source koppellaag in userspace die NTFSTool heeft ontwikkeld en die in NTFSTool Pro is ingebouwd. Hij koppelt NTFS-, ext-, exFAT- en BitLocker-volumes op macOS. Het is een NFSv4.0-server die in het driverproces draait en geen kernelextensie gebruikt.
Moet ik macFUSE of FUSE-T installeren om NTFSTool Pro te gebruiken?
Nee. OpenMacFUSE, de eigen koppellaag van NTFSTool, zit in NTFSTool Pro. Hij is niet afhankelijk van macFUSE, FUSE-T of een kernelextensie, en je hoeft nooit op te starten in macOS-herstel om de beveiligingsinstellingen van je Mac te verlagen.
Hoe presteert OpenMacFUSE vergeleken met FUSE-T?
Op dezelfde Mac met dezelfde NTFS-engine duurt een checksum van elk bestand op een volume 23 s met OpenMacFUSE tegenover 797 s met FUSE-T, en 10.000 kleine bestanden verwijderen gaat 6 tot 9 keer sneller. Sequentieel lezen en schrijven van grote bestanden op echte USB-schijven is even snel. Het geheugengebruik van OpenMacFUSE blijft op 45 tot 51 MB, tegenover 200 MB tot 1 GB bij FUSE-T.
Wat gebeurt er als ik een schijf loskoppel tijdens het schrijven?
De OpenMacFUSE-driver ontkoppelt het volume en stopt zelf binnen ongeveer 0,5 s, zodat Finder en andere apps niet blijven hangen. Als je de schijf weer aansluit, wordt het volume gewoon gekoppeld. Schrijfacties uit ongeveer de laatste seconde voor het wegvallen van de stroom kunnen ontbreken; de inhoud van andere bestanden blijft ongewijzigd.
Waarom heeft NTFSTool een eigen koppellaag geschreven in plaats van een open-sourceonderdeel of onderdeel van een andere partij te gebruiken?
De koppellaag bepaalt de snelheid, het geheugengebruik en wat er gebeurt als iets misgaat. Met een eigen implementatie kan NTFSTool problemen in één codebase traceren en verhelpen, en wordt NTFS-specifiek gedrag (hoofdlettergevoeligheid, de attributen Verborgen en Alleen-lezen, uitgebreide attributen) samen met de engine van het bestandssysteem afgehandeld.
Is OpenMacFUSE een open-sourceproject?
Ja. OpenMacFUSE is een open-sourceproject onder de MIT-licentie en de code staat op GitHub: ntfstool/openmacfuse. Elk FUSE 2.x-bestandssysteem kan eraan worden gelinkt.

Alle gegevens in dit artikel zijn gemeten door het technische team van NTFSTool; de testmethode staat in sectie 7. FUSE-T is een project van de maker ervan en heeft geen band met NTFSTool. OpenMacFUSE is een zelfstandig project en heeft geen band met macFUSE of de makers ervan.

Hulp nodig? Mail service@ntfstool.com — een echt mens antwoordt binnen 48 uur.
Helpcentrum