> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/on-premise/ru/on-premise/how-to-guide/installation/advanced-installation/ubuntu-20/configuration-wizard.md). # Мастер настройки Запустите мастер настройки Ubuntu для Navixy On-Premise, чтобы задать домены, SSL, SMS- и почтовые шлюзы, API-ключи Google Maps и ключ лицензии. Платформа Navixy предлагает мастер настройки, который пользователи могут использовать для первоначальной настройки платформы или изменения некоторых общих параметров. Хотя все описанные ниже настройки можно напрямую применять к конфигурации базы данных и службы, делать это может быть рискованно, если не подходить к делу осторожно. Чтобы избежать возможных рисков, настоятельно рекомендуется использовать конфигуратор. {% hint style="info" %} Мастер настройки можно использовать только для экземпляров Navixy, развернутых с помощью скрипта установки на Ubuntu. Этот мастер не подходит для других способов развертывания. {% endhint %} ## Запуск мастера настройки Чтобы запустить мастер, перейдите в `/navixy-package` каталог и выполните **./configure.sh** Вас встретит главное меню: ![On-Premise - мастер настройки](https://1855757370-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-ae4fe6b257386734cb442a853e98c9b728212e04%2Fimage-20230804-110751.png?alt=media) Ниже приведено описание каждого меню и подменю: ## 1. Настройки доменного имени и SSL ### 1.1. Доменные имена Единственный вариант здесь — изменить доменные имена и SSL. {% hint style="info" %} Доменные имена и SSL-сертификаты указываются во время первоначальной установки. Однако может возникнуть ситуация, когда вам нужно изменить что-то из этого на уже существующей платформе. {% endhint %} Мастер настройки позволяет выполнить конфигурацию либо с одним доменным именем для всей платформы, либо с тремя доменными именами — отдельными для API, для панели администратора и для интерфейса пользователя. В случае **одного доменного имени**, вам нужно указать домен для вашей службы только на первом шаге, а два других домена оставить пустыми. В этом случае API и панель администратора будут настроены как подкаталоги (это делается автоматически). Примеры: * [my.domain.com/api](http://my.domain.com/api) * [my.domain.com/panel](http://my.domain.com/panel) Если вы выполняете **настройку с тремя доменными именами** , вам нужно последовательно указать: * Домен сервиса (используется для интерфейса пользователя и активации устройства). Например: [my.domain.com](http://my.domain.com) * Домен API (используется для всех операций API). Например: [api.domain.com](http://api.domain.com) * Домен панели администратора (используется для доступа к панели администратора). Например: panel.domain.com ![On-Premise - Настройки доменов](https://1855757370-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-76d385572acb0997c93664acfbea83d45653aeae%2Fimage-20230804-112159.png?alt=media) ![On-Premise - Настройки API](https://1855757370-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-e0eb8dc57d0bdcbde2a5c9e60a86d266dd8ca74d%2Fimage-20230804-112223.png?alt=media) ![On-Premise - Настройки панели администратора](https://1855757370-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-2c3e08cd7b6597e14937a1707bd6b407c0531ef6%2Fimage-20230804-112313.png?alt=media) После того как все домены будут указаны, мастер покажет вам результаты настройки. Если вам нужно что-то изменить, запустите мастер еще раз ![On-Premise - Завершение настройки](https://1855757370-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-13638667c111fc9cfcd24a9645a198b288650be9%2Fimage-20230804-112644.png?alt=media) Подробнее о доменных именах можно узнать на этой странице: [Домены](/docs/on-premise/ru/on-premise/how-to-guide/requirements/domains.md) ### 1.2. SSL-сертификаты После настройки доменных имен вы увидите меню установки SSL-сертификата. ![On-Premise - SSL-сертификаты](https://1855757370-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-eec86aa3110ff452204e452b747b98bed6959fca%2Fimage-20230804-114715.png?alt=media) {% hint style="info" %} Если вы вообще не собираетесь использовать SSL, просто выберите **Нет** и скрипт завершит работу, сохранив только настройку доменного имени. {% endhint %} Если вы выберете **Да**, ваша платформа будет настроена для работы по HTTPS. Затем скрипт спросит вас, будете ли вы использовать бесплатные SSL-сертификаты Let's Encrypt или хотите использовать собственные сертификаты. ![On-Premise - Продление SSL-сертификатов](https://1855757370-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-601e0caf248fd4260f0a845590c4e443e30cfd73%2Fimage-20230804-113420.png?alt=media) #### Бесплатный сертификат Let's Encrypt Выберите **Да** чтобы установить бесплатные SSL-сертификаты Let's Encrypt для ваших доменов. Это также настроит автоматическое продление сертификатов, так что вам не придется продлевать их вручную. Скрипт установит программное обеспечение, необходимое для выпуска сертификата (это может занять некоторое время). Вас попросят указать адрес электронной почты. Это необязательно, но рекомендуется. ![On-Premise - Let's Encrypt](https://1855757370-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-05ce799b92201bcc88475b8c3d230f057785e0bb%2Fimage-20230804-114031.png?alt=media) Скрипт автоматически распознает доменные имена (взяв их из конфигураций), сгенерирует и установит сертификаты. После этого скрипт завершит работу. Теперь доменные имена настроены, и ваш сайт защищен SSL. #### Собственный SSL-сертификат При выборе **Нет** варианта в ответ на вопрос о SSL-сертификатах Let's Encrypt вы перейдете в меню установки собственных SSL-сертификатов. Для продолжения у вас должен быть действительный сертификат с полной цепочкой, а также его закрытый ключ. Разместите их где-нибудь на вашем сервере. Стандартное расположение — `/etc/nginx/ssl`. Сначала нужно указать путь к файлу сертификата: ![On-Premise - Собственный сертификат](https://1855757370-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-7041b4f30722142d2848f70fdbc92a9ed7d66327%2Fimage-20230804-115050.png?alt=media) Затем укажите путь к файлу закрытого ключа вашего SSL-сертификата: ![On-Premise - Ключ собственного сертификата](https://1855757370-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-bd4a876b40c1c8b4d97f5faa25bdadb4b5032f84%2Fimage-20230804-115151.png?alt=media) Пути к вашим сертификатам будут внесены в конфигурацию Nginx. Сертификаты установлены, и ваши домены защищены SSL. ## 2. Настройки SMS Здесь вы можете применить настройки своего SMS-шлюза, а также указать учетные данные служебного отправителя SMS. ![On-Premise - SMS-шлюз](https://1855757370-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-34c46de739c55e7438f1524b3f2081f01e8312ff%2Fimage-20230804-115307.png?alt=media) ### 2.1. Настройка SMS-шлюза Первый вариант в этом меню позволяет отключить SMS-шлюз, если он уже настроен и вам больше не нужно его использовать. Другие варианты позволяют применить настройки конкретного провайдера SMS-шлюза. Последний вариант позволяет подключить SMS-шлюз по протоколу SMPP. Этот вариант также подходит, если вашего провайдера шлюза нет в списке, но он поддерживает SMPP со своей стороны. ![On-Premise - Настройка SMS-шлюза](https://1855757370-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-e8950ade8a30f26cb437ce623073594991c0e9de%2Fimage-20230804-115406.png?alt=media) Подробнее о SMS-шлюзах можно узнать на странице [Шлюзы сообщений](/docs/admin/ru/settings/messaging-gateways.md). ### Настройка «имени отправителя» и «номера телефона отправителя» В этом меню при необходимости можно указать номер и имя отправителя служебных SMS-сообщений. ![On-Premise - Номер телефона SMS-шлюза](https://1855757370-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-49757aa710fe2889d04f9c505cbe4922b00713e6%2Fimage-20230804-115441.png?alt=media) ![On-Premise - Идентификатор SMS-шлюза](https://1855757370-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-ed2d2dc619efadd7724533d199d0974c2d6cff81%2Fimage-20230804-115606.png?alt=media) ## 3. Настройки почтового шлюза Здесь вы можете настроить только параметры почты обратной связи. **Обратите внимание:** Основные настройки почтового шлюза настраиваются из панели администратора ([Шлюзы сообщений](/docs/admin/ru/settings/messaging-gateways.md)). Скрипт попросит вас указать адрес электронной почты для получения сообщений обратной связи от пользователей из раздела помощи (адрес электронной почты TO). ![On-Premise - Почтовый шлюз](https://1855757370-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-f169c68acd4746b7694e8af8b882c6d5e70d1e62%2Fimage-20230804-120149.png?alt=media) Затем вас спросят о подстановке адреса электронной почты пользователя. ![On-Premise - Настройка почтового шлюза](https://1855757370-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-5e42970ccf4cb3e774e1fe6012b4898951942e98%2Fimage-20230804-120256.png?alt=media) Выберите **ДА** чтобы использовать адрес электронной почты пользователя для отправки запросов обратной связи. Выберите **НЕТ** чтобы заменить адрес электронной почты отправителя на определенный. В этом случае скрипт попросит вас указать этот адрес электронной почты (адрес электронной почты FROM). ![On-Premise - Обратная связь почтового шлюза](https://1855757370-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-dd6250bdc8147cb35b1372b39e9533c72e61a065%2Fimage-20230804-120347.png?alt=media) ## 4. Настройки API Google Maps Здесь вы можете указать ключ API Google Maps, если не приобрели пакет Premium GIS от Navixy, а предпочли использовать собственный ключ ([GIS](/docs/on-premise/ru/on-premise/how-to-guide/requirements/gis.md)) ![On-Premise - Управление API ключами Google Maps](https://1855757370-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-59ce50d725ff6c05007091d7f1c21c0c56fe3330%2Fimage-20230804-120428.png?alt=media) Сначала нужно указать JavaScript-ключ Google API (необходимый для доступности карт). ![On-Premise - JavaScript-ключ API Google Maps](https://1855757370-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-62d75ed33672726f1aa619562601c4e0beac9e86%2Fimage-20230804-120534.png?alt=media) Затем укажите серверный ключ Google API (необходимый для операций геокодирования). ![On-Premise - Управление API ключами Google Maps](https://1855757370-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-414386525a9060f0a4fb5404e7244e81201dd3a8%2Fimage-20230804-120615.png?alt=media) ## 5. Лицензионный ключ Navixy Этот раздел содержит два варианта. ![On-Premise - Лицензионный ключ Navixy](https://1855757370-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-c5689839d68d51f250aa64e60b43d6d00c549f30%2Fimage-20230804-120649.png?alt=media) ### 5.1. Изменение лицензионного ключа Здесь вы можете указать лицензионный ключ для вашего экземпляра On-Premise. Лицензионный ключ применяется во время первоначальной установки платформы или если он по какой-то причине утерян или поврежден (обычно это является следствием вмешательства в базу данных). Лицензионный ключ выдается и предоставляется технической поддержкой. После выбора этого варианта вы увидите предупреждение о том, что неосторожное изменение лицензионного ключа может привести к неработоспособности платформы. ![On-Premise - Изменение лицензионного ключа](https://1855757370-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-66046e0f04cb853ef2d6cdfb3e97566508dd912d%2Fimage-20230804-120737.png?alt=media) После этого нужно применить полученный вами лицензионный ключ. Это довольно длинная последовательность символов, поэтому вводить ее вручную может быть непросто. Вы можете вставить ключ из буфера обмена с помощью `Shift+Insert` сочетания. Альтернативно, вы можете удерживать `Shift` и использовать `щелчок правой кнопкой мыши`. ![On-Premise - Ввод лицензионного ключа](https://1855757370-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-b8679d56fbe0b26ed95a71119e3b875401d2e314%2Fimage-20230804-121133.png?alt=media) Ключ будет внесен в базу данных, и ваш экземпляр будет иметь действительную лицензию. ### 5.2. Запрос пробного ключа Этот вариант можно использовать только для получения одноразового пробного ключа. Ключ действителен 30 дней. Не используйте этот вариант, если у вас уже есть действительный ключ. ![On-Premise - Запрос пробного ключа](https://1855757370-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-f722a32cecfda228e5642a85bd6553ed20bcb257%2Fimage-20230804-121025.png?alt=media) * Таким образом нельзя перевыпустить или продлить пробный ключ. * Таким образом нельзя восстановить утерянный ключ. * Таким образом нельзя восстановить отключенную лицензию. После завершения пробного периода, если вы хотите продолжить использовать ваш экземпляр On-Premise, обратитесь в нашу команду по работе с клиентами за коммерческим лицензионным ключом. ## 6. Настройки плагинов Плагины позволяют изменять или включать различные функции платформы. Поскольку конфигуратор предназначен для базовой настройки платформы, в этом меню вы найдете только три плагина. ![On-Premise - Настройки плагинов](https://1855757370-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-aa181a216be750c71e3c5726a2f067691ada7c9d%2Fimage-20230804-121204.png?alt=media) ### 6.1. Настройки кодов активации Здесь вы можете включить или отключить использование обязательных кодов активации для регистрации устройства. Если включен вариант «Обязательный», пользователи не смогут зарегистрировать устройство без кода активации. ![On-Premise - Настройки кодов активации](https://1855757370-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-43cc1df99a623689ba5b22feaa5b2dc7972dbadf%2Fimage-20230804-121337.png?alt=media) ### 6.2. Настройки собственного логотипа Здесь вы можете настроить специальный логотип для отдельного пользователя. **Обратите внимание**: логотип для всей платформы настраивается в панели администратора. Мастер настройки попросит вас указать идентификатор пользователя (его можно найти в панели администратора или в интерфейсе пользователя) ![On-Premise - Настройки логотипа](https://1855757370-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-106294a9efa442cecc42a8dceaa00081c030989c%2Fimage-20230804-121447.png?alt=media) Затем нужно указать ссылку на логотип пользователя. Он может располагаться на внешнем ресурсе или локально на сервере в каталоге сайта. Логотип должен быть в формате PNG, рекомендуемый размер — 400x400. ![On-Premise - Логотип](https://1855757370-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-b4529bdb669b268e68de9a2dd503b71125689dd3%2Fimage-20230804-121640.png?alt=media) Логотип будет применен к интерфейсу пользователя и к отчетам. ### 6.3. Настройки раздела помощи Здесь вы можете выбрать, скрывать или показывать раздел помощи в интерфейсе пользователя (по умолчанию он отображается). Раздел помощи ведет на сайт Navixy, поэтому его отключение может быть полезно для ребрендинга. ![On-Premise - Настройки раздела помощи](https://1855757370-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-7e56f71cdc6f690a797066a9e6236ddd85e8e41d%2Fimage-20230804-121740.png?alt=media) ## 7. Настройки файлового хранилища Этот раздел позволяет включать и отключать файловое хранилище. ![On-Premise - Настройки файлового хранилища](https://1855757370-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-a641f3a11948f152a34fb5d2ff9839e3701d2020%2Fimage-20230804-121814.png?alt=media) Оно используется для хранения файловых и графических вложений к формам заданий и работам по техобслуживанию. Каталог по умолчанию для хранения файлов — `/home/java/api-server/files`*.* --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://navixy.com/docs/on-premise/ru/on-premise/how-to-guide/installation/advanced-installation/ubuntu-20/configuration-wizard.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.