# 使用 Homebrew, apk, apt, dnf, Nix, pacman, zypper 安装 fuse-overlayfs

查看 fuse-overlayfs 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:fuse-overlayfs
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install fuse-overlayfs
```

  证据: local Homebrew formula metadata

### Linux

- apk (92%):

```sh
sudo apk add fuse-overlayfs
```

  证据: Alpine Linux edge package indexes: fuse-overlayfs from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

- Debian apt (92%):

```sh
sudo apt install fuse-overlayfs
```

  证据: Debian stable package indexes: fuse-overlayfs from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- dnf (92%):

```sh
sudo dnf install fuse-overlayfs
```

  证据: Fedora Rawhide package metadata: fuse-overlayfs from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-primary.xml.zst

- Nix (92%):

```sh
nix profile install nixpkgs#fuse-overlayfs
```

  证据: nixpkgs package indexes: pkgs/by-name/fu/fuse-overlayfs/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- pacman (92%):

```sh
sudo pacman -S fuse-overlayfs
```

  证据: Arch Linux sync databases: fuse-overlayfs from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

- zypper (92%):

```sh
sudo zypper install fuse-overlayfs
```

  证据: openSUSE Tumbleweed package metadata: fuse-overlayfs from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst

## 软件包事实

- **软件包键:** brew:fuse-overlayfs
- **软件包管理器:** Homebrew
- **版本:** 1.17
- **来源摘要:** FUSE implementation for overlayfs
- **主页:** <https://github.com/containers/fuse-overlayfs>
- **仓库:** <https://github.com/containers/fuse-overlayfs>
- **最后更新:** 2026-06-09T12:53:39Z
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- fuse-overlayfs (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

- 页面生成时间: 2026-08-03
- 管理器版本: 1.17
## 项目历史与用法

fuse-overlayfs is a FUSE implementation of overlay-style filesystems for rootless containers. The official README describes it as an implementation of overlay and shiftfs in FUSE, with command-line options for lower, upper, work, merged, UID, and GID mappings.

### 项目历史

The project lives under the containers organization and is written in Rust. Its README documents libfuse 3.2.1 or newer as a requirement and notes that use from a user namespace, such as rootless Podman, requires a Linux kernel at least 4.18.0.

### 采用历史

fuse-overlayfs became part of the rootless-container storage story because many kernels prevent unprivileged users from mounting kernel overlay filesystems. The containers/storage manual documents `mount_program = "/usr/bin/fuse-overlayfs"` as the custom mount helper used when rootless storage cannot use kernel defaults.

The same containers/storage documentation names fuse-overlayfs in its `SEE ALSO` section and in examples involving permission masks, showing that it is treated as a normal component of the containers storage stack rather than a standalone experiment.

### 使用方式

Users can run fuse-overlayfs directly by passing overlay-style mount options such as `lowerdir`, `upperdir`, `workdir`, and a merged directory. Container engines more often invoke it indirectly through containers/storage configuration as a `mount_program`.

The project also distributes pre-built static binaries for multiple architectures through GitHub Releases, which makes it practical on container hosts where the binary is needed before normal package-manager integration is available.

### 为什么软件包爱好者会关心

The package matters because it made overlay-style copy-on-write storage usable for rootless container workflows before all target kernels could provide equivalent unprivileged overlay support. It is a small package with outsized influence in Podman and OCI tooling because storage-driver details determine whether rootless containers feel native or second-class.

### 时间线

- 2017: containers/storage documentation originates the shared storage configuration manual.
- v1.0.0: fuse-overlayfs reaches a stable tagged release line.
- Current README: project documents rootless Podman and Linux kernel requirements for user-namespace operation.

### Related projects

- fuse-overlayfs is closely related to containers/storage, which documents the `mount_program` setting.
- It is also related to Podman rootless operation, which relies on the containers configuration stack for user storage.

### 来源

- <https://github.com/containers/fuse-overlayfs>
- <https://github.com/containers/fuse-overlayfs/blob/main/README.md>
- <https://github.com/containers/podman/blob/main/docs/tutorials/rootless_tutorial.md>
- <https://github.com/containers/storage/blob/main/docs/containers-storage.conf.5.md>


## 安全说明

narrow executable package without higher-risk signals.

- **Geiger 风险:** 绿色 / 低
- narrow executable package without higher-risk signals

## 其他软件包管理器记录

- Debian apt - fuse-overlayfs - 1.14-1+b1: normalized package name match | Debian stable package indexes: fuse-overlayfs from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | implementation of overlay+shiftfs in FUSE for rootless containers | https://github.com/containers/fuse-overlayfs
- Nix - fuse-overlayfs: normalized package name match | nixpkgs package indexes: pkgs/by-name/fu/fuse-overlayfs/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Ubuntu apt - fuse-overlayfs - 1.13-1: normalized package name match | Ubuntu 24.04 LTS package indexes: fuse-overlayfs from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | implementation of overlay+shiftfs in FUSE for rootless containers | https://github.com/containers/fuse-overlayfs
- apk - fuse-overlayfs - 1.16-r0: normalized package name match | Alpine Linux edge package indexes: fuse-overlayfs from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | FUSE implementation for overlayfs | https://github.com/containers/fuse-overlayfs
- apk - fuse-overlayfs-doc - 1.16-r0: normalized package name match | Alpine Linux edge package indexes: fuse-overlayfs-doc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | FUSE implementation for overlayfs (documentation) | https://github.com/containers/fuse-overlayfs
- dnf - fuse-overlayfs - 1.17-1.fc45: normalized package name match | Fedora Rawhide package metadata: fuse-overlayfs from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-primary.xml.zst | FUSE overlay+shiftfs implementation for rootless containers | https://github.com/containers/fuse-overlayfs
- pacman - fuse-overlayfs - 1.17-1: normalized package name match | Arch Linux sync databases: fuse-overlayfs from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | FUSE implementation of overlayfs | https://github.com/containers/fuse-overlayfs
- zypper - fuse-overlayfs - 1.16-1.6: normalized package name match | openSUSE Tumbleweed package metadata: fuse-overlayfs from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | FUSE implementation for overlayfs | https://github.com/containers/fuse-overlayfs


## Combined YAML source

View the package source record on GitHub. [combined/fuse-overlayfs.yml](https://github.com/mxcl/pkgdb/blob/main/combined/fuse-overlayfs.yml)


## 来源

- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph
