apt 安装，配置命令与 Debian 和 Ubuntu 完全相同：它从 /etc/os-release 读取 VERSION_CODENAME，并请求对应的套件，在 Raspberry Pi OS（Trixie） 上即为 trixie。
Raspberry Pi OS 是面向树莓派的 Debian，其软件源中的开发工具来自它所基于的 Debian 版本，并在该版本发布时冻结。上游项目很少为 ARM 发布 .deb 文件。deb.griffo.io 为下列大多数工具构建 arm64 软件包，其中许多还有 armhf 软件包，因此在树莓派上用普通的 apt 就能安装。
🔍 你的版本对应哪个套件
| 版本 | 基于 | 套件 | 可用工具 |
|---|---|---|---|
| Raspberry Pi OS（Trixie） | Debian 13 “Trixie” | trixie | 63 |
| Raspberry Pi OS（Bookworm） | Debian 12 “Bookworm” | bookworm | 61 |
运行 64 位 Raspberry Pi OS 的树莓派 3、4、5 或 Zero 2 W 使用 arm64，这是本仓库覆盖最广的架构。32 位镜像使用 armhf，为它构建的工具较少。运行 dpkg --print-architecture 即可查看你的架构。下表列出了每个架构可用的工具。
📦 添加仓库
步骤 1：添加仓库和密钥
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(. /etc/os-release; echo ${DEBIAN_CODENAME:-${UBUNTU_CODENAME:-$VERSION_CODENAME}}) main" | sudo tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
sudo apt updateinstall -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(. /etc/os-release; echo ${DEBIAN_CODENAME:-${UBUNTU_CODENAME:-$VERSION_CODENAME}}) main" | tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
apt update🆓 有一个永久免费的镜像。 deb-free.griffo.io 永久免费提供软件包 — 无需账号、无需订阅，最多落后上游 2 个月，安全修复立即发布。目前收录 cliamp、Ghostty、lazydocker、Oh My Posh、Uncloud 和 Zed；其他任何工具都可应请求加入。
步骤 2：安装任意工具
sudo apt install -y neovim ripgrep fzfapt install -y neovim ripgrep fzf运行之前，可以先查看命令在你的机器上会选择哪个套件：
. /etc/os-release; echo ${DEBIAN_CODENAME:-${UBUNTU_CODENAME:-$VERSION_CODENAME}}。
输出应当是上表中的某个套件。
📋 Raspberry Pi OS 上可用的全部工具
表中版本为仓库当前为 trixie 提供的版本（更新于 2026-10-19）。某个架构下打勾，表示该工具为此架构构建；各架构上的版本相同。
| 工具 | apt 软件包 | 版本 | arm64 | armhf |
|---|---|---|---|---|
| Atuin | atuin | 18.24.1-2~griffo | ✓ | ✗ |
| ble.sh | ble.sh | 0.4.0-git20260908.d81fd54-2~griffo | ✓ | ✓ |
| bottom | btm | 0.14.9-2~griffo | ✓ | ✓ |
| Bun | bun | 1.4.3-3~griffo | ✓ | ✗ |
| cliamp | cliamp | 2.3.0-2~griffo | ✓ | ✗ |
| Deno | deno | 2.9.7-3~griffo | ✓ | ✗ |
| difftastic | difftastic | 0.70.0-2~griffo | ✓ | ✗ |
| DuckDB | duckdb | 1.5.6-3~griffo | ✓ | ✗ |
| eza | eza | 0.23.5-3~griffo | ✓ | ✓ |
| Fastfetch | fastfetch | 2.66.0-3~griffo | ✓ | ✓ |
| fish | fish | 4.9.3-2~griffo | ✓ | ✗ |
| Forgejo | forgejo | 15.0.2-2~griffo | ✓ | ✓ |
| Forgejo Runner | forgejo-runner | 13.2.0-2~griffo | ✓ | ✗ |
| fresh-editor | fresh-editor | 0.5.3-2~griffo | ✓ | ✗ |
| fzf | fzf | 0.74.5-2~griffo | ✓ | ✓ |
| Garage | garage | 2.4.1-2~griffo | ✓ | ✓ |
| Ghostty | ghostty | 1.3.1-6~trixie | ✗ | ✗ |
| GitUI | gitui | 0.28.1-2~griffo | ✓ | ✓ |
| GPU Screen Recorder | gpu-screen-recorder-cli | 6.1.4-1~trixie | ✗ | ✗ |
| Headscale | headscale | 0.29.5-2~griffo | ✓ | ✗ |
| Helix | helix | 25.07.1-3~griffo | ✓ | ✗ |
| herdr | herdr | 0.9.5-2~griffo | ✓ | ✗ |
| Jujutsu | jujutsu | 0.46.0-2~griffo | ✓ | ✗ |
| just | just | 1.59.0-2~griffo | ✓ | ✓ |
| k9s | k9s | 0.51.0-2~griffo | ✓ | ✓ |
| kitty | kitty | 0.49.2-2~griffo | ✓ | ✗ |
| lazydocker | lazydocker | 0.25.2-2~griffo | ✓ | ✓ |
| lazygit | lazygit | 0.66.2-2~griffo | ✓ | ✓ |
| lazyjira | lazyjira | 2.19.2-2~griffo | ✓ | ✗ |
| lowfi | lowfi | 2.0.7-3~griffo | ✗ | ✗ |
| mitmproxy | mitmproxy | 12.2.3-3~griffo | ✓ | ✗ |
| Neovim | neovim | 0.12.6-2~griffo | ✗ | ✗ |
| Nushell | nushell | 0.116.1-2~griffo | ✓ | ✓ |
| Oh My Posh | oh-my-posh | 31.8.0-2~griffo | ✓ | ✓ |
| rclone | rclone | 1.75.2-2~griffo | ✓ | ✓ |
| restic | restic | 0.19.1-2~griffo | ✓ | ✓ |
| rgrc | rgrc | 0.6.35-2~griffo | ✓ | ✓ |
| ripgrep | ripgrep | 15.2.0-2~griffo | ✓ | ✓ |
| Ruff | ruff | 0.17.1-2~griffo | ✓ | ✓ |
| rumdl | rumdl | 0.3.0-2~griffo | ✓ | ✗ |
| Serie | serie | 0.10.0-2~griffo | ✓ | ✗ |
| Spotifast | spotifast | 0.13.3-2~griffo | ✓ | ✗ |
| Starship | starship | 1.27.0-2~griffo | ✓ | ✓ |
| superfile | superfile | 1.6.0-2~griffo | ✓ | ✗ |
| Television | television | 0.15.9-2~griffo | ✓ | ✗ |
| Termusic | termusic | 0.13.2-3~griffo | ✓ | ✗ |
| TigerBeetle | tigerbeetle | 0.17.9-2~griffo | ✓ | ✗ |
| tldr | tldr | 1.13.1-2~griffo | ✓ | ✗ |
| tree-sitter-cli | tree-sitter-cli | 0.27.1-2~griffo | ✓ | ✓ |
| Uncloud | uncloud | 0.21.0-2~griffo | ✓ | ✗ |
| Unregistry | unregistry | 0.4.3-2~griffo | ✓ | ✗ |
| uv | uv | 0.13.1-2~griffo | ✓ | ✓ |
| viu | viu | 1.6.1-3~griffo | ✓ | ✗ |
| workmux | workmux | 0.1.276-2~griffo | ✓ | ✗ |
| Yazi | yazi | 26.9.1-2~griffo | ✓ | ✗ |
| yq | yq | 4.54.1-2~griffo | ✓ | ✓ |
| yt-dlp | yt-dlp | 2026.08.19-2~griffo | ✓ | ✓ |
| ZapZap | zapzap | 7.5.1-2~griffo | ✓ | ✓ |
| Zed | zed | 1.24.3-1~griffo | ✓ | ✗ |
| Zellij | zellij | 0.45.1-2~griffo | ✓ | ✗ |
| Zig | zig-stable | 0.17.0-2~griffo | ✓ | ✗ |
| ZLS | zls | 0.16.1-2~griffo | ✓ | ✓ |
| zoxide | zoxide | 0.10.0-2~griffo | ✓ | ✓ |
❓ 常见问题
支持哪些树莓派型号？
任何运行 64 位 Raspberry Pi OS（arm64）的树莓派，包括 Pi 3、4、5、400、500 和 Zero 2 W。32 位镜像（armhf）同样可用，但仅限为 armhf 构建的工具。初代 Pi Zero 和 Pi 1 使用 armv6，这里没有任何软件包为其构建。
用 64 位还是 32 位的 Raspberry Pi OS 更好？
64 位。这里每个能在 ARM 上运行的工具都有 arm64 版本，而只有部分工具提供 armhf 版本。
deb.griffo.io 是 Raspberry Pi OS 的官方仓库吗？
不是。这是由 Dario Griffo 维护的非官方仓库，与 Raspberry Pi OS 没有任何关联。每个软件包都根据上游官方发布自动构建，打包代码在 GitHub 上开源，软件源经过 GPG 签名。
需要付费吗？
本仓库采用订阅制（每年 15 欧元，或一次性 150 欧元），并提供免费试用。另有免费镜像 deb-free.griffo.io，以一定延迟提供较少的工具，在这个发行版上的配置方式相同。
如何移除这个仓库？
删除 /etc/apt/sources.list.d/deb.griffo.io.list 和 /etc/apt/keyrings/deb.griffo.io.gpg，然后运行 sudo apt update。已经安装的工具会一直保留，直到你用 apt remove 卸载它们。