UniFi - 解释 system.properties 文件

概览


系统属性(system.properties)文件位于 <unifi_base>/data 目录下,并用于定义 UniFi 控制器系统范畴的参数。 以下是在 system.properties 文件中针对 UniFi 控制器所支持的配置更改的几个值得注意的示例:

  • 手动覆盖控制器 IP 接口 (设备发送通知数据包的地址);
  • 高级数据库调整;
  • 最常见的是 端口分配,用于 UniFi 控制器与受管设备进行通信,重定向访客门户流量等。

该 system.properties 文件可以直接通过任何文本编辑器进行编辑。请记住,以 # 号开头的行是注释,不会运行。更改这个文件后需要重启 UniFi 控制器才能使这些设置生效。

注意:本贴为高级操作,不建议普通用户进行,您需要仔细考虑由此造成的不良后果

目录


  1. 默认端口
  2. 手动设置控制器通信的IP接口
  3. 高级数据库配置

默认端口


回到顶部

以下列举控制器常用的一些默认端口,要更改控制器和UAP的默认端口,可以参考链接文章的详细解释

  • unifi.shutdown.port=8081 # 用于管理目的
  • unifi.http.port=8080 # 设备通信
  • unifi.https.port=8443 # 控制器 UI / API
  • portal.http.port=8880 # 用于 HTTP 的门户重定向端口
  • portal.https.port=8843 # 用于 HTTPS 的门户重定向端口
  • unifi.db.port=27117 # 用于数据库服务器的本地绑定端口

手动设置控制器通信的 IP 接口


回到顶部

如果搭建控制器的设备具有多个 IP 接口,则以下配置可以手动设置采用 AP 应与控制器通信的确切 IP 接口:

  • system_ip=a.b.c.d # 用于通讯的 IP 设备

高级数据库配置


回到顶部

下面是数据库高级配置,我们希望大多数用户将永远不需要接触这些配置。我们还没有对这些配置进行测试,启用这些配置是为了方便数据库专家。有种可能使用场景就是些在 NAS 上运行控制器的用户,由于 NAS 比正常的服务器的容量更小,因此需要减少所需的资源。

  • unifi.db.nojournal=false # 禁用 mongodb 日志
  • unifi.db.extraargs # 额外的 mongod 参数

下面的配置用来方便控制器的安装。同样,大多数用户将永远不需要设置这个参数。is_default 设置为 true 时,控制器将开始出厂默认配置。对于普通的,日常用户,建议卸载,然后进行全新的重新安装,而不是设置这个参数。

  • is_default=false

(v3.1.7+)下面的配置用于修复之前的错误,在早期的 v3 版本中,控制器允许用户删除超级管理员帐户(在安装过程中创建的)并且这个超级管理员无法恢复回来。后来我们修复决这个问题(超级管理员不能被删除了)。然而,有些人可能无意中已经这么做到了,因此我们创建了下面的配置来允许提升一个超级管理员。我们估计大多数用户将永远不需要设置这个参数。

  • super_admin.name=account_id_to_be_promoted

(v5.1.0 +)自 v5.1.0 起,我们在控制器 UI 添加了自动备份功能。在 UI中 ,您可以配置备份频率,存储备份数量,备份时间等。在撰写本文时,您无法通过 UI 更改存储位置。如果您想更改存储位置,我们在system.properties 中有一个变量。目前默认指向:

1.对于 Cloud Key:/data/autobackup (默认情况下,SD 卡以 /data 方式装载)
2.对于软件安装:{data.dir}/backup/autobackup

  • autobackup.dir=/some/path

建议 UAP-AC-EDU 用本地控制器进行管理。目前,来自 EDU 移动应用程序的通信是从应用程序到控制器再到EDU。如果移动设备远离 EDU,我们只需打开相应的端口即可。如果控制器远离 EDU,则需要在 system.properties 中添加以下命令。

  • stream.playback.url.type=inform

(5.5.15 + / 5.6.7 +)我们已经为控制器添加了 HSTS 支持。请注意,默认情况下,它是处于禁用状态的。这应该只在你知道你在做什么时才能启用。这是一个 system.properties 值,所以在遇到问题时可以轻松禁用它。如果遇到问题,在禁用此项并重新启动服务后,您可能还需要清除浏览器的缓存。要启用 HSTS 支持,请添加以下内容:

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

目前,您还不能在自定义行之后添加任何字符,如空格,中英文符号/注释等。