Конфигурация
Конфигурация чат сервера хранится в файле ./elph-chat-server/stable/.env
Чтобы перейти в файл конфигурации введите команду:
sudo nano elph-chat-server/stable/.env
Пример исходного .env файла:
# ELPH-CHAT-SERVER CONFIGFILE 2.2 # Модули конфигурации расположены в порядке важности # Без докер образа не будет ничего # Без сконфигурированных параметров подключения к БД не запустится сервер # Без нужных серверу параметров он откажется запускаться # Без сконфигурированного провайдера аутентификации не будет доступа к учеткам # ... # ######################## Docker ######################## # Источник докер образов DOCKER_REPO="hub-ims.eltex-co.ru" # Версия докер образов TAG="2.2" # ---------- Менять не нужно ---------- NGINX_TAG=1.23.3-${TAG} MONGO_TAG=4.4-${TAG} SERVER_TAG=${TAG} DEPLOY_PLATFORM=docker # ######################## # ######################## Параметры подключения к mongodb ######################## MONGO_URL=mongodb://mongo:27017/elph?replicaSet=rs01 MONGO_OPLOG_URL=mongodb://mongo:27017/local?replicaSet=rs01 # ######################## # ####################### Для работы сервера ######################## # ---------- Необходимо сконфигурировать ---------- # Публичный адрес сервера ROOT_URL=https://elph-chat.loc # ---------- Менять не нужно ---------- PORT=3000 NODE_PATH=/usr/bin/node NODE_ENV=production # ######################## # ######################## Аутентификация через ECSS10 ######################## # Параметры подключения к ecss-web-api (ecss-core) ECSS_WEB_API_HOST="ecss-core.loc" # ---------- Опционально ---------- ECSS_WEB_API_DOMAIN="default" ECSS_WEB_API_PORT=8086 ECSS_WEB_API_SERVICE=call # ######################## # ######################## Получение доп.информации о пользователе (аватар/дисплейнейм) ######################## # Параметры подключения к ecss-mysql ECSS_ADDRESSBOOK_HOST="address-book.mysql.ecss" # ---------- Опционально ---------- ECSS_ADDRESSBOOK_PORT=3306 ECSS_ADDRESSBOOK_DB_USER="address_book" ECSS_ADDRESSBOOK_DB_PASSWORD="address_book" ECSS_ADDRESSBOOK_DB_NAME="ecss_address_book" # При входе, если последнее обновление было больше чем это, то обновить данные UPDATE_ADDRBOOK_AVATAR_EVERY_MS=80000 # Префиикс перенправления на ecss-elph-api ECSS_AVATAR_URL_ORIGIN_PREFIX=https://elphapi:8098/loadlocal/ # ######################## # ######################## Разметка сообщений (markdown, katex, autolink) ######################## # Разрешенные "подозрительные домены" # незарегистрированные доменные имена не будут размечаться как ссылки, если не добавить их в этот список (через запятую) пример: domain.asd,evil.troian.loc MESSAGEPARSER_AUTOLINK_CUSTOM_DOMAINS=eltex.loc # ######################## # ######################## Тех поддержка (сбор обратной связи отчетов/клиентских логов) ######################## # ---------- Опционально ---------- # Включить создание supportuser OVERWRITE_SETTING_Support_User=true OVERWRITE_SETTING_Support_User_Welcome_Message="Добро пожаловать в чат технической поддержки!" OVERWRITE_SETTING_Support_User_Password="password" OVERWRITE_SETTING_Support_User_Name="Поддержка Elph" # ######################## # ######################## Системные отчеты использования системы ######################## # ---------- Опционально ---------- ### Разрешить системе отправлять сообщения пользователям (нужно для отправки отчета о системе) SYSTEM_ADMIN_MESSAGES=true ### Генерировать отчет использования системы SYSTEM_REPORTS_ENABLE=true ### Отправлять отчет системы пользователям (имена пользователей через запятую) SYSTEM_REPORTS_SUBSCRIBERS_USERNAMES="supportuser" ### Отправлять отчет каждые (<число>_<week|month>) SYSTEM_REPORTS_INTERVAL="1_week" # ######################## # ######################## Cпецифичная настройка ######################## # ---------- Опционально ---------- # Разрешить работу с не подтвержденными SSL сертификатами (самоподписанные/локальные/и т.д.) NODE_TLS_REJECT_UNAUTHORIZED=0 # Разрешить работу elph-desktop # ---------- Менять не нужно ---------- OVERWRITE_SETTING_API_CORS_Origin='*' OVERWRITE_SETTING_API_Enable_CORS=true OVERWRITE_SETTING_Iframe_Restrict_Access=false OVERWRITE_SETTING_Initial_Channel_Created=true # ######################## # NGINX_ACCESS_LOGS=./log/ecss-chat-server.access.log # Для монтирования своих сертификатов (по умолчанию самоподписанные) # NGINX_CERTS= # NGINX_RPIVATE_SSL_KEYS=
В первоначальной настройке необходимо изменить следующие параметры:
ROOT_URL=https://<ip_address_chat_server>:3443 #Внешний адрес чат-сервера, по которому он будет доступен для пользователей Elph Desktop.
ECSS_WEB_API_HOST=<ip_address_elph_api> #Адрес ядра ECSS
ECSS_WEB_API_DOMAIN=<domain_name> #Имя домена ECSS, с которым будет работать чат-сервер
ECSS_ADDRESSBOOK_HOST=<ip_address_mysql> #адрес ecss-mysql
ECSS_AVATAR_URL_ORIGIN_PREFIX=https://<ip_addrss_elph_api>:8098/loadlocal/ #Адрес Elph-API для скачивания аватаров, подробнее об этом в разделе «Настройка аватаров».
Остальные параметры являются опциональными, изменять их нужно в случае если используется нестандартная схема развёртывания ECSS-10.
Обратите внимание на архитектуру, чат-сервер должен иметь доступ к ecss-mysql, иначе не будут работать аватары и имена пользователей в чате, для этого необходимо настроить маску доступа к mysql.
Введите команду:
dpkg-reconfigure ecss-mysql
Далее откроется диалоговое окно с вопросом о маске, например, для доступа всех IP-адресов можно задать маску: %.%.%.%.
Сетевые окончания
3443 — https-порт для доступа к чат-серверу.