# 使用 Homebrew, apk, Nix 安装 zrepl

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

## 安装

```sh
sudo av install brew:zrepl
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install zrepl
```

  证据: local Homebrew formula metadata

### Linux

- apk (92%):

```sh
sudo apk add zrepl
```

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

- Nix (92%):

```sh
nix profile install nixpkgs#zrepl
```

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

## 软件包事实

- **软件包键:** brew:zrepl
- **软件包管理器:** Homebrew
- **版本:** 0.7.0
- **来源摘要:** One-stop ZFS backup & replication solution
- **主页:** <https://zrepl.github.io>
- **仓库:** <https://github.com/zrepl/zrepl>
- **最后更新:** 2026-07-25T21:50:59+02:00
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- zrepl (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

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

zrepl is a Go daemon and CLI for ZFS snapshot management, backup, and replication. It wraps ZFS send/receive workflows with configuration, scheduling, pruning, monitoring, status reporting, and transport handling.

### 项目历史

The public `zrepl/zrepl` repository was created in April 2017, and the documentation copyright identifies Christian Schwarz as the project author. The README and official site describe zrepl as a one-stop ZFS backup and replication solution, with user documentation published through Sphinx at zrepl.github.io.

zrepl developed around the hard parts of reliable ZFS replication rather than around a generic backup format. The documentation lists push and pull replication, TCP, TLS, and SSH transports, retries, resumable send/receive, ZFS holds, bookmarks, raw encrypted sends, properties/compressed/large-block sends, bandwidth limiting, periodic snapshots, pruning rules, structured logging, Prometheus metrics, and `zrepl status` progress reporting.

The changelog shows the project maturing through operational features: Prometheus metrics and receiver-side pruning behavior in early releases, automatic bookmark and hold management, configurable send/receive flags, bandwidth limiting, encrypted-send fixes, and later 0.6 and 0.7 maintenance releases.

### 采用历史

zrepl's audience is narrower than general backup tools because it requires ZFS, but it is significant inside that ecosystem. The official package documentation lists installation paths through GitHub release binaries, FreeBSD packages, Homebrew on macOS, Arch AUR, Fedora/RHEL/openSUSE RPM repositories, Debian/Ubuntu APT repositories, OmniOS, Void Linux, and source builds.

GitHub metadata showed more than 1,100 stars by mid-2026, consistent with an infrastructure tool used by ZFS administrators rather than casual desktop users. Its adoption is also reflected in docs that address distro maintainers, service files, platform tests that exercise ZFS, and package repository operations.

### 使用方式

Typical use is to write a YAML configuration at `/etc/zrepl/zrepl.yml`, validate it with `zrepl configcheck`, run zrepl as a daemon, and use `zrepl status` or `zrepl signal wakeup JOBNAME` to monitor or trigger work. The quick-start docs cover continuous server backup, local snapshots with offline external-disk backup, and fan-out replication.

zrepl is most useful when native ZFS snapshots and `zfs send` are already the desired backup primitive, but the operator wants automated policy, pruning, transport, monitoring, and safety checks around them.

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

zrepl is package-nerd significant because it is not another tar-like backup archive; it is packaging the operational discipline around ZFS itself. It turns a powerful but manual storage primitive into a service with config files, system packages, status UI, metrics, and reproducible deployment patterns.

It is also a good example of a small infrastructure package whose real value is coordination: snapshots, bookmarks, holds, pruning, send/receive flags, daemon supervision, and distro defaults all have to line up or backups quietly become unsafe.

### 时间线

- 2017-04-13: The public `zrepl/zrepl` repository is created.
- 2020-08-21: zrepl 0.3.0 is published on GitHub.
- 2021-04-18: zrepl 0.4.0 is published.
- 2022-01-09: zrepl 0.5.0 is published, with changelog entries including bandwidth limiting and send/receive-related fixes.
- 2022-11-01: zrepl 0.6.0 is published.
- 2026-02-15: zrepl 0.7.0 is published.

### Related projects

- OpenZFS is the underlying filesystem and send/receive substrate.
- syncoid and sanoid are adjacent ZFS snapshot and replication tools in the same administrator niche.
- Prometheus is relevant because zrepl exposes metrics for monitoring replication health.

### 来源

- <https://api.github.com/repos/zrepl/zrepl>
- <https://github.com/zrepl/zrepl>
- <https://zrepl.github.io/>
- <https://zrepl.github.io/changelog.html>
- <https://zrepl.github.io/installation/packages.html>
- <https://zrepl.github.io/quickstart.html>


## 安全说明

formula declares a Homebrew service. generalized runtime or code generation signal.

- **Geiger 风险:** orange / 中
- formula declares a Homebrew service
- generalized runtime or code generation signal


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: /etc/zrepl/zrepl.yml, /usr/local/etc/zrepl/zrepl.yml
## 其他软件包管理器记录

- Nix - zrepl: normalized package name match | nixpkgs package indexes: pkgs/by-name/zr/zrepl/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- apk - zrepl - 0.6.1-r22: normalized package name match | Alpine Linux edge package indexes: zrepl from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | one-stop, integrated solution for ZFS replication | https://zrepl.github.io/
- apk - zrepl-bash-completion - 0.6.1-r22: normalized package name match | Alpine Linux edge package indexes: zrepl-bash-completion from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Bash completions for zrepl | https://zrepl.github.io/
- apk - zrepl-openrc - 0.6.1-r22: normalized package name match | Alpine Linux edge package indexes: zrepl-openrc from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | one-stop, integrated solution for ZFS replication (OpenRC init scripts) | https://zrepl.github.io/
- apk - zrepl-zsh-completion - 0.6.1-r22: normalized package name match | Alpine Linux edge package indexes: zrepl-zsh-completion from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Zsh completions for zrepl | https://zrepl.github.io/


## Combined YAML source

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


## 来源

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