Настройка#

Важно

Все шаги в этом разделе должны выполняться с правами суперпользователя (root). Если вы используете sudo, то чтобы не запутаться в командах, рекомендуется сначала выполнить sudo -i для получения полноценной сессии суперпользователя.

Изменение адресов точек подключения#

Изменение адресов точек подключения может потребоваться в случае изменения DNS-имени сервера, на котором развернута система, либо при изменении настроек обратного прокси-сервера. Для изменения адресов точек подключения необходимо внести изменения в файл docker-compose.yaml, расположенный в директории /srv/ngwdocker, в секции x-shared и перезапустить стек:

$ cd /srv/ngwdocker
$ nano docker-compose.yaml
$ docker compose up -d

Настройка LLM-провайдера#

AI-инструменты в NextGIS Web, например генерация фильтров для таблицы объектов на естественном языке, работают по принципу BYOK (Bring Your Own Key). Это означает, что для использования этих функций необходимо предоставить собственный ключ доступа к OpenAI-совместимому API LLM-провайдера.

Параметры подключения и используемую модель можно указать в docker-compose.yaml в секции services.app.environment с помощью следующих переменных окружения:

NEXTGISWEB__LLM_CORE__BASE_URL: "https://api.openai.com/v1"
NEXTGISWEB__LLM_CORE__API_KEY: "<API key>"
NEXTGISWEB__LLM_CORE__MODEL: "gpt-4o-mini"

После внесения изменений необходимо перезапустить стек командой docker compose up -d для применения новых настроек. После этого AI-инструменты будут доступны в интерфейсе NextGIS Web.

Включение модуля Аудита#

В переменных окружения нужно задать следующие значения:

NEXTGISWEB__AUDIT__FILE__ENABLED=true
NEXTGISWEB__AUDIT__DBASE__ENABLED=true

Перенос на другой сервер#

Последовательность действий:

  1. На исходном сервере создайте офлайн резервную копию согласно инструкции Создание резервной копии.

  2. На новом сервере выполните установку NextGIS Web согласно разделу Установка.

    Важно

    Версия устанавливаемого экземпляра NextGIS Web должна совпадать с версией на исходном сервере. Восстановление резервной копии между разными версиями не поддерживается.

  3. Скопируйте файл резервной копии на новый сервер, например:

$ scp /var/lib/docker/volumes/ngwdocker_backup/_data/archivist-20260117-002345.tar.zst \
     root@new-server:/var/lib/docker/volumes/ngwdocker_backup/_data/

  1. Восстановите данные из резервной копии согласно инструкции Восстановление из резервной копии.