用户可借助该项目在Linux、FreeBSD等多操作系统中实现对Windows NTFS文件系统的安全快速读写。它支持文件权限、POSIX ACLs、扩展属性等功能，还提供ntfsprogs工具集用于分区管理与数据恢复。【此简介由AI生成】

文件	最后提交记录	最后更新时间
include	ACLs: size inherited ACLs generically The previous commit targets the overflow bug report directly: count DENY ACEs with CONTAINER_INHERIT_ACE that reference CREATOR_OWNER and reserve per match slack. But it doesn't cover all cases. An ACE has an 8-byte fixed part plus a variable-length SID. ntfs_inherit_acl() replaces creator placeholders (the 12-byte CREATOR_OWNER and CREATOR_GROUP SIDs) with the real owner or group SID, often larger, so substituted ACEs grow. That substitution runs in more shapes than the previous counter recognises: for both ACCESS_ALLOWED and ACCESS_DENIED ACEs, for both CREATOR_OWNER and CREATOR_GROUP, and regardless of any inheritance flag whenever the parent descriptor's auto-inherited bit is clear. And when the resolved owner SID happens to equal the static creator-group SID (S-1-3-1), a single ACE is substituted twice in the same pass — once as owner, once as group — doubling its growth. Each of those uncovered shapes can under-allocate at the same write site as the originally reported issue. Replace the counter with ntfs_inherit_acl_extra_size(), which covers all four ALLOW/DENY x OWNER/GROUP combinations, reserves slack for the double-substitution case, validates each ACE's SID structurally before matching, and returns bytes directly so build_inherited_id() no longer encodes the per-ACE growth formula. Thanks to Alexandro Calo' from Nozomi Networks Labs.	1 个月前
libfuse-lite	Hardened the checking of directory offset requested by a readdir When asked for the next directory entries, make sure the chunk offset is within valid values, otherwise return no more entries in chunk.	4 年前
libntfs-3g	ACLs: size inherited ACLs generically The previous commit targets the overflow bug report directly: count DENY ACEs with CONTAINER_INHERIT_ACE that reference CREATOR_OWNER and reserve per match slack. But it doesn't cover all cases. An ACE has an 8-byte fixed part plus a variable-length SID. ntfs_inherit_acl() replaces creator placeholders (the 12-byte CREATOR_OWNER and CREATOR_GROUP SIDs) with the real owner or group SID, often larger, so substituted ACEs grow. That substitution runs in more shapes than the previous counter recognises: for both ACCESS_ALLOWED and ACCESS_DENIED ACEs, for both CREATOR_OWNER and CREATOR_GROUP, and regardless of any inheritance flag whenever the parent descriptor's auto-inherited bit is clear. And when the resolved owner SID happens to equal the static creator-group SID (S-1-3-1), a single ACE is substituted twice in the same pass — once as owner, once as group — doubling its growth. Each of those uncovered shapes can under-allocate at the same write site as the originally reported issue. Replace the counter with ntfs_inherit_acl_extra_size(), which covers all four ALLOW/DENY x OWNER/GROUP combinations, reserves slack for the double-substitution case, validates each ACE's SID structurally before matching, and returns bytes directly so build_inherited_id() no longer encodes the per-ACE growth formula. Thanks to Alexandro Calo' from Nozomi Networks Labs.	1 个月前
m4	fix build process: add m4/.keep	16 年前
ntfsprogs	ntfscat.c: Fix reading outside the buffer when block size > buffer size. The block size may be read from the index root's 'index_block_size' member, and isn't guaranteed to be >= 4096 (as far as I can tell it could be larger). This would for MST protected records lead to storing data past the end of the allocated buffer. Fixed by allocating the necessary amount of buffer space for the case when the block size exceeds 4096. Thanks to Alexandro Calo' from Nozomi Networks Labs for reporting this issue.	1 个月前
src	ntfs-3g_common.c: Fix incorrect 'sscanf' return value checks (pedantic). This silences a static analyzer warning but since we only supply one format placeholder, there's no reason to expect any other non-0 return value than 1.	6 个月前
AUTHORS	Implemented backup/restoring of encrypted files (by Martin Bene)	16 年前
COPYING	add COPYING file explicitely because autogen.sh doesn't create it automatic since COPYING.LIB was added (Tom "spot" Callaway, Szabolcs Szakacsits)	16 年前
COPYING.LIB	add COPYING.LIB for fuse-lite	16 年前
CREDITS	Merge remote branch 'linux-ntfs/libntfs-3g_port' into PERMISSION_HANDLING_BRANCH Conflicts: AUTHORS COPYING CREDITS ChangeLog Makefile.am NEWS README autogen.sh configure.ac include/Makefile.am	15 年前
ChangeLog	Defined Github as the host for documentation Documentation and support is now on github.com/tuxera	4 年前
Makefile.am	Got the target libs to build libntfs-3g and libfuse-lite if selected	14 年前
NEWS	Defined Github as the host for documentation Documentation and support is now on github.com/tuxera	4 年前
README	Updated the README Added a recommendation to use ntfs-3g packaged by a distribution, and inserted a link to the Wiki.	4 年前
TODO.ntfsprogs	cosmetic : fixed improper wordings (hggdh2)	14 年前
autogen.sh	Updated files needed to make a build	17 年前
configure.ac	Version 2026.7.7.	1 个月前

自动翻译

简介

NTFS-3G 驱动是一款开源、免费提供的读写 NTFS 驱动，适用于 Linux、FreeBSD、macOS、NetBSD、OpenIndiana、QNX 和 Haiku 系统。它能够安全、高效地处理 Windows XP、Windows Server 2003、Windows 2000、Windows Vista、Windows Server 2008、Windows 7、Windows 8、Windows Server 2012、Windows Server 2016、Windows 10 以及 Windows Server 2019 的 NTFS 文件系统。

本项目旨在为那些需要与 NTFS 进行可靠互操作的硬件平台和操作系统，开发、质量保证并支持一个可信赖、功能丰富且高性能的解决方案。除了这一实际目标外，该项目还致力于探索混合式内核/用户空间文件系统驱动方法在性能、可靠性以及投入产出比方面的功能丰富度极限。

除了常见的文件系统功能外，NTFS-3G 还支持文件所有权与权限、POSIX ACL、连接点、扩展属性以及创建内部压缩文件（可能需要 .NTFS-3G 目录中的参数文件来启用这些功能）。Windows 10 中可用的新型压缩文件格式也可通过插件读取。

新闻、支持解答、问题提交说明、支持和讨论论坛以及其他信息可在项目网站获取：

https://github.com/tuxera/ntfs-3g/wiki

自 2008 年起，该项目由 Tuxera 资助、支持并维护：

https://tuxera.com

许可协议

所有与 NTFS 相关的组件：文件系统驱动程序、ntfsprogs 实用工具以及共享库 libntfs-3g，均根据自由软件基金会发布的 GNU 通用公共许可证条款进行分发；您可以选择版本 2，或者（根据您的选择）任何更高版本。详见附带的 COPYING 文件。

fuse-lite 库根据 GNU LGPLv2 条款进行分发。详见附带的 COPYING.LIB 文件。

快速安装

大多数发行版都提供了随时可用的最新 NTFS-3G 软件包，推荐的安装方式是直接安装该软件包。

如果您需要进行特定的自定义配置，可以从已发布的源代码编译并安装。请确保您拥有基本的开发工具，并且内核包含 FUSE 内核模块。然后解压缩源代码 tarball 并输入：

./configure
make
make install      # 如果您不是 root 用户，则使用 'sudo make install'。

请注意，NTFS-3G 不再需要 FUSE 用户空间软件包。

通过输入以下命令可以显示用于构建特定配置的选项列表：

./configure --help

以下是 ./configure 的一些特定选项：

--disable-ntfsprogs : 不构建 ntfsprogs 工具，
--enable-extras : 构建更多的 ntfsprogs 工具，
--disable-plugins : 禁用插件支持
--enable-posix-acls : 启用 Posix ACL 支持
--enable-xattr-mappings : 启用系统扩展属性映射
--with-fuse=external : 使用外部 fuse（覆盖 Linux 默认设置）

还有一些用于构建部分组件的 make 目标：

make libntfs : 仅构建 libntfs-3g 库
make libs : 仅构建 libntfs-3g（以及 libfuse-lite，如果相关）
make drivers : 仅构建驱动程序和库，不包含 ntfsprogs
make ntfsprogs : 仅构建 ntfsprogs 和 libntfs-3g，不包含驱动程序

使用方法

如果安装过程中没有出现错误，那么 root 用户可以通过以下方式为所有用户以读写模式挂载 NTFS 卷（如果卷已挂载，请先卸载，并根据需要替换 /dev/sda1 和 /mnt/windows）：

mount -t ntfs-3g /dev/sda1 /mnt/windows

或者 ntfs-3g /dev/sda1 /mnt/windows

有关更多选项和示例，请参阅 ntfs-3g 手册页。

您还可以通过将以下行添加到 /etc/fstab 文件的末尾(!)，使 NTFS 在引导时自动挂载：

/dev/sda1 /mnt/windows ntfs-3g defaults 0 0

无需安装即可测试

较新版本的 ntfs-3g 可以在不安装任何内容且不干扰现有安装的情况下进行测试。只需按照前面所示进行配置和编译。这将在 src 目录中创建 ntfs-3g 和 lowntfs-3g 脚本，您可以激活它们进行测试：

./configure make

然后，以 root 用户身份： src/ntfs-3g [-o 挂载选项] /dev/sda1 /mnt/windows

要结束测试，请按常规方式卸载： umount /dev/sda1

NTFS 实用工具

ntfsprogs 目录包含用于对 NTFS 分区执行所有必要任务的实用工具。通常，只需运行不带任何命令行选项的实用工具，即可显示版本号和使用语法。

目前已实现以下实用工具：

ntfsfix - 尝试修复 NTFS 分区并强制 Windows 检查 NTFS。

mkntfs - 使用 NTFS 文件系统格式化分区。有关命令行选项，请参阅 man 8 mkntfs。

ntfslabel - 显示/更改 NTFS 分区的卷标。有关详细信息，请参阅 man 8 ntfslabel。

ntfsundelete - 从 NTFS 卷恢复已删除的文件。有关更多详细信息，请参阅 man 8 ntfsundelete。

ntfsresize - 调整 NTFS 卷的大小。有关详细信息，请参阅 man 8 ntfsresize。

ntfsclone - 高效创建/恢复 NTFS 分区的镜像。有关详细信息，请参阅 man 8 ntfsclone。

ntfscluster - 查找 NTFS 分区上任何给定扇区或簇的所有者。有关详细信息，请参阅 man 8 ntfscluster。

ntfsinfo - 显示有关 NTFS 分区或其中一个文件或目录的一些信息。有关详细信息，请参阅 man 8 ntfsinfo。

ntfsrecover - 恢复由 Windows 提交但在同步前被中断的更新。

ntfsls - 列出 NTFS 分区上目录中文件的信息。有关详细信息，请参阅 man 8 ntfsls。

ntfscat - 连接文件并将其内容打印到标准输出。

ntfscp - 覆盖 NTFS 分区上的文件。

ntfssecaudit - 审计安全元数据。

ntfsusermap - 辅助构建用户映射文件。

项目介绍