ВойтиПопробовать бесплатно
Разделы документации

Требования к серверу и подготовка

Что подготовить до запуска установщика: сервер, два домена, DNS-записи, порты и ключ лицензии.

Micator ставится на отдельный чистый сервер одной командой. До запуска подготовьте сервер, два домена с DNS-записями и ключ лицензии. Установщик сам проверяет сервер и останавливается с сообщением, если что-то не подходит.

Сервер

ТребованиеЗначениеСообщение установщика при нарушении
Операционная системаUbuntu 24.04«Поддерживается Ubuntu 24.04.»
Доступправа root: запуск через sudo или от пользователя root«Установку запускать через sudo.»
Архитектураamd64 (x86_64) — под неё собран опубликованный выпуск«Архитектура выпуска не совпадает с сервером.»
Процессорот 2 ядер«Нужно не менее 4 ГБ RAM и двух CPU.»
Памятьот 4 ГБ. Проверка проходит, если система видит не меньше 3500 МиБ«Нужно не менее 4 ГБ RAM и двух CPU.»
Дискот 20 ГБ свободного места на разделе, где лежит /opt/tracker«Нужно не менее 20 ГБ свободного места.»
systemdработает«Для установки нужен работающий systemd.»
Публичный IPv4есть. Установщик берёт его с сетевого интерфейса сервера«Не удалось определить публичный IPv4. Передайте --setup-ip IP сервера.»
Порты 80 и 443свободны: на сервере нет другого веб-сервера«Порт 80 занят.» или «Порт 443 занят.»
Каталог /opt/trackerотсутствует или пустой«Каталог не пуст; установка поверх существующих данных запрещена.»

В таблице приведены сообщения установки с мастером. При установке в терминале, без мастера, тексты о диске, портах и каталоге другие.

Сервер должен быть чистым. Если на нём уже есть контейнеры, тома или сети Docker от другой установки трекера, установщик остановится с сообщением «На сервере уже есть ресурсы tracker.»

Другие версии Ubuntu и другие дистрибутивы установщик не принимает.

Внимание.

Не запускайте установку на сервере, где уже работает трекер или другой сайт. Установщик рассчитан только на первую установку. Установленный трекер обновляется в панели: Настройки → Обновления, см. Обновление трекера из панели.

Домены и DNS

Нужны два разных домена или поддомена:

  • домен панели, например panel.example.com, — здесь вы управляете кампаниями и отчётами;
  • домен трекинга, например track.example.com, — этот адрес используется в ссылках и постбеках.

В мастере это поля Домен панели и Домен трекинга. Указать в них один и тот же домен нельзя: мастер ответит «Укажите два разных домена и email для сертификатов.»

Подготовьте домены до запуска:

  1. Создайте A-запись для домена панели на IP сервера, например 203.0.113.10.
  2. Создайте A-запись для домена трекинга на тот же IP.
  3. Подождите, пока записи обновятся.

Мастер проверяет каждый домен запросом по HTTP на порт 80. Ответить должен именно этот сервер, редиректы не выполняются. Все адреса домена в DNS должны быть публичными.

Домен вводится без https://, порта и пути. Международные имена пишутся в punycode. IP-адрес вместо домена не принимается.

Понадобится ещё почтовый адрес для поля Email для уведомлений — он нужен для уведомлений о HTTPS-сертификатах. Сертификаты для обоих доменов мастер выпускает сам.

Домены для ссылок кампаний добавляются после установки в разделе панели Домены, см. Домены.

Порты и сеть

  • Входящие TCP 80 и 443 должны быть доступны из интернета. Других портов трекер наружу не открывает.
  • Серверу нужен выход в интернет. Установщик загружает выпуск с install.micator.com, пакеты Ubuntu и Docker и базу GeoIP. Трекер выпускает HTTPS-сертификаты и подтверждает лицензию.

Установщик не настраивает ufw и не меняет правила доступа к SSH, 80 и 443. Если на сервере или у хостера включён firewall, откройте порты 80 и 443 сами до запуска.

Мастер открывается по адресу http://203.0.113.10/setup/, поэтому серверу нужен публичный IPv4. Если установщик не определил адрес сам, передайте его параметром --setup-ip:

bash
sudo bash install.sh --setup-ip 203.0.113.10

Остальные параметры — на странице Параметры install.sh и установка в терминале.

Cloudflare

Мастер проверяет домен по HTTP на порт 80 и не следует редиректам. Если прокси перед сервером перенаправляет HTTP на HTTPS, проверка не пройдёт.

  • На время настройки включите для обоих доменов режим «Только DNS» — проксирование выключено.
  • Если проксирование нужно сразу, выберите режим шифрования Full (strict) и до конца настройки отключите перенаправление HTTP на HTTPS (опция Always Use HTTPS). Режим Flexible не подходит.

Сообщения мастера, которые указывают на прокси:

  • «Домен panel.example.com пока не ведёт на этот сервер. Проверьте A/AAAA-записи, порт 80 и редиректы прокси, затем повторите.» — запрос по порту 80 не дошёл до сервера или был перенаправлен.
  • «HTTPS пока не готов. Проверьте DNS, порты 80/443 и режим Full (strict) в Cloudflare, затем повторите.» — сертификаты не выпустились за отведённое время.

Что установщик ставит сам

Заранее ставить ничего не нужно.

  • python3, curl и openssl — если их нет.
  • Docker — если его нет, из официального репозитория Docker.
  • Docker Compose — если Docker уже стоит, а Compose отсутствует или старше 2.33.1. Установленный Docker при этом не заменяется. Если нужную версию поставить не удалось, установка остановится с сообщением «Нужен Docker Compose 2.33.1 или новее; проверьте установленные CLI-плагины.»
  • Базу GeoIP, службу обновлений и команду проверки trackerctl.

Образы трекера входят в выпуск. Перед установкой проверяются подпись выпуска и целостность файлов. Список файлов, служб и портов — на странице Файлы установки, порты, службы и журналы.

Ключ лицензии

Для работы панели нужен ключ лицензии. Получите его в личном кабинете до установки. Ключ имеет вид XXXX-XXXX-XXXX-XXXX.

Ключ вводится в мастере на шаге 2: блок Лицензия, поле Ключ лицензии. Если блок помечен «Для доступа к панели», без ключа форма не отправится. При установке в терминале ключ вводится после первого входа в панель.

Без активной лицензии панель закрыта: владелец после входа видит экран «Доступ к трекеру закрыт» с полем Ключ лицензии и кнопкой Активировать. Трафик при этом продолжает работать. Как получить пробный ключ — на странице Получение ключа и активация.

Проверка перед запуском

  • Сервер с Ubuntu 24.04, от 2 CPU, 4 ГБ памяти и 20 ГБ свободного места, есть root-доступ.
  • На сервере нет веб-сервера и другой установки трекера.
  • Порты 80 и 443 открыты для входящих соединений.
  • Два разных домена направлены A-записями на IP сервера.
  • Есть почтовый адрес для уведомлений о сертификатах.
  • Ключ лицензии получен в личном кабинете.

Когда всё готово, переходите к установке. Если установщик остановился с сообщением, найдите его на странице Ошибки установки и их устранение.

Обновлено Нужна помощь? ↗