Посібник зі встановлення
Покрокові інструкції зі встановлення сервера Xcellerate RMM за допомогою Docker Compose.
Огляд
Найшвидший спосіб розгорнути Xcellerate RMM — за допомогою Docker Compose. Цей посібник проведе вас через весь процес — від підготовки хоста до перевірки працюючого сервера. Якщо ви надаєте перевагу встановленню на bare-metal, зверніться до розширених приміток зі встановлення в кінці.
Ключові поняття
- Стек Docker Compose — сервер постачається як набір контейнерів: веб-інтерфейс, API, фонові процеси, PostgreSQL та Redis.
- Файл середовища (.env) — єдиний файл, що містить усі налаштування: облікові дані бази даних, параметри TLS, SMTP-реле та ліцензійний ключ.
- Томи даних — постійні томи Docker для бази даних та завантажених файлів, що забезпечують збереження даних при перезапуску контейнерів.
Покрокове встановлення
Підготуйте хост
Встановіть Docker та Docker Compose на вашому сервері. На Ubuntu: sudo apt update && sudo apt install -y docker.io docker-compose-v2. Потім додайте вашого користувача до групи docker: sudo usermod -aG docker $USER і вийдіть/зайдіть знову.
Завантажте пакет Xcellerate
Клонуйте репозиторій розгортання: git clone https://github.com/rmmlabs/xcellerate-rmm.git && cd xcellerate-rmm. Він містить docker-compose.yml та зразковий файл .env.example.
Налаштуйте змінні середовища
Скопіюйте зразковий файл: cp .env.example .env. Відкрийте .env у вашому редакторі та встановіть як мінімум: SERVER_HOSTNAME, DB_PASSWORD та ADMIN_EMAIL. Файл добре задокументований — кожна змінна пояснює своє призначення.
Запустіть стек
Виконайте docker compose up -d. Docker завантажить образи (~1.2 ГБ при першому запуску), створить томи та запустить усі сервіси. Процес зазвичай займає 2–4 хвилини.
Перевірте встановлення
Відкрийте https://i.ytimg.com/vi/gohX9xNak4k/maxresdefault.jpg у браузері. Ви повинні побачити екран входу Xcellerate RMM. Якщо використовується самопідписаний сертифікат, браузер покаже попередження безпеки — це очікувано.
Увімкнення TLS за допомогою Let's Encrypt
Для продакшн-середовища увімкніть автоматичний TLS. Встановіть TLS_MODE=letsencrypt та [email protected] у вашому файлі .env, потім перезапустіть стек. Вбудований зворотний проксі отримає та оновить сертифікати автоматично.
# .env excerpt
SERVER_HOSTNAME=rmm.yourcompany.com
TLS_MODE=letsencrypt
[email protected]Поради та найкращі практики
- Завжди використовуйте повне доменне ім'я (FQDN) для
SERVER_HOSTNAME— агенти покладаються на нього для з'єднання. - Встановіть надійний, унікальний
DB_PASSWORD. Уникайте спеціальних символів, які можуть потребувати екранування в контексті оболонки. - Зберігайте резервну копію файлу
.envокремо — він містить облікові дані бази даних та ліцензійний ключ. - Заплануйте автоматичне оновлення Docker-образів за допомогою cron або Watchtower, щоб залишатися на останніх версіях патчів.