# macFUSE

macOS 运行时和 API，供单独安装的用户空间 FUSE 文件系统使用；提供内核和 FSKit 后端，设置要求因后端而异。

> 这是 OpenNavo 上 macFUSE 页面的 Markdown 版本，内容与网页相同： <https://opennavo.com/zh/apps/macfuse>

- **最新版本**: `5.5.0`
- **开发者**: Benjamin Fleischer and contributors
- **主页**: <https://macfuse.github.io/>
- **分类**: [驱动与硬件](https://opennavo.com/zh/categories/drivers)
- **安装**: `brew install --cask macfuse`
- **近 30 天安装**: 6,987
- **Homebrew**: 可以安装，应用会自行更新
- **下载地址**: <https://github.com/macfuse/macfuse/releases/download/macfuse-5.5.0/macfuse-5.5.0.dmg>
- **SHA-256**: `92c21ef2db4199bcf5bddc8e6efb57b23ecb9715f74ab38cba2c77ab226d3830`
- **安装包**: Extras/macFUSE 5.5.0.pkg

SHA-256 只用来核对下载的文件是否完整，不代表安全认证。

## 注意事项

macfuse requires a kernel extension to work. If the installation fails, retry after you enable it in: System Settings → Privacy & Security For more information, refer to vendor documentation or this Apple Technical Note: https://developer.apple.com/library/content/technotes/tn2459/_index.html

## 安装与卸载内容

```json
[
  {
    "declaration": {
      "uninstall": [
        {
          "launchctl": [
            "io.macfuse.app.launchservice.broker",
            "io.macfuse.app.launchservice.daemon"
          ],
          "pkgutil": [
            "io.macfuse.installer.components.core",
            "io.macfuse.installer.components.preferencepane"
          ]
        }
      ]
    },
    "phase": "uninstall",
    "sources": [],
    "type": "uninstall"
  },
  {
    "declaration": {
      "pkg": [
        "Extras/macFUSE 5.5.0.pkg"
      ]
    },
    "phase": "install",
    "sources": [
      "Extras/macFUSE 5.5.0.pkg"
    ],
    "type": "pkg"
  },
  {
    "declaration": {
      "postflight_steps": [
        {
          "steps": [
            {
              "non_recursive": true,
              "paths": [
                {
                  "path": "/usr/local/include"
                },
                {
                  "path": "/usr/local/lib"
                }
              ],
              "type": "set_ownership"
            }
          ]
        }
      ]
    },
    "phase": "install",
    "sources": [],
    "type": "postflight_steps"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": [
            "/Library/PreferencePanes/macFUSE.prefPane",
            "~/Library/Caches/io.macfuse.preferencepanes.macfuse",
            "~/Library/HTTPStorages/io.macfuse.preferencepanes.macfuse"
          ]
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## 介绍

macFUSE 是 Benjamin Fleischer 为 macOS 开发的文件系统集成软件包。它可让单独安装的用户空间 FUSE 文件系统将其内容作为已挂载的卷公开。它是兼容存储应用和开发者所需的基础设施，并非独立文件管理器，也不附带一组文件系统。

### 功能
- 将 macOS 文件系统操作桥接到用户空间文件系统进程。
- 支持兼容的第三方文件系统，其数据可来自本地文件、远程存储、内存或其他来源。
- 为开发者提供兼容 libfuse2/libfuse3 的 API 和 macFUSE.framework。
- 提供内核和 FSKit 后端，二者在功能与操作系统支持方面有所不同。
- 提供运行时组件、挂载工具及配套框架。
- 安装适当的独立文件系统后，可用于远程存储、加密视图和应用专用虚拟卷等场景。

### 安装和首次使用
安装 `brew install --cask macfuse`，或打开官方 DMG 并运行安装程序。发布方建议使用其当前版本的官方下载，并指出包管理器发行版并非由 macFUSE 开发者维护。此 cask 会运行软件包安装程序，而不是复制普通的 GUI 应用。请另行安装兼容的 FUSE 文件系统，然后按照该产品的挂载说明操作。仅安装 macFUSE 并不会提供 SSHFS、NTFS 支持、云账户或任何特定文件系统。

### 系统要求和后端选择
官方当前下载版本要求 macOS12 或更高版本，并支持 Apple Silicon 和 Intel。检索到的要求中未确认固定的 RAM 或磁盘空间最低要求。当前5.4.0 DMG 下载大小为16,512,456 字节；这与已安装组件及已挂载数据的大小无关。macFUSE 本身是 macOS 软件；虽然 FUSE API 在其他系统上也有实现，但这并不意味着此软件包是 Linux 或 Windows 安装程序。

官方《入门指南》介绍，FSKit 从 macOS15.4 起可用；主页则强调 macOS26 上受支持的用户空间文件系统。兼容的 FSKit 工作流程无需加载内核扩展，也不需要更改恢复模式安全设置。后端在功能和性能上的差异以及文件系统兼容性仍需考虑。内核后端使用内核扩展。在 Apple Silicon 上，首次设置内核后端时，可能需要在恢复模式下启用第三方内核扩展，并在系统安全设置中批准 macFUSE，然后重新启动。Intel Mac 也需要进行适用的批准。请遵循针对相应后端的官方指南，不要假设每种安装都需要相同的更改。cask 中关于内核扩展的一概而论式旧提示，并不能准确描述所有当前的 FSKit 工作流程。

### 依赖项、冲突和维护
cask 声明没有额外的 formula 依赖项，但明确与 macfuse@dev 冲突。要实际挂载自定义文件系统，需要第三方文件系统程序；该程序也可能有自己的服务器、凭据、网络、许可和权限要求。其他已安装版本或旧 FUSE 组件可能影响依赖它的产品；更改运行时之前，请查阅这些产品的兼容性要求。macFUSE 会安装系统级运行时和挂载组件，因此更新可能影响使用这些组件的其他应用。移除或维护之前，请卸载正在使用的 FUSE 卷，并妥善保存其中的工作。Homebrew 卸载会使用软件包收据并处理启动服务；可选的 zap 操作还会移除偏好设置面板和相关用户缓存。不要将卸载共享运行时视同删除独立封装的应用。

### 账户、费用和许可
无需核心用户账户或订阅即可获取官方软件包；项目也接受赞助。第三方文件系统和存储服务可能会另行收费。macFUSE 使用自身的 BSD 风格许可，并附有额外条件，并非不受限制的 MIT 许可。尤其是，与商业软件捆绑的二进制再分发（包括在此商业情境下自动下载或安装）需要事先取得书面许可。所纳入的组件各有其许可声明。若要再分发或集成到产品中，请查阅完整的官方许可；普通安装并不授予不受限制的商业捆绑权利。

### 官方参考资料
- [官方主页、要求和下载](https://macfuse.github.io/)
- [入门指南和后端设置](https://github.com/macfuse/macfuse/wiki/Getting-Started)
- [FUSE 后端](https://github.com/macfuse/macfuse/wiki/FUSE-Backends)
- [官方发行版本](https://github.com/macfuse/macfuse/releases)
- [许可](https://github.com/macfuse/macfuse/blob/release/macfuse/LICENSE.txt)

## 系统要求

- 适用于 macOS 27, 26, 15, 14, 13, 12, 11 的版本 · 应用版本: 5.5.0 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/m/macfuse.rb> · 核查于 2026-11-22
  - <https://github.com/macfuse/macfuse/releases/download/macfuse-5.5.0/macfuse-5.5.0.dmg>
  - SHA-256: `92c21ef2db4199bcf5bddc8e6efb57b23ecb9715f74ab38cba2c77ab226d3830`
- 适用于 macOS 27, 26, 15, 14, 13, 12, 11 的版本 · 应用版本: 5.5.0 · Apple 芯片 · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/m/macfuse.rb> · 核查于 2026-11-22
  - <https://github.com/macfuse/macfuse/releases/download/macfuse-5.5.0/macfuse-5.5.0.dmg>
  - SHA-256: `92c21ef2db4199bcf5bddc8e6efb57b23ecb9715f74ab38cba2c77ab226d3830`

## 卸载

- `brew uninstall --cask macfuse`

普通卸载会删除应用本身，设置和缓存会保留。

### 卸载时还会处理

- 后台服务（launchctl）: `io.macfuse.app.launchservice.broker` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/m/macfuse.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 后台服务（launchctl）: `io.macfuse.app.launchservice.daemon` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/m/macfuse.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 安装包收据（pkgutil）: `io.macfuse.installer.components.core` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/m/macfuse.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 安装包收据（pkgutil）: `io.macfuse.installer.components.preferencepane` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/m/macfuse.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。

### 深度清理（可选）

- `brew uninstall --zap --cask macfuse`

`--zap` 还会删除 Homebrew 定义里列出的设置、缓存等文件，其中可能有其他应用共用的数据，删除后无法恢复；它也不保证没有任何残留。请先备份需要保留的数据；如要保留设置和缓存，请不要加 `--zap`。

普通卸载会删除应用本身，设置和缓存会保留。

- 文件和文件夹: `/Library/PreferencePanes/macFUSE.prefPane` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/m/macfuse.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/Caches/io.macfuse.preferencepanes.macfuse` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/m/macfuse.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/HTTPStorages/io.macfuse.preferencepanes.macfuse` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/m/macfuse.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。

## 最新版本说明

### 5.5.0 (2026-10-30)

已更新至 5.5.0。官方发布说明未列出具体变更。

## 资料与来源

- <https://opennavo.com/zh/apps/macfuse>
- <https://opennavo.com/zh/apps/macfuse/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/m/macfuse.rb> · 核查于 2026-11-22
- <https://formulae.brew.sh/cask/macfuse>
