UniFi-解釋 system.properties 文件

UniFi-解釋 system.properties 文件

系統屬性(system.properties)文件位於 /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

目前,您還不能在自定義行之後添加任何字符,如空格,中英文符號/註釋等。


分享到:


相關文章: