# 使用 Homebrew, apk, chocolatey, apt, dnf, MacPorts, pacman, zypper, scoop 安装 git-annex

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

## 安装

```sh
sudo av install brew:git-annex
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install git-annex
```

  证据: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install git-annex
```

  证据: MacPorts ports tree: devel/git-annex/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- apk (92%):

```sh
sudo apk add git-annex
```

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

- Debian apt (92%):

```sh
sudo apt install git-annex
```

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

- dnf (92%):

```sh
sudo dnf install git-annex
```

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

- pacman (92%):

```sh
sudo pacman -S git-annex
```

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

- zypper (92%):

```sh
sudo zypper install git-annex
```

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

### Windows

- Chocolatey (92%):

```sh
choco install git-annex
```

  证据: Chocolatey community package catalog: git-annex from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='11','fusioninventory-agent'

- Scoop (92%):

```sh
scoop install main/git-annex
```

  证据: Scoop official bucket manifest trees: bucket/git-annex.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1

## 软件包事实

- **软件包键:** brew:git-annex
- **软件包管理器:** Homebrew
- **版本:** 10.20260717
- **来源摘要:** Manage files with git without checking in file contents
- **主页:** <https://git-annex.branchable.com/>
- **最后更新:** 2026-07-22T05:59:28Z
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- git-annex (别名)
- git-annex-shell (别名)
- git-remote-annex (别名)
- git-remote-tor-annex (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

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

git-annex is a distributed data-management tool that lets Git track file names, directory history, and metadata while keeping large file contents outside normal Git objects.

### 项目历史

The project grew around Joey Hess's idea of combining Git's distributed history with a key-value store for file contents. Its manual describes the core model: annexed files become versioned links, while content is stored under .git/annex/objects and can be fetched, copied, moved, or dropped between repositories.

The project broadened beyond a command-line annexer into a larger system with assistant workflows, preferred content, encryption, content verification, and many special remotes. A Kickstarter-backed development year funded concentrated work on the git-annex assistant, after which Joey continued development notes on the project devblog.

The release stream and project wiki show a long-lived maintenance culture: features such as git-remote-annex, clusters, new hash backends, and special-remote improvements were documented through the same site used for manual pages, installation instructions, forums, and news.

### 采用历史

git-annex became important in communities that need reproducible paths and Git metadata without putting large data into Git itself. The official install page lists packaging across Debian, Ubuntu, Fedora, Arch, Alpine, NixOS, Gentoo, Guix, Void, openSUSE, Homebrew, FreeBSD, OpenBSD, Android, Windows, conda, and PyPI.

Its ecosystem significance comes from special remotes and related tools. The project documents built-in remotes for S3, rsync, WebDAV, git-lfs, borg, bittorrent, tor, web, and rclone, and its devblog describes scientific users and DataLad-related work around storing Git repositories on annex special remotes.

### 使用方式

Practitioners use git-annex to keep large assets, media, archives, datasets, backups, and offline drives under a versioned tree. A typical workflow initializes a Git repository, runs git annex init, adds large files with git annex add, commits the symlinks or pointer files to Git, and transfers content with get, drop, copy, move, sync, fsck, and special-remote commands.

The tool is also used as a policy engine for storage availability. Users can set numcopies and preferred content rules, encrypt remotes, verify checksums, keep drives offline, and later ask git-annex where content lives or move it to a desired repository.

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

git-annex matters to package people because it sits at the intersection of Git, Haskell packaging, external data stores, and reproducible archival workflows. It has many executables, many optional integrations, and many platform-specific packages, so distributions treat it as a substantial data-management package rather than a tiny Git extension.

### 时间线

- 2012: Public testimonials and the assistant campaign documented wider interest in Git-backed large-file workflows.
- 2012: The assistant work was funded through a Kickstarter-backed development year.
- 2025: The devblog described Distribits, scientific users, DataLad-related work, and git-remote-annex.
- 2026: Version 10.20260624 documented new hash-backend build flags, git-remote behavior improvements, and a new put command.

### Related projects

- Related systems include Git LFS, DataLad, rclone, borg, bup, rsync, S3-compatible storage, WebDAV storage, and provider-specific special remotes listed by the git-annex project.

### 来源

- <https://git-annex.branchable.com/>
- <https://git-annex.branchable.com/design/assistant/blog/>
- <https://git-annex.branchable.com/devblog/>
- <https://git-annex.branchable.com/git-annex>
- <https://git-annex.branchable.com/install/>
- <https://git-annex.branchable.com/news/>
- <https://git-annex.branchable.com/special_remotes/>
- <https://git-annex.branchable.com/walkthrough/>


## 安全说明

formula declares a Homebrew service.

- **Geiger 风险:** orange / 中
- formula declares a Homebrew service


## 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: .git/config, ~/.config/git-annex/autostart
## 其他软件包管理器记录

- Debian apt - git-annex - 10.20250416-2: normalized package name match | Debian stable package indexes: git-annex from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | manage files with git, without checking their contents into git | http://git-annex.branchable.com/
- Ubuntu apt - git-annex - 10.20240129-1build1: normalized package name match | Ubuntu 24.04 LTS package indexes: git-annex from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | manage files with git, without checking their contents into git | http://git-annex.branchable.com/
- apk - git-annex - 10.20260717-r0: normalized package name match | Alpine Linux edge package indexes: git-annex from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Manage files with git, without checking their contents into git | http://git-annex.branchable.com
- apk - git-annex-bash-completion - 10.20260717-r0: normalized package name match | Alpine Linux edge package indexes: git-annex-bash-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Bash completions for git-annex | http://git-annex.branchable.com
- apk - git-annex-doc - 10.20260717-r0: normalized package name match | Alpine Linux edge package indexes: git-annex-doc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Manage files with git, without checking their contents into git (documentation) | http://git-annex.branchable.com
- apk - git-annex-fish-completion - 10.20260717-r0: normalized package name match | Alpine Linux edge package indexes: git-annex-fish-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Fish completions for git-annex | http://git-annex.branchable.com
- apk - git-annex-zsh-completion - 10.20260717-r0: normalized package name match | Alpine Linux edge package indexes: git-annex-zsh-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Zsh completions for git-annex | http://git-annex.branchable.com
- dnf - git-annex - 10.20260601-2.fc45: normalized package name match | Fedora Rawhide package metadata: git-annex from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-primary.xml.zst | Manage files with git, without checking their contents into git | https://hackage.haskell.org/package/git-annex
- pacman - git-annex - 10.20251215-116: normalized package name match | Arch Linux sync databases: git-annex from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | Manage files with git, without checking their contents into git | https://git-annex.branchable.com/
- zypper - git-annex - 10.20260624-1.3: normalized package name match | openSUSE Tumbleweed package metadata: git-annex from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | Manage files with git, without checking their contents into git | https://hackage.haskell.org/package/git-annex
- zypper - git-annex-bash-completion - 10.20260624-1.3: normalized package name match | openSUSE Tumbleweed package metadata: git-annex-bash-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | Bash completion for git-annex | https://hackage.haskell.org/package/git-annex
- MacPorts - git-annex: normalized package name match | MacPorts ports tree: devel/git-annex/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1
- Chocolatey - git-annex: normalized package name match | Chocolatey community package catalog: git-annex from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='11','fusioninventory-agent'
- Scoop - main/git-annex: normalized package name match | Scoop official bucket manifest trees: bucket/git-annex.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1


## Combined YAML source

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