Ошибки установки
Установщик останавливается при первой неустранимой проблеме и выводит красную строку с ✗. Устраните причину и повторите команду — повторный запуск установщика безопасен. Информационные сообщения начинаются с •, успешно выполненные шаги — с ✓.
Проверки сервера
| Сообщение | Причина | Решение |
|---|---|---|
must be run as root (sudo) | Запуск не от имени root | Добавьте в начале команды sudo или выполните ее от root. |
only Ubuntu 22.04/24.04 is supported (this host: …) | Другой дистрибутив или версия | Используйте сервер с Ubuntu 22.04 или 24.04. |
only x86_64 is supported | ARM или другая архитектура процессора | Используйте сервер на базе x86_64. |
requires ≥ 2 GB RAM (host has … MB) | Недостаточно оперативной памяти | Добавьте RAM. |
requires ≥ 8 GB free disk space on / (… GB available) | Корневая файловая система почти заполнена | Освободите место или увеличьте /. |
missing --license / missing --domain | Первая установка без обязательных параметров | Укажите оба параметра — см. Установка. |
unknown argument: … | Опечатка в параметре | Проверьте написание; запустите с параметром --help. |
apt-get failed (another apt/dpkg process, e.g. unattended-upgrades, may still be running) | Менеджер пакетов заблокирован | Подождите несколько минут (чистая Ubuntu выполняет автоматические обновления после загрузки) и запустите снова. |
… is a symlink — aborting | /opt/nexcmp или /etc/nexcmp является символической ссылкой | Замените ее реальным каталогом — установщик отклоняет символические ссылки в целях безопасности. |
Активация лицензии
| Сообщение | Причина | Решение |
|---|---|---|
cannot connect to https://nexcmp.com | Нет исходящего HTTPS-соединения с сервером лицензий | Проверьте DNS, фаервол и прокси на сервере: curl -I https://nexcmp.com. |
license activation failed (HTTP …): <message> | Сервер лицензий отклонил ключ | Прочтите сообщение: неверный ключ, домен не соответствует лицензии, лицензия приостановлена или отозвана. Проверьте страницу лицензий на nexcmp.com/licenses. |
no release available for this license yet | Для этой лицензии нет доступного для скачивания релиза | Свяжитесь с отделом продаж; см. Поддержка. |
Скачивание и проверка
| Сообщение | Причина | Решение |
|---|---|---|
failed to download release X | Сетевая ошибка при скачивании | Запустите снова. |
sha256 mismatch (… ≠ …) | Файл поврежден при передаче или был изменен | Запустите снова; если ошибка повторяется, возможно, прокси изменяет загружаемые файлы — попробуйте из другой сети. |
release X is unsigned — refusing to install | Сервер не предоставил подпись | Ни в коем случае не обходите проверку; обратитесь в службу поддержки. |
INVALID SIGNATURE for version X — aborting | Подпись Ed25519 не проходит проверку | Не устанавливайте. Обратитесь в службу поддержки — это означает, что файл не является официальным релизом. |
openssl failed to read public key | Устаревшая или поврежденная версия OpenSSL | Обновите пакет openssl. |
invalid version: … | Непредвиденные данные от сервера | Запустите снова; обратитесь в службу поддержки, если проблема сохраняется. |
Запуск службы
| Сообщение | Причина | Решение |
|---|---|---|
service failed to start — check: journalctl -u nexcmp -n 50 | Панель не ответила на /healthz в течение 3 минут | Проверьте журнал. Распространенные причины: порт (по умолчанию 3000) уже занят (`ss -ltnp |
nginx и TLS
| Сообщение | Причина | Решение |
|---|---|---|
DNS <domain> does not point to <IP> (nor to Cloudflare) — skipping nginx/TLS | A/AAAA-запись отсутствует или указана неверно | См. DNS и Cloudflare, затем запустите снова. |
certbot could not get a certificate yet — re-run the installer once DNS has settled | Сбой проверки Let's Encrypt (порт 80 заблокирован, DNS еще не обновился, лимит запросов) | Откройте порт 80, дождитесь распространения DNS, запустите снова. Проверьте /var/log/letsencrypt/letsencrypt.log. |
certbot could not renew now — keeping the existing certificate | Временный сбой обновления сертификата | Не критично; запустите снова позже. |
nginx rejected the HTTPS configuration — kept the previous one (check: nginx -t) | Конфликт с другим сайтом nginx (одинаковый server_name, дублирующиеся параметры) | Выполните sudo nginx -t и устраните конфликт, затем запустите снова. |
apt-get could not install nginx / certbot или E: Failed to fetch … 404 Not Found | Менеджер пакетов заблокирован, или индекс пакетов сервера устарел (типично для образов шаблонов, которые давно не обновлялись) | Выполните sudo apt-get update, дождитесь завершения всех остальных процессов apt, затем снова запустите установщик. |
openssl could not create the self-signed certificate | Проблема с OpenSSL | Обновите openssl; запустите снова. |
После установки
| Симптом | Причина | Решение |
|---|---|---|
Браузер не может открыть https://<domain> | DNS или TLS не готовы | sudo nexcmp status; используйте аварийный доступ. |
ERR_TOO_MANY_REDIRECTS | Режим Cloudflare SSL Flexible | Установите Full (strict) — подробнее. |
| Мастер сообщает, что «setup code» недействителен | Опечатка или код от предыдущей установки | Выполните sudo nexcmp status и скопируйте текущий код. |
| Для лицензии отображается HTTP 421 | Владельцем файлов в /var/lib/nexcmp является root | sudo nexcmp fix-owner, затем sudo systemctl restart nexcmp. |