# 使用 Homebrew, apk, apt, dnf, Nix, pacman, zypper 安装 btrfs-progs

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

## 安装

```sh
sudo av install brew:btrfs-progs
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install btrfs-progs
```

  证据: local Homebrew formula metadata

### Linux

- apk (92%):

```sh
sudo apk add btrfs-progs
```

  证据: Alpine Linux edge package indexes: btrfs-progs from https://dl-cdn.alpinelinux.org/alpine/edge/main/x86_64/APKINDEX.tar.gz

- Debian apt (92%):

```sh
sudo apt install btrfs-progs
```

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

- dnf (92%):

```sh
sudo dnf install btrfs-progs
```

  证据: Fedora Rawhide package metadata: btrfs-progs 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#btrfs-progs
```

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

- pacman (92%):

```sh
sudo pacman -S btrfs-progs
```

  证据: Arch Linux sync databases: btrfs-progs from https://geo.mirror.pkgbuild.com/core/os/x86_64/core.db.tar.gz

- zypper (92%):

```sh
sudo zypper install btrfsprogs
```

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

## 软件包事实

- **软件包键:** brew:btrfs-progs
- **软件包管理器:** Homebrew
- **版本:** 7.1
- **来源摘要:** Userspace utilities to manage btrfs filesystems
- **主页:** <https://btrfs.readthedocs.io/en/latest/>
- **最后更新:** 2026-07-15T00:30:26Z
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- btrfs (别名)
- btrfs-convert (别名)
- btrfs-find-root (别名)
- btrfs-image (别名)
- btrfs-map-logical (别名)
- btrfs-select-super (别名)
- btrfsck (别名)
- btrfstune (别名)
- fsck.btrfs (别名)
- mkfs.btrfs (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

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

btrfs-progs is the userspace tool suite for administering Btrfs filesystems. It is the command-line half of a major Linux filesystem: mkfs, check, rescue, send/receive, subvolume, device, balance, scrub, image, and related tools all live here.

### 项目历史

Btrfs is documented as a modern copy-on-write filesystem for Linux focused on advanced features, fault tolerance, repair, and easy administration. btrfs-progs packages the tools and manual pages needed to create and operate those filesystems from userspace.

The btrfs-progs repository hosts the main btrfs administration command, mkfs.btrfs, libbtrfsutil C and Python bindings, manual pages, and documentation sources. Its release cycle is time-based and follows Linux kernel releases, with signed tags and tarballs hosted on kernel.org.

The GitHub mirror/repository metadata shows public repository creation in 2013, while the tool history follows Btrfs itself and its kernel/userspace split. The project deliberately tracks kernel feature compatibility: btrfs-progs version X.Y declares support for kernel features of the same version.

### 采用历史

btrfs-progs is packaged broadly because Btrfs administration requires matching userspace tools. The input metadata lists Alpine, Homebrew, Debian, Fedora/dnf, Nix, Arch/pacman, Ubuntu, and openSUSE/zypper packaging.

Adoption grew with Btrfs use in Linux distributions, storage appliances, snapshotting workflows, rollback systems, container hosts, and developer machines that want cheap snapshots, checksummed metadata/data, compression, and send/receive replication.

Homebrew packaging is mostly for tooling and cross-platform workflows rather than native macOS filesystem administration, because Btrfs itself is a Linux filesystem.

### 使用方式

The main btrfs command is the administration entry point, while mkfs.btrfs creates filesystems. Other tools support conversion, image capture, rescue, check, logical mapping, tuning, superblock selection, and fsck integration.

Common workflows include creating a filesystem, mounting it with Btrfs-specific options, creating subvolumes and snapshots, balancing allocation profiles, scrubbing for checksum errors, replacing devices, and using send/receive for incremental replication.

There is no general per-user credentials file. Configuration is primarily filesystem state, mount options, kernel interfaces, and command-line usage rather than a single application config file.

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

btrfs-progs is significant because it is the package-manager face of a Linux filesystem. Updating it is not cosmetic: userspace/kernel feature compatibility, rescue environments, static binaries, and signed release provenance all matter.

It is also a good example of packaging a tool suite whose safest operation depends on kernel behavior, hardware characteristics, and filesystem feature flags. Package maintainers care about version alignment, release notes, and conservative defaults more than a single executable.

### 时间线

- 2013: Public GitHub repository metadata records creation of kdave/btrfs-progs.
- 2010s: btrfs-progs matures alongside Btrfs kernel support and distribution adoption.
- 2020s: Release cycle follows Linux kernel releases, with signed release tags and kernel.org tarballs.
- 2026: GitHub tags include v7.0 and late 6.x releases, reflecting ongoing maintenance.

### Related projects

- Btrfs is the Linux copy-on-write filesystem administered by btrfs-progs.
- The Linux kernel contains the filesystem implementation whose feature set btrfs-progs tracks.
- libbtrfsutil provides C and Python bindings for some Btrfs userspace operations.
- BusyBox-style standalone btrfs.box builds support rescue and constrained environments.

### 来源

- <https://api.github.com/repos/kdave/btrfs-progs>
- <https://api.github.com/repos/kdave/btrfs-progs/tags?per_page=10>
- <https://btrfs.readthedocs.io/en/latest>
- <https://btrfs.readthedocs.io/en/latest/Administration.html>
- <https://btrfs.readthedocs.io/en/latest/CHANGES.html>
- <https://btrfs.readthedocs.io/en/latest/Introduction.html>
- <https://github.com/kdave/btrfs-progs>
- source_facts.package-manager


## 安全说明

没有找到 btrfs-progs 的匹配本地密钥处理 manifest。Nucleus 软件包元数据仍在此发布，以便未来覆盖拥有稳定的软件包 URL。


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

- Debian apt - btrfs-progs - 6.14-1: normalized package name match | Debian stable package indexes: btrfs-progs from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Checksumming Copy on Write Filesystem utilities | http://btrfs.wiki.kernel.org/
- Debian apt - libbtrfs-dev - 6.14-1: normalized package name match | Debian stable package indexes: libbtrfs-dev from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Checksumming Copy on Write Filesystem utilities (development headers) | http://btrfs.wiki.kernel.org/
- Debian apt - libbtrfs0t64 - 6.14-1: normalized package name match | Debian stable package indexes: libbtrfs0t64 from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Checksumming Copy on Write Filesystem utilities (runtime library) | http://btrfs.wiki.kernel.org/
- Debian apt - libbtrfsutil-dev - 6.14-1: normalized package name match | Debian stable package indexes: libbtrfsutil-dev from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Checksumming Copy on Write Filesystem utilities (util development headers) | http://btrfs.wiki.kernel.org/
- Debian apt - libbtrfsutil1t64 - 6.14-1: normalized package name match | Debian stable package indexes: libbtrfsutil1t64 from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Checksumming Copy on Write Filesystem utilities (runtime util library) | http://btrfs.wiki.kernel.org/
- Debian apt - python3-btrfsutil - 6.14-1: normalized package name match | Debian stable package indexes: python3-btrfsutil from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Checksumming Copy on Write Filesystem utilities (python3 bindings) | http://btrfs.wiki.kernel.org/
- Nix - btrfs-progs: normalized package name match | nixpkgs package indexes: pkgs/by-name/bt/btrfs-progs/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Ubuntu apt - btrfs-progs - 6.6.3-1.1build2: normalized package name match | Ubuntu 24.04 LTS package indexes: btrfs-progs from https://archive.ubuntu.com/ubuntu/dists/noble/main/binary-amd64/Packages.gz | Checksumming Copy on Write Filesystem utilities | http://btrfs.wiki.kernel.org/
- Ubuntu apt - libbtrfs-dev - 6.6.3-1.1build2: normalized package name match | Ubuntu 24.04 LTS package indexes: libbtrfs-dev from https://archive.ubuntu.com/ubuntu/dists/noble/main/binary-amd64/Packages.gz | Checksumming Copy on Write Filesystem utilities (development headers) | http://btrfs.wiki.kernel.org/
- Ubuntu apt - libbtrfs0t64 - 6.6.3-1.1build2: normalized package name match | Ubuntu 24.04 LTS package indexes: libbtrfs0t64 from https://archive.ubuntu.com/ubuntu/dists/noble/main/binary-amd64/Packages.gz | Checksumming Copy on Write Filesystem utilities (runtime library) | http://btrfs.wiki.kernel.org/
- Ubuntu apt - libbtrfsutil-dev - 6.6.3-1.1build2: normalized package name match | Ubuntu 24.04 LTS package indexes: libbtrfsutil-dev from https://archive.ubuntu.com/ubuntu/dists/noble/main/binary-amd64/Packages.gz | Checksumming Copy on Write Filesystem utilities (util development headers) | http://btrfs.wiki.kernel.org/
- Ubuntu apt - libbtrfsutil1t64 - 6.6.3-1.1build2: normalized package name match | Ubuntu 24.04 LTS package indexes: libbtrfsutil1t64 from https://archive.ubuntu.com/ubuntu/dists/noble/main/binary-amd64/Packages.gz | Checksumming Copy on Write Filesystem utilities (runtime util library) | http://btrfs.wiki.kernel.org/
- Ubuntu apt - python3-btrfsutil - 6.6.3-1.1build2: normalized package name match | Ubuntu 24.04 LTS package indexes: python3-btrfsutil from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Checksumming Copy on Write Filesystem utilities (python3 bindings) | http://btrfs.wiki.kernel.org/
- apk - btrfs-progs - 6.17.1-r1: normalized package name match | Alpine Linux edge package indexes: btrfs-progs from https://dl-cdn.alpinelinux.org/alpine/edge/main/x86_64/APKINDEX.tar.gz | BTRFS filesystem utilities | https://btrfs.wiki.kernel.org
- apk - btrfs-progs-bash-completion - 6.17.1-r1: normalized package name match | Alpine Linux edge package indexes: btrfs-progs-bash-completion from https://dl-cdn.alpinelinux.org/alpine/edge/main/x86_64/APKINDEX.tar.gz | Bash completions for btrfs-progs | https://btrfs.wiki.kernel.org
- apk - btrfs-progs-dev - 6.17.1-r1: normalized package name match | Alpine Linux edge package indexes: btrfs-progs-dev from https://dl-cdn.alpinelinux.org/alpine/edge/main/x86_64/APKINDEX.tar.gz | BTRFS filesystem utilities (development files) | https://btrfs.wiki.kernel.org


## Combined YAML source

View the package source record on GitHub. [combined/btrfs-progs.yml](https://github.com/mxcl/pkgdb/blob/main/combined/btrfs-progs.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
