Начало работы

Скачайте готовую сборку со страницы 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 и добавляет её в файл запуска вашей оболочки. Закончив, установщик запускает 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. Они используют sudo, если вы не root. Без терминала и без переменной установщик не трогает службу. Настроить её можно позже в самом 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 без этих программ, задайте 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 выводит установленную версию. Открытые сеансы переходят на новую версию и сохраняют свои оболочки (см. Обновление при открытых сеансах).

Раз в день Borg проверяет, вышла ли новая версия. Если вышла, Borg предложит её, когда на экране панели и вы 2 секунды не трогаете клавиатуру и мышь. Enter запускает borg update в оболочке Borg или команду Homebrew либо cargo, если Borg установлен через них. S пропускает эту версию, и Borg предложит следующую, когда она выйдет. Esc закрывает предложение, и Borg спросит снова через день. N отключает ежедневную проверку, задавая update-check = false в конфигурации, а update-check = true включает её снова. Время последней проверки и пропущенную версию Borg хранит в файле update-check в своей папке состояния.