Ошибки установки и их устранение

Установщик и мастер первого запуска останавливаются с коротким сообщением. Найдите его текст на этой странице, устраните причину и повторите прежнюю команду установки или действие в мастере. Повторный запуск продолжает начатую установку: сохранённые настройки и данные остаются.

Где смотреть состояние установки

Установщик печатает сообщение в терминал, мастер показывает его на своей странице. Состояние установки смотрите на сервере:

sudo trackerctl status
sudo trackerctl check
sudo systemctl status tracker-setup.service
sudo journalctl -u tracker-setup.service -n 50
sudo docker ps -a

• trackerctl status печатает версию и этап. Этапы при установке через мастер: awaiting_setup — мастер ждёт настройки, starting — запуск трекера начат, ready — трекер готов.
• trackerctl check один раз проверяет готовность. Успех — «Сервисы и HTTPS отвечают.» Пока в мастере не нажата кнопка Запустить трекер, команда отвечает «Операция не завершена: FileNotFoundError»: настройки ещё не сохранены.
• journalctl показывает причину, если служба мастера не запустилась.
• docker ps -a показывает контейнеры и их состояние. Журнал контейнера: sudo docker logs --tail 50 ИМЯ, имя берите из колонки NAMES.

Команда trackerctl появляется после подготовки сервера, при установке в терминале — после успешного запуска трекера. В примерах каталог установки — /opt/tracker. Если установка шла с --path, подставьте свой каталог.

Расположение файлов и служб — на странице Файлы установки, порты, службы и журналы.

Ошибки запуска: права, система, ресурсы

Что установщик проверяет на сервере, описано на странице Требования к серверу и подготовка.

«Команда … завершилась ошибкой (N).»

Не сработала системная команда: apt-get, curl, docker, systemctl. В сообщении только имя команды и код. Подробности не печатаются: в них могут оказаться пароли. В мастере так же выглядит ошибка команды при запуске трекера.

1. Для apt-get выполните sudo apt-get update: команда покажет причину.
2. Для curl проверьте, что сервер открывает https://download.docker.com.
3. Для docker проверьте службу Docker: sudo systemctl status docker.
4. Повторите прежнюю команду установки.

«Операция не завершена: …» и «Не удалось завершить настройку. Данные сохранены; повторите попытку.»

Непредвиденная ошибка. В терминале после двоеточия стоит её тип, например TimeoutExpired — команда не уложилась в отведённое время. Второе сообщение показывает мастер.

1. Повторите команду установки или действие в мастере.
2. Если сообщение повторилось, посмотрите состояние командами из раздела Где смотреть состояние установки.

Подпись и состав выпуска

Установщик скачивает архив выпуска, проверяет подпись и только потом распаковывает. Затем сверяет каждый файл с подписанным списком.

Что сделать:

1. Повторите команду установки: архив скачивается заново при каждом запуске.
2. Если сообщение повторилось, скачайте установщик заново: curl -fsSLo install.sh https://install.micator.com/install.sh.
3. Проверьте выпуск без установки: bash install.sh --verify-only. Успех — строка «Состав выпуска проверен: …».
4. Запустите sudo bash install.sh.

Если подпись не проходит и на заново скачанном установщике, не устанавливайте этот архив.

Занятые порты, непустой каталог, прежняя установка

«Порт 80 занят.» и «Порт 443 занят.»

Порт на сервере уже слушает другая программа. При установке в терминале текст другой: «Порт 80 занят другим веб-сервером.»

1. Найдите программу: sudo ss -ltnp | grep -E ':(80|443) '.
2. Остановите её.
3. Отключите её автозапуск.
4. Повторите команду установки.

«Каталог не пуст; установка поверх существующих данных запрещена.»

В каталоге установки (по умолчанию /opt/tracker) уже есть файлы, а начатой установки в нём нет. При установке в терминале: «Каталог не пуст. Установка поверх Git, данных или неизвестной системы запрещена.»

Возьмите чистый сервер или укажите другой каталог: sudo bash install.sh --path /opt/micator. При следующих запусках установщика указывайте тот же --path.

«На сервере уже есть ресурсы tracker.»

Docker на сервере уже содержит контейнеры, тома или сети проекта tracker. При установке в терминале: «На сервере уже есть ресурсы проекта tracker. Автоматический захват запрещён.» Близкие сообщения:

• «На сервере уже есть тома tracker; автоматическое присвоение запрещено.» — найдены тома с именем tracker_….
• «Имя службы первого запуска уже занято.» — существует контейнер tracker-setup-edge.

Установщик не занимает и не удаляет чужие ресурсы и ставит трекер только на сервер без них. Посмотреть, что найдено:

sudo docker ps -a --filter label=com.docker.compose.project=tracker
sudo docker volume ls

«Установлен другой выпуск. Мастер не обновляет работающий трекер.»

Установка в этом каталоге начата или выполнена другим выпуском, не тем, что скачал установщик. При установке в терминале: «Установлен другой выпуск. Установщик не обновляет и не откатывает существующие базы.»

• Трекер уже работает — обновляйте его в панели: Настройки → Обновления. Подробности — на странице Обновление трекера из панели.
• Установка не завершена — продолжайте её тем же файлом install.sh, которым начинали. Каждый файл установщика скачивает свой выпуск.

Не определился публичный IP

Сообщение: «Не удалось определить публичный IPv4. Передайте --setup-ip IP сервера.»

Мастер открывается по публичному IPv4 сервера. Установщик ищет такой адрес на сетевых интерфейсах. Если на интерфейсах только частные адреса, автоопределение не срабатывает.

1. Узнайте публичный IPv4 сервера в панели хостинга.
2. Запустите установщик с этим адресом: sudo bash install.sh --setup-ip 203.0.113.10. Адрес в примере замените своим.

Адрес должен быть публичным IPv4. Частный адрес вида 10.0.0.5 или 192.168.1.10 и адрес IPv6 не принимаются.

Мастер не открывается

«Мастер ещё недоступен. Проверьте tracker-setup.service и повторите установщик.»

Служба мастера не ответила на 30 проверок подряд с паузой в секунду.

1. Посмотрите состояние службы: sudo systemctl status tracker-setup.service.
2. Посмотрите её журнал: sudo journalctl -u tracker-setup.service -n 50.
3. Убедитесь, что Docker работает: sudo systemctl status docker.
4. Повторите команду установки. Код доступа останется прежним.

Терминал показал ссылку, но страница в браузере не открывается

Установщик не открывает порты во внешнем firewall.

1. Откройте входящие TCP-порты 80 и 443 в firewall сервера и в панели хостинга.
2. Откройте ссылку именно с http://: по IP мастер работает без HTTPS.

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

Код не введён или введён с ошибкой. Ссылка с кодом и сам код записаны в файл на сервере:

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

«Неверный адрес мастера.»

Мастер отвечает только по IP сервера и по домену панели. Откройте ссылку из терминала или https://panel.example.com/setup/ со своим доменом панели.

«Логин и пароль задаются только по HTTPS на домене панели.»

Шаг 2 открыт по IP или без HTTPS. Откройте https://panel.example.com/setup/ со своим доменом панели и введите код доступа.

Ошибки доменов и DNS в мастере

После ошибки мастер остаётся на шаге «Подключите домены». Исправьте поля или DNS и нажмите Проверить и продолжить ещё раз.

Если домен «пока не ведёт на этот сервер»:

1. Проверьте, что A-запись указывает на IP сервера из ссылки мастера.
2. Проверьте AAAA-запись: если она есть, она тоже должна вести на этот сервер.
3. Откройте входящий TCP-порт 80.
4. Отключите на прокси редирект с HTTP на HTTPS на время настройки: мастер проверяет домен по HTTP и по редиректам не переходит.

При установке в терминале проверяется только наличие доменов в DNS. Сообщение: «Домен ещё не разрешается в DNS: …».

HTTPS не готов

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

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

1. Убедитесь, что входящие TCP-порты 80 и 443 открыты из интернета, а не только с вашего адреса.
2. Проверьте, что оба домена по-прежнему указывают на этот сервер.
3. Если домены идут через Cloudflare, включите режим шифрования Full (strict).
4. Обновите страницу https://panel.example.com/setup/ со своим доменом панели.
5. Когда страница открылась, продолжайте с шага 2. Сменить домены на этом шаге нельзя.

Сервисы не готовы: «Не готовы: …»

Сообщение: «Не готовы: …. Исправьте причину и повторите команду; данные сохранены.»

После запуска установщик проверяет готовность до 60 раз с паузой 3 секунды. На месте многоточия названо то, на чём проверка остановилась.

Команды для просмотра контейнеров и журналов — в разделе Где смотреть состояние установки.

Что сделать:

1. Устраните причину на сервере.
2. В мастере на экране «Нужно повторить запуск» нажмите Повторить запуск. Настройки и пароль владельца сохранены, вводить их заново не нужно.
3. При установке в терминале повторите прежнюю команду с теми же параметрами.

sudo systemctl restart tracker-setup.service

Не скачалась база GeoIP

Сообщение: «Не удалось загрузить GeoIP. Положите city.mmdb в data/geoip и повторите установку.»

Установщик скачивает базу DB-IP City Lite с download.db-ip.com: сначала за текущий месяц, затем за предыдущий. Сообщение появляется, когда обе загрузки не удались. Положите базу вручную:

1. Скачайте на своём компьютере файл https://download.db-ip.com/free/dbip-city-lite-ГГГГ-ММ.mmdb.gz. Вместо ГГГГ-ММ подставьте текущие год и месяц, например 2026-10.
2. Распакуйте архив.
3. Переименуйте файл в city.mmdb.
4. Положите его на сервер: /opt/tracker/data/geoip/city.mmdb.
5. Разрешите чтение файла: sudo chmod 644 /opt/tracker/data/geoip/city.mmdb.
6. Нажмите Повторить запуск в мастере или повторите команду установки в терминале.

Если файл больше 1 КБ уже лежит на месте, установщик его не скачивает.

Перезагрузка сервера во время настройки

Вкладку мастера можно закрыть: настройка идёт на сервере. Перезагрузка сервера её тоже не сбрасывает.

• Служба tracker-setup.service запускается вместе с сервером и продолжает с сохранённого шага.
• Если перезагрузка пришлась на проверку доменов, проверка запускается заново с теми же доменами.
• Если на шаге 2 уже нажата кнопка Запустить трекер, запуск продолжается без участия пользователя.
• Сообщение «Запуск прервался до сохранения настроек. Повторите восстановление проверенной копии.» появляется, если перезагрузка прервала начало восстановления из копии. Откройте блок Восстановить из резервной копии и запустите восстановление ещё раз.

Чтобы вернуться в мастер, откройте ту же ссылку. Пока мастер не завершён, она записана в /opt/tracker/setup-access.txt. Экраны мастера и ошибки полей шага 2 описаны на странице Мастер первого запуска.

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

Повторный запуск sudo bash install.sh до завершения мастера печатает ту же ссылку с тем же кодом. После завершения мастер закрыт: адрес /setup/ на домене панели переводит на страницу входа.

Если в панели показано «Сначала обновите службу установки на сервере», это не ошибка установки. Порядок действий — на странице Обновление службы установки.