开始使用

可以从 GitHub Releases 下载二进制文件，也可以运行安装脚本。安装脚本支持 macOS 和 Linux，Intel 与 ARM 架构均可：

curl -fsSL https://raw.githubusercontent.com/0xcd21h/borg-commander/main/scripts/install.sh | sh

安装脚本会校验压缩包的校验和，并把 borg 放到 PATH 中的某个文件夹里，因此在同一个终端中就能直接运行。如果 ~/.local/bin 已在 PATH 中，就选用它；否则，如果 /usr/local/bin 可写（例如在容器中以 root 身份运行），就选用它；都不满足时，则使用 ~/.local/bin，并将其添加到 Shell 的启动文件中。安装完成后会自动启动 borg；设置 BORG_NO_RUN=1 可跳过这一步，设置 BORG_INSTALL_DIR 可指定安装文件夹。如果已经安装了相同版本，再次运行安装脚本时会跳过下载。

安装脚本还可以把 borg 设置为开机启动的服务。这项服务是可选的。有了它，用 borg service keep NAME 保留的会话在没有终端时也会继续运行，已配对的计算机在本机重启后仍能连接到它。在终端中，安装脚本会在启动 borg 之前询问一次，默认回答为 n。设置 BORG_SERVICE=1 可不经询问直接设置服务，适合无人值守的安装；设置 BORG_SERVICE=0 则跳过询问。设置过程会运行 borg service install、enable 和 start，除非你是 root，否则它们会使用 sudo。既没有终端也没有设置该变量时，安装脚本不会改动服务。以后可以在 borg 中通过 F9 → 远程 → 后台服务… 来设置。在没有 systemd 或 launchd 的环境中（大多数容器都是如此），安装脚本会跳过这一步并说明原因。如果设置失败，borg 仍然保持已安装状态，安装脚本会给出需要手动完成的命令。在 Linux 上，监视器的 root 部分仍是单独的一步：需要时用 borg service watch install 安装。

从源码构建需要 Rust 1.97 或更高版本：

cargo install --locked --git https://github.com/0xcd21h/borg-commander borg-app

在 Linux 上，构建还会编译进程监视器的 eBPF 程序，它们需要 nightly 编译器和 bpf-linker。缺少它们时，构建会停下并打印 安装它们的两条命令。要在不带这些程序的情况下构建，请设置 BORG_NO_EBPF=1，监视器随后会改为接收内核的进程事件：

BORG_NO_EBPF=1 cargo install --locked --git https://github.com/0xcd21h/borg-commander borg-app

Homebrew 支持已经就绪，tap 发布后即可使用：

brew install 0xcd21h/tap/borg-commander

在要浏览的文件夹中运行 borg。按 F10 退出，按 Ctrl-O 从控制台切回面板。如果是下载安装的，运行 borg update 即可更新；如果是通过 Homebrew 或 cargo 安装的，请用相应的工具更新。只有带有项目签名的版本，Borg 才会安装；签名缺失或不匹配时，现有的程序保持不变。borg --version 会显示已安装的版本。打开的会话会切换到新版本，并保留各自的 Shell（参见在会话打开时更新）。

Borg 每天检查一次新版本。有新版本时，Borg 会在面板显示、且你已有 2 秒没有操作键盘或鼠标时提示更新。按 Enter 会在 Borg 的 Shell 中运行 borg update；如果 Borg 是通过 Homebrew 或 cargo 安装的，则运行相应工具的命令。按 S 会跳过该版本，等下一个版本发布后 Borg 再提示。按 Esc 会关闭提示，Borg 会在一天后再次询问。按 N 会在配置中设置 update-check = false，从而关闭每日检查；改为 update-check = true 可重新开启。Borg 把上次检查的时间和你跳过的版本保存在状态文件夹中的 update-check 文件里。