apt 安装，配置命令与 Debian 和 Ubuntu 完全相同：它从 /etc/os-release 读取 VERSION_CODENAME，并请求对应的套件，在 Proxmox VE 9 上即为 trixie。
Proxmox VE 运行在 Debian 之上，其主机通常以 root 身份通过 SSH 管理，手头只有 Debian 软件源里的那些工具。deb.griffo.io 以普通的、经过签名的 apt 软件包形式，为 Proxmox VE 所基于的 Debian 版本提供让这类工作更轻松的命令行工具的最新版本，例如 ripgrep、fzf、bottom、lazydocker 和 neovim。
🔍 你的版本对应哪个套件
| 版本 | 基于 | 套件 | 可用工具 |
|---|---|---|---|
| Proxmox VE 9 | Debian 13 “Trixie” | trixie | 63 |
| Proxmox VE 8 | Debian 12 “Bookworm” | bookworm | 61 |
主机的 /etc/os-release 中带有 Debian 代号，因此配置命令在 Proxmox VE 9 上解析为 trixie，在 Proxmox VE 8 上解析为 bookworm。下面的命令带有以 root 运行切换，因为 Proxmox 的 shell 通常就是这样运行的。
添加本仓库不会改动 Proxmox 或 Debian 的仓库，这里也没有任何软件包会替换 Proxmox 所依赖的软件包。每个软件包都是独立的工具。
📦 添加仓库
步骤 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}}。
输出应当是上表中的某个套件。
📋 Proxmox VE 上可用的全部工具
表中版本为仓库当前为 trixie 提供的版本（更新于 2026-10-19）。只要工具为较旧的版本构建，它们得到的也是同一个版本；最后一列标明了是哪些工具。
| 工具 | apt 软件包 | 版本 | Proxmox VE 8 |
|---|---|---|---|
| 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 | ✓ |
❓ 常见问题
在 Proxmox 主机上添加第三方仓库安全吗？
本仓库只提供独立的命令行工具，Proxmox VE 和 Debian 都不以相同名称提供更新的版本，因此 apt 永远不会用这里的软件包替换 Proxmox 或 Debian 的软件包。软件源经过 GPG 签名，并且通过 signed-by 把密钥限定在本仓库上。
可以在 Proxmox 上的 LXC 容器和虚拟机里使用吗？
可以。容器或虚拟机运行的是它自己的 Debian 或 Ubuntu，所以在其中用同样的方式添加仓库即可；配置命令会根据客户机运行的版本选择套件。
deb.griffo.io 是 Proxmox VE 的官方仓库吗？
不是。这是由 Dario Griffo 维护的非官方仓库，与 Proxmox VE 没有任何关联。每个软件包都根据上游官方发布自动构建，打包代码在 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 卸载它们。