Руководство по установке и релизные сборки

RUSEON Core распространяется в виде официальных Docker-контейнеров и предварительно скомпилированных автономных бинарных файлов для Linux (amd64/arm64), Windows и macOS.

---

1. Установка через Docker (Рекомендуемый способ)

Docker обеспечивает быструю и изолированную установку:

# Загрузка официального образа
docker pull ghcr.io/rusegal/ruseon-core:latest

# Запуск контейнера с монтированием персистентных томов
docker run -d \
  --name ruseon \
  --restart unless-stopped \
  -p 8080:8080 \
  -p 8554:8554 \
  -p 50000-50100:50000-50100/udp \
  -v /var/lib/ruseon/data:/app/data \
  -v /var/lib/ruseon/recordings:/app/recordings \
  ghcr.io/rusegal/ruseon-core:latest

---

2. Готовые скомпилированные бинарные файлы

Скачайте релизные архивы со страницы GitHub Releases:

Linux (AMD64 и ARM64)

# Загрузка архива (пример для Linux AMD64)
curl -L -o ruseon https://github.com/rusegal/ruseon-core/releases/latest/download/ruseon_linux_amd64.tar.gz
tar -xzf ruseon_linux_amd64.tar.gz

# Перемещение в системный путь и установка прав
sudo mv ruseon /usr/local/bin/ruseon
sudo chmod +x /usr/local/bin/ruseon

# Проверка версии
ruseon -version

Windows (AMD64)

1. Скачайте архив ruseon_windows_amd64.zip из раздела Releases.
2. Распакуйте в каталог C:\Program Files\RUSEON\.
3. Запустите ruseon.exe или настройте запуск службы Windows через NSSM.

---

3. Сборка из исходного кода

Для самостоятельной сборки актуальной версии из исходников:

Требования:

• Go: версия 1.26+
• Node.js: версия 22+ и npm (для сборки встроенного интерфейса React 19)

Команды сборки:

# Клонирование репозитория
git clone https://github.com/rusegal/ruseon-core.git
cd ruseon-core

# 1. Сборка встроенного веб-интерфейса на React 19
cd web
npm install
npm run build
cd ..

# 2. Компиляция сервера Go с внедрением собранных ассетов
go build -ldflags="-s -w -X main.Version=$(git describe --tags --always)" -o bin/ruseon ./cmd/ruseon

# 3. Компиляция утилиты CLI
go build -ldflags="-s -w" -o bin/ruseon-cli ./cmd/ruseon-cli

---

Проверка работоспособности установки

# Проверка версии
./bin/ruseon -version

# Запуск сервера с примером конфигурации
./bin/ruseon -config config.example.yaml

Проверка ответа системной пробы:

curl http://localhost:8080/livez
# Ответ: {"status":"healthy"}

Связанная документация

• Руководство по быстрому старту
• Системные требования
• Развёртывание через Docker Compose
• Настройка сервиса Linux systemd