Обновлено: 21.03.2026 в 11:42:02
Объяснение файла 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, если вы хотите изменить место хранения. В настоящее время значение по умолчанию указывает на:
- Для Cloud Key: /data/autobackup (где SD-карта по умолчанию монтируется как /data)
- Для программных установок: {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 не имеет влияния.
Была ли эта статья полезной?