Мастер первого запуска

Мастер открывается в браузере после того, как установщик закончил работу в терминале. В нём три шага: Домены, Доступ, Запуск. Понадобятся два разных домена с DNS-записями на IP сервера, email, код доступа из терминала и, если мастер его требует, ключ лицензии — см. Требования к серверу и подготовка.

Вход по IP и код доступа

В конце работы установщик печатает адрес мастера http://203.0.113.10/setup/ и ссылку с кодом вида http://203.0.113.10/setup/#key=…. Ссылка и код также сохранены на сервере в файле /opt/tracker/setup-access.txt, его читает только root. Если при установке задан другой каталог параметром --path, файл лежит в нём.

Откройте в браузере ссылку с кодом — мастер сразу покажет шаг 1.

Если открыт адрес без кода, появится экран «Настроим ваш сервер»:

1. Вставьте код в поле Код доступа.
2. Нажмите Открыть мастер.

Шаг 1: домены и HTTPS

Экран «Подключите домены». У панели и у ссылок для трафика отдельные адреса. DNS-записи обоих доменов должны вести на IP этого сервера до начала проверки.

1. Заполните три поля.
2. Нажмите Проверить и продолжить.
3. Дождитесь окончания проверки на экране «Подключаем домены». Статус меняется по порядку: «Проверяем домены», «Включаем HTTPS».

Сначала мастер проверяет, что оба домена отвечают с этого сервера по порту 80. Затем выпускает HTTPS-сертификаты для обоих доменов. Выпуск может занять несколько минут.

После проверки браузер сам откроет мастер на защищённом адресе https://panel.example.com/setup/. Код доступа вводить заново не нужно. Логин и пароль владельца задаются только на этой защищённой странице.

Шаг 2: команда и логотип

Экран «Ваша команда» с отметкой «HTTPS включён».

1. Введите Название команды — от 1 до 80 символов. Оно станет названием рабочего пространства в трекере.
2. При желании выберите файл в поле Логотип команды. Подходят PNG, JPG и WebP до 2 МБ и до 16 мегапикселей.

Мастер впишет изображение без искажения в размер надписи Micator — 270 × 57 пикселей — и покажет результат над полем. Панель тёмная, поэтому выбирайте горизонтальный логотип с прозрачным фоном. Кнопка Оставить Micator убирает выбранный файл. Без загрузки в панели останется надпись Micator.

Шаг 2: логин и пароль владельца

Владелец — учётная запись, которой доступны все настройки трекера. Про роли — на странице Команда и роли.

1. Проверьте поле Логин владельца. По умолчанию там admin. Допустимы латинские буквы, цифры и знаки _ . + @ -, до 200 символов.
2. Введите Пароль и Повторите пароль. Минимум 12 символов, максимум 72 байта: это 72 латинских символа или 36 кириллических.
3. Сохраните пароль в надёжном месте.

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

Под паролем находится блок Лицензия с полем Ключ лицензии. Формат ключа — XXXX-XXXX-XXXX-XXXX: латинские буквы и цифры от 2 до 7, регистр не важен.

• Пометка «Для доступа к панели» — блок раскрыт, без ключа форма не отправится. После запуска трекер активирует ключ сам.
• Пометка «Необязательно» — блок свёрнут, поле можно оставить пустым. Ключ вводится позже в панели: Настройки → Лицензия.

Где взять ключ — на странице Получение ключа и активация.

Шаг 3: запуск

1. Нажмите Запустить трекер.
2. Дождитесь окончания на экране «Запускаем трекер». Статус меняется по порядку: «Подготавливаем трекер», «Запускаем базы и панель», «Проверяем готовность».

На экране показаны Панель, Трекинг и Владелец — домены и логин, с которыми запускается трекер. Строка «Ожидаем соединение с трекером…» во время запуска — не ошибка, страница продолжит сама. Вкладку можно закрыть: настройка продолжится на сервере. Чтобы вернуться, откройте ссылку с кодом ещё раз.

Когда всё готово, появится экран «Трекер готов». Браузер сам откроет страницу входа; то же делает кнопка Перейти в панель.

Проверка

1. Откройте https://panel.example.com/login.
2. Введите Логин и Пароль владельца.
3. Нажмите Войти.

Откроется панель. Что в ней где находится — на странице Обзор панели.

Если вместо панели открылся экран «Доступ к трекеру закрыт», лицензия не активна. Введите ключ в поле Ключ лицензии и нажмите Активировать — подробнее на странице Получение ключа и активация.

После завершения

• Мастер закрыт и повторно не открывается. Адрес /setup/ на домене панели ведёт на страницу входа.
• Вход по IP сервера переводит на https://panel.example.com/login.
• Код доступа больше не действует, файл setup-access.txt удалён.
• На сервере появился файл /opt/tracker/owner-access.txt с адресом панели, логином и паролем владельца. Его читает только root.

Если не получилось

Введите код доступа из установщика.

Код не введён или не подходит. Возьмите его на сервере:

sudo cat /opt/tracker/setup-access.txt

Домен panel.example.com не найден в DNS. Добавьте A-запись и повторите проверку.

У домена нет DNS-записи или она ещё не обновилась. Добавьте A-запись на IP сервера, подождите и нажмите Проверить и продолжить снова.

Домен panel.example.com пока не ведёт на этот сервер. Проверьте A/AAAA-записи, порт 80 и редиректы прокси, затем повторите.

Мастер запросил домен по HTTP на порту 80 и не получил ответ от этого сервера. Проверьте:

• A-запись указывает на IP этого сервера;
• AAAA-запись, если она есть, ведёт на этот же сервер;
• порт 80 открыт для входящих соединений;
• прокси перед сервером не перенаправляет HTTP на HTTPS.

HTTPS пока не готов. Проверьте DNS, порты 80/443 и режим Full (strict) в Cloudflare, затем повторите.

Домены прошли проверку, но мастер не дождался ответа по HTTPS от обоих доменов. Браузер переходит на https://panel.example.com/setup/, сообщение показано на шаге 2. Пока HTTPS не работает, эта страница не открывается.

1. Проверьте, что DNS-записи обоих доменов ведут на этот сервер.
2. Откройте входящие порты 80 и 443.
3. Для домена за Cloudflare включите режим шифрования Full (strict).
4. Обновите страницу.
5. Продолжайте с шага 2, когда страница открылась по HTTPS.

При запуске мастер проверит HTTPS обоих доменов ещё раз.

Нужно повторить запуск

Шаг 3 остановился с ошибкой. Настройки и доступ владельца сохранены. На экране показана причина, например «Не готовы: HTTPS панели и трафика (DNS/80/443). Исправьте причину и повторите команду; данные сохранены.»

1. Устраните причину на сервере.
2. Нажмите Повторить запуск — в мастере кнопка заменяет «повторите команду» из текста ошибки.

Другие сообщения разобраны на странице Ошибки установки и их устранение.