Bedrud Документация

Установка одной командой для всех платформ. Без sudo — устанавливается в домашнюю директорию.

Для настройки сервера после установки см. Быстрый старт. Для пакетных менеджеров, Docker и других способов см. Установка сервера.


Что делает установщик

  1. Определяет ОС, архитектуру процессора и варианты платформы (Rosetta 2)
  2. Загружает нужный бинарный файл из GitHub Releases
  3. Устанавливает в ~/bin (настраивается через --install-dir)
  4. Добавляет директорию установки в PATH через конфигурацию оболочки
  5. Запускает bedrud completions для автодополнения команд в оболочке
  6. Выводит следующие шаги

Требования

ПлатформаЗависимости
macOS / Linuxcurl + tar
WindowsPowerShell 5.1+ (встроен в Windows 10/11)

Быстрая установка

curl -fsSL https://get.bedrud.org | bash

Перезагрузите оболочку, затем проверьте:

source ~/.bashrc  # или ~/.zshrc
bedrud --version
irm https://get.bedrud.org/install.ps1 | iex
bedrud --version

Флаги и параметры

Установщик Bash

Использование: curl -fsSL https://get.bedrud.org | bash -s -- [параметры]
ФлагПо умолчаниюОписание
--install-dir <dir>~/binКуда поместить бинарный файл
--version <ver>latestЗафиксировать версию (напр. v1.2.0)
--skip-shellвыкл.Не изменять RC-файлы оболочки и PATH
-h, --helpВывести справку и выйти

Примеры:

# По умолчанию
curl -fsSL https://get.bedrud.org | bash
 
# Фиксация версии
curl -fsSL https://get.bedrud.org | bash -s -- --version v1.2.0
 
# Установка для всей системы
curl -fsSL https://get.bedrud.org | sudo bash -s -- --install-dir /usr/local/bin
 
# CI / автоматизация — без настройки оболочки
curl -fsSL https://get.bedrud.org | bash -s -- --skip-shell

Установщик PowerShell

Использование: irm https://get.bedrud.org/install.ps1 | iex

Для передачи параметров сохраните файл сначала:

irm https://get.bedrud.org/install.ps1 -OutFile install.ps1
.\install.ps1 -Version v1.2.0 -InstallDir C:\Tools
ПараметрПо умолчаниюОписание
-InstallDir <path>$HOME\binКуда поместить bedrud.exe
-Version <ver>latestУстановить конкретную версию
-SkipPath$falseНе добавлять директорию установки в PATH пользователя

Переменные окружения

ПеременнаяПо умолчаниюПлатформыОписание
BEDRUD_INSTALL~/binТолько BashПереопределить директорию установки (аналог --install-dir)
BEDRUD_REPObedrud-ir/bedrudОбеПереопределить GitHub-репозиторий (для форков или зеркал)
BEDRUD_INSTALL=/opt/bedrud curl -fsSL https://get.bedrud.org | bash
BEDRUD_REPO=myorg/bedrud-fork curl -fsSL https://get.bedrud.org | bash
$env:BEDRUD_REPO = "myorg/bedrud-fork"
irm https://get.bedrud.org/install.ps1 | iex

Поддерживаемые платформы

Целевая платформаОСАрхитектураПримечания
darwin_amd64macOSIntel (x86_64)Стандартная
darwin_arm64macOSApple Silicon (M1/M2/M3/M4)Rosetta 2 определяется автоматически
linux_amd64Linuxx86_64Стандартная
linux_arm64LinuxARM64Стандартная
freebsd_amd64FreeBSDx86_64Стандартная
windows_amd64Windowsx86_64Стандартная
windows_arm64WindowsARM64Стандартная
Логика определения ОС и архитектуры
uname -s → "Darwin"  → darwin
           "Linux"   → linux
           "FreeBSD" → freebsd
           "MINGW*"  → перенаправление на PowerShell-скрипт
           "MSYS*"   → перенаправление на PowerShell-скрипт

uname -m → "x86_64" | "amd64"  → amd64
           "aarch64" | "arm64"  → arm64

Определение особых случаев

Rosetta 2 (macOS Intel на Apple Silicon)

Определение: sysctl -n sysctl.proc_translated возвращает 1. Действие: Переключает darwin_amd64darwin_arm64 для нативной производительности ARM.


Порядок установки

  1. Проверка Windows — обнаружен MINGW/MSYS/CYGWIN? Вывести команду PowerShell, выйти
  2. Проверка зависимостей — требуются curl + tar
  3. Разбор аргументов — до 3 флагов
  4. Определение платформы — ОС + архитектура через uname
  5. Определение варианта — Rosetta 2
  6. Загрузка — загрузка bedrud_{TARGET}.tar.xz
  7. Распаковка и установка — временная директория, распаковка, mv → $INSTALL_DIR/bedrud, chmod +x
  8. Проверка — запуск bedrud --version
  9. Проверка PATH — уже в PATH? Пропустить. --skip-shell? Вывести команду вручную. Иначе → изменить RC-файл
  10. Автодополнение — запуск bedrud completions
  11. Готово — вывод сообщения об успехе + инструкции по перезагрузке

Формат URL загрузки: github.com/{repo}/releases/{ver}/bedrud_{TARGET}.tar.xz


PATH и конфигурация оболочки

Когда --skip-shell не установлен, установщик добавляет директорию установки в ваш PATH.

ОболочкаRC-файл
fish~/.config/fish/config.fish
zsh$ZDOTDIR/.zshrc (по умолчанию ~/.zshrc)
bash (macOS)~/.bash_profile, затем ~/.bashrc
bash (Linux)~/.bashrc, затем ~/.bash_profile

Что добавляется:

# bedrud
export PATH="$HOME/bin:$PATH"  # bedrud

Маркер комментария # bedrud предотвращает дублирование записей — безопасно запускать повторно.

Windows: Использует [Environment]::SetEnvironmentVariable("PATH", ..., "User") на уровне реестра. RC-файл не требуется.

Перезагрузите оболочку после установки:

source ~/.bashrc    # bash
source ~/.zshrc     # zsh
source ~/.config/fish/config.fish  # fish

Автономная установка / Изолированные сети

Загрузка и перенос

curl -fsSL -o bedrud.tar.xz \
  https://github.com/bedrud-ir/bedrud/releases/latest/download/bedrud_linux_amd64.tar.xz
scp bedrud.tar.xz airgapped-server:/tmp/
# На целевом сервере:
tar -xf /tmp/bedrud.tar.xz -C /tmp/bedrud-extracted
mv /tmp/bedrud-extracted/bedrud ~/bin/
chmod +x ~/bin/bedrud

Собственное зеркало

BEDRUD_REPO=mycompany/bedrud-mirror curl -fsSL https://get.bedrud.org | bash

Прямая загрузка бинарного файла

Загрузите из Releases, распакуйте, переместите в директорию в вашем PATH.


Удаление

rm ~/bin/bedrud
# Удалите строку PATH из RC-файла оболочки (найдите "# bedrud"):
#   ~/.bashrc, ~/.bash_profile, ~/.zshrc, ~/.config/fish/config.fish

Для установки сервера через systemd:

sudo bedrud uninstall

Windows:

Remove-Item "$env:USERPROFILE\bin\bedrud.exe"
# Удалите из PATH через Свойства системы → Переменные среды

Устранение неполадок

command not found: bedrud

source ~/.bashrc    # перезагрузить оболочку
echo $PATH | tr ':' '\n' | grep "$HOME/bin"  # проверить PATH

Если отсутствует:

echo 'export PATH="$HOME/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Failed to download bedrud

  1. Проверьте подключение к интернету
  2. Убедитесь, что целевая платформа есть в Releases
  3. Попробуйте конкретную версию: --version v1.0.0
  4. Для вашей платформы может ещё не быть готового бинарного файла

macOS: выполняется x64 под Rosetta (медленно)

Принудительный запуск в нативном ARM:

arch -arm64 curl -fsSL https://get.bedrud.org | arch -arm64 bash

Windows: “running scripts is disabled”

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
irm https://get.bedrud.org/install.ps1 | iex