Объяснение файла system.properties в UniFi

Обратите внимание, что эта статья применима только для опытных пользователей с самостоятельно размещенными серверами UniFi Network, установленными на машинах с Windows, macOS или Linux. Для наилучшего опыта мы обычно рекомендуем использовать UniFi Console. Посетите UI.com, чтобы узнать больше.

В этой статье описано, для чего используется файл system.properties и как его редактировать.

Введение

Файл system.properties определяет общесистемные параметры для сервера UniFi Network. Он находится в папке data внутри <unifi.base>. Некоторые расширенные варианты использования включают:

  • Ручное переопределение IP-интерфейса приложения (адреса, на который устройства отправляют пакеты inform).
  • Расширенные настройки базы данных.
  • Назначение портов для целей обмена данными между приложением UniFi Network и управляемыми устройствами, перенаправления трафика гостевого портала и т.д.

ВНИМАНИЕ: Перед редактированием файла не забудьте создать резервную копию вашей системы. Также необходимо остановить приложение перед внесением любых изменений в файл, чтобы избежать ошибок после внесения изменений.

Файл system.properties можно редактировать напрямую с помощью любого текстового редактора. Имейте в виду, что строки, начинающиеся с символа решетки (#), являются комментариями и не выполняются. Вносите изменения в нижней части файла. После изменения этого файла вам потребуется вручную запустить подготовку на каждом сайте, чтобы изменения вступили в силу.

Примечание: Файл создается при успешном запуске UniFi Network. Если вы не можете найти файл в <unifi_base>, создайте его, запустив UniFi Network.

Ручное указание IP-интерфейса для связи с приложением UniFi Network

Если UniFi Console имеет несколько IP-интерфейсов, следующая конфигурация может вручную задать точный IP-интерфейс, на который принятые точки доступа должны отправлять данные приложению Network:

system_ip=a.b.c.d # IP, на который устройства должны отправлять inform-пакеты
Расширенная конфигурация базы данных

Ниже приведены расширенные конфигурации базы данных, которые большинству пользователей никогда не понадобятся. Примечание: Мы не проводим тестирование этих конфигураций, они включены для удобства экспертов по базам данных. Один из возможных сценариев использования — когда несколько человек запускают приложение на NAS, который имеет меньшие ресурсы, чем обычный сервер, поэтому возникает необходимость уменьшить требуемые ресурсы.

unifi.db.nojournal=false # отключить журналирование mongodb
unifi.db.extraargs        # дополнительные аргументы mongod

Конфигурация ниже используется для упрощения установки приложения UniFi Network. Еще раз, большинству пользователей никогда не понадобится устанавливать это. Когда is_default установлено в true, приложение запустится с заводскими настройками по умолчанию. Для обычных пользователей рекомендуется удаление и затем чистая переустановка вместо использования этой опции.

is_default=true

Из приложения UniFi Network вы можете настроить частоту автоматического резервного копирования, количество хранимых резервных копий, время создания копии и т.д. На момент написания статьи вы не можете изменить место хранения через приложение. У нас есть переменная в system.properties, если вы хотите изменить место хранения. В настоящее время значение по умолчанию указывает на:

  1. Для Cloud Key: /data/autobackup (где SD-карта по умолчанию монтируется как /data)
  2. Для программных установок: {data.dir}/backup/autobackup
autobackup.dir=/некоторый/путь

HSTS можно включить, но это должны делать только опытные системные администраторы, знакомые с этой технологией. Если у вас возникнут проблемы, вам, вероятно, потребуется очистить кэш браузера после отключения этой опции и перезапуска службы. Чтобы включить поддержку HSTS, добавьте следующее:

unifi.https.hsts=true
unifi.https.hsts.max_age=31536000
unifi.https.hsts.preload=false
unifi.https.hsts.subdomain=false

ПРИМЕЧАНИЕ: В настоящее время после пользовательских строк не допускается никаких символов. Это включает пробелы, знаки решетки/комментарии и т.д.

Настройки, связанные с SMTP

По умолчанию SMTPS проверяет сертификаты и будет отклонять самоподписанные или неподтвержденные сертификаты. Если ваш почтовый сервер использует неподтвержденный сертификат, вы должны отключить проверку сертификата с помощью следующей строки:

smtp.checkserveridentity=false

Начиная с версии UniFi Network 6.1, STARTTLS включен по умолчанию в зависимости от возможностей сервера; например, будет использоваться, если сервер объявляет о его поддержке, и будет требовать подтвержденный сертификат. Если используется самоподписанный или неподтвержденный сертификат, вы должны отключить STARTTLS, установив следующее:

smtp.starttls_enabled=false

Это управляет только тем, будет ли использоваться STARTTLS, если сервер поддерживает его. Для принудительного использования см. параметр starttls_required.

В версии UniFi Network 6.1 и новее STARTTLS включен по умолчанию в зависимости от возможностей сервера, но требуется только при использовании порта 587. Это поведение можно переопределить, установив smtp.starttls_required=true, чтобы принудительно использовать STARTTLS на портах, отличных от 587, или чтобы сделать STARTTLS необязательным на порту 587, установите значение false.

Если установлено smtp.starttls_enabled=false, значение starttls_required не имеет влияния.

Была ли эта статья полезной?

Возврат к списку

Каталог
Главная Каталог Поиск Корзина Кабинет