# Веб-интерфейс

Эта страница содержит подробное руководство по устранению наиболее распространённых ошибок, встречающихся в веб-интерфейсе Navixy On-premise. В ней рассматриваются как Панель администратора, так и пользовательский интерфейс, поскольку они используют общий веб-сервер Nginx, из-за чего ошибки возникают схожим образом. Изучите этот ресурс, чтобы эффективно устранить проблемы и оптимизировать работу.

<details>

<summary>Стартовая страница Nginx</summary>

Если вы видите экран приветствия Nginx, это означает, что запрос дошёл до сервера, Nginx установлен и запущен, но ещё не настроен.

![Добро пожаловать в Nginx](https://4066122344-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-cc8af8a5cc5360fb83c5d70fffc55e99b3b10bbd%2Fimage-20230823-121500.png?alt=media)

Что проверить:

* Конфигурации веб-сайтов хранятся в следующем каталоге:
  * Linux: `/etc/nginx/sites-available`
  * Windows: `C:\nginx\conf\sites-enabled`
* На Linux-системах для этих файлов должны быть созданы символические ссылки в `/etc/nginx/sites-enabled`

Если конфигураций нет — пожалуйста, свяжитесь со службой поддержки Navixy.

</details>

<details>

<summary>Сайт недоступен (DNS_PROBE_FINISHED_NXDOMAIN)</summary>

Ошибка DNS\_PROBE\_FINISHED\_NXDOMAIN означает, что ваш домен не указывает на сервер или настроен неправильно.

![DNS\_PROBE\_FINISHED\_NXDOMAIN](https://4066122344-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-ee4efe34d0e50bbb2bee836c6314cf2e19f29fdf%2Fimage-20230823-122136.png?alt=media)

Чтобы решить проблему, проверьте корректность DNS-записей для домена.

Для функционирования домены должны иметь A-запись DNS. Пожалуйста, проверьте [требования к домену](https://www.navixy.com/docs/on-premise/ru/on-premise/how-to-guide/requirements/domains) для получения дополнительной информации.

</details>

<details>

<summary>Сайт недоступен (ERR_CONNECTION_REFUSED/TIME_OUT)</summary>

Эта ошибка означает, что попытки подключения не удались.

![ERR\_CONNECTION\_REFUSED](https://4066122344-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-984fdd2705c20c8a3519211894fd125a91b7b00d%2Fimage-20230823-130318.png?alt=media)

Шаги по устранению неполадок:

1. Проверьте, открыт ли порт 80 (HTTP) или 443 (HTTPS) и разрешены ли соединения.
2. [Проверьте, запущен ли Nginx](https://www.navixy.com/docs/on-premise/ru/on-premise/how-to-guide/requirements/domains).
3. На Linux: проверьте, созданы ли символические ссылки для конфигураций Nginx в `/etc/nginx/sites-enabled`.
4. Если вы редактировали какие-либо конфигурации Nginx — перезапустите Nginx.

</details>

<details>

<summary>404 Not Found</summary>

Если вы видите такую ошибку, это означает, что NGINX неправильно настроен или вы запрашиваете неверный URL.

![404 not found](https://4066122344-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-5f4c99ae23dc83aa885ff465007a474351413cff%2Fimage-20230823-130949.png?alt=media)

Возможные способы решения:

1. Убедитесь, что URL-адреса в файлах конфигурации Nginx указаны правильно. Файлы находятся в `/etc/nginx/sites-available/`
2. На Linux: проверьте, включены ли необходимые сайты. Сайты включаются созданием символических ссылок в `/etc/nginx/sites-enabled/`
3. Проверьте, что путь к статическим файлам, указанный в конфигурации Nginx, верен.

* Для Linux файлы находятся в `/var/www/`
* Для Windows файлы находятся в `C:\nginx\www`

4. Проверьте, что URL-адреса в статических файлах указаны правильно. Файлы:

* `./www/panel-v2/PConfig.js`
* `./www/pro-ui/Config.js`
* `./www/pro-ui/static/app_config.js`

5. Если вы редактировали какие-либо конфигурации — перезапустите Nginx.

</details>

<details>

<summary>Отображается индикатор загрузки или экран «Мы скоро вернёмся»</summary>

Если вы видите индикатор загрузки длительное время или появляется экран «Мы скоро вернёмся» — это означает, что веб-сервер работает и статические файлы доступны, но UI не может получить данные с платформы.

![Ошибка «Мы скоро вернёмся»](https://4066122344-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-c97c848160adb973624842e0a852c0898d3b4c47%2Fe2xphxkndx.gif?alt=media)

![Мы скоро вернёмся](https://4066122344-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-f051ab31bc3cfacdbf554eb78df2c1603d84dac5%2Fimage-20230823-135703.png?alt=media)

Чтобы решить проблему:

1. Если Панель администратора доступна, а проблема только в пользовательском интерфейсе — проверьте, правильно ли указан домен в Панели администратора (Account Management - Service preferences).
2. Проверьте инструменты разработчика в браузере. В браузерах на базе Chrome нажмите F12, перейдите на вкладку Network, обновите страницу и проверьте ошибки. Если вы видите, что `get_ui_config` вызов API не выполняется, в большинстве случаев это означает, что API-сервер недоступен.
3. [Проверьте статус API-сервера](https://www.navixy.com/docs/on-premise/ru/on-premise/how-to-guide/troubleshooting/checking-service-statuses). Если служба остановлена — попробуйте перезапустить её. Если служба не запускается или падает через короткое время — проверьте её логи для поиска ошибок.
4. Проверьте URL API, возможно он указан неверно в `./www/pro-ui/Config.js`. Если это так, замените URL на корректный и перезагрузите страницу.
5. Если все вышеперечисленное в порядке — проверьте потребление памяти и ещё раз проверьте файл логов API. Возможно, служба исчерпала доступную память.

</details>

<details>

<summary>База данных недоступна</summary>

Сообщение о недоступности базы данных обычно означает, что Java-сервисы не могут запрашивать данные из базы данных.

![DB unavailable](https://4066122344-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-590ea1d19a224f70bccfea4ced15afc0b3807572%2Fimage-20230823-140830.png?alt=media)

Начните с [проверки состояния MySQL](https://www.navixy.com/docs/on-premise/ru/on-premise/how-to-guide/checking-service-statuses#database). Если MySQL не работает — попробуйте перезапустить его и проверьте логи, чтобы найти причину сбоя.

Если ваша база данных размещена на отдельном сервере, убедитесь, что соединение с ней доступно по стандартному порту MySQL 3306 (или по пользовательскому порту, если установка была выполнена таким образом — проверьте `db.properties` файл любого из Java-сервисов).

</details>

<details>

<summary>Ваше соединение небезопасно</summary>

Эта ошибка сообщает, что соединение не защищено SSL.

![Ваше соединение небезопасно](https://4066122344-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-9e6662add38b851703d3ebb581e9271b9af70a17%2Fimage-20230823-141352.png?alt=media)

Возможные причины

* Вы пытаетесь получить доступ к порту 443 (по ссылке HTTPS), но у вас не установлен SSL-сертификат.
* Ваш сертификат не покрывает доменное имя, к которому вы обращаетесь.
* Срок действия вашего сертификата истёк и требуется выпуск нового.
* Сертификат настроен неправильно (не указан в конфигурации Nginx).

</details>

{% hint style="danger" %}
Если приведённая информация не помогает решить проблему, пожалуйста, свяжитесь с нами по адресу <support@navixy.com>, и опишите проблему подробно, приложив логи, файлы конфигурации и всю прочую полезную информацию, которой вы располагаете. Мы всегда готовы оказать всестороннюю помощь.
{% endhint %}
