重要的提醒

我們更新了 UniFi SDN 控制器以提高安全性。從 UniFi 控制器版本 5.10 開始，UAP/USW 所需的最低固件為4.0.9，USG 為 4.4.34。

早期固件上的設備將顯示在控制器中并按照您的配置工作，此更新不會更改任何設置。但請注意，在更新固件之前，您將無法修改設備配置。

此更新包含對 UniFi 平臺及其設備的整體安全性的升級我們還正在準備 5.6.41 以適應第一代 AC 設備。

我們收到反饋，簡體中文可能存在設備不顯示或者不采用。您可以切換成英文版本或者繁體中文版本。也可等我們公告修復后進行升級更新。

如何安全升級

請牢記在開始任何升級之前都做好備份，尤其是升級正在運行業務的網絡之前。

發行說明

與往常一樣，在升級之前進行備份。
對于從 v3 遷移的人來說，API 有很多變化，而且它不向下兼容。您可能需要更新 shell 庫（ unifi_sh_api ）和/或自定義門戶/外部門戶代碼。
Windows 用戶必須安裝 x64 Java 才能使用 unifi.ubnt.com 云接入服務，因為我們只支持 64 位webRTC 庫。請參閱此處并下載缺失的版本（64 位離線 Windows 安裝包）?？刂破髦荒茉?x86 環境下運行，或者在 x86 Java 環境下運行，如果在 x86 Java 環境下運行，綁定的 unifi.ubnt.com 將無效。
如果將 VLAN ID 設置為同一 AP 上另一個 SSID 的靜態值，則無法將 VLAN ID 重新用于動態 VLAN。因此，如果我將 SSID 設置為使用 VLAN 10，則我不能將 VLAN ID 10 用于 RADIUS 控制的 VLAN 用戶，因為這些用戶將無法獲得 IP。
智能隊列 QoS 與 EdgeOS 中的實現類似（參見此處）。值得注意的是，使用 QoS 時會影響最大吞吐量，因為流量不會被加速。上面鏈接的文章中有一些粗略的指導原則。
在國家代碼為美國時，DFS 信道不能被用于無線上行鏈路。如果您需要在雙頻 UAP 上使用無線上行鏈路，請使用非 DFS 頻道。
官方 UniFi MIB 可以從此處和此處下載（這是兩個不同的文件）。
對于熱點管理器，請確保您具有一個帶有站點 ID 的 URL 書簽（如： x66cipn3，或者任何該站點生成的隨機字符串）。例如：https://unifi.yourdomain.com:8443/manage/hotspot/site/SITE_ID
對于 Debian / Ubuntu用戶，請更新您的 APT 源（請參閱此處）。
unifi-beta / unifi-rapid已經過時。舊版已被刪除。
以下內容影響 APT 版本 1.5（Ubuntu 17.10 和 Debian Sid 或更新版本）。apt-secure手冊頁的最新版本聲明：“從版本 1.5 開始，版本文件中包含的有關存儲庫的信息更改必須在 APT 接著從存儲庫更新之前進行確認（Since version 1.5 changes in the information contained in the Release file about the repository need to be confirmed before APT continues to apply updates from this repository）”，這意味著當您從一個主要版本更新到下一個版本（例如從 5.6.x 到 5.7.x）的時候，apt-get update 將會發生錯誤。要解決此問題，請按以下方式執行命令： apt-get updateapt-get update --allow-releaseinfo-change
Linux / ARMv6 架構不支持此版本中的云接入功能（例如，Raspberry Pi 1）。如果您在此平臺上啟動控制器時遇到問題，請刪除這個本地庫：

sudo rm /usr/lib/unifi/lib/native/Linux/armhf/libubnt_webrtc_jni.so

從 5.7.x 版本之后，我們只支持 Java 8。現在我們暫時不支持 Java 9。
默認情況下，公平通信分時(airtime)、頻段引導、負載均衡和最小 RSSI 等功能被禁用（大部分使用場景我們都不建議開啟）。如果您確實需要的話，可以轉到設置 > 站點，并選中“啟用高級功能 ”。
如果您以前用過谷歌地圖作為站點地圖，那么您必須通過添加 API 密鑰來再次啟用此功能。您可以在設置 > 控制器下完成此操作。里面有一個含有詳細指示的操作指南的鏈接。
新的云接入要求出站 8883/tcp是開放且不受限制的。
Linux 系統必須運行 3.6.x 之前的 MongoDB 版本。我們建議您使用 3.4.x。這很可能是由 Ubuntu 18.04 LTS 導致的問題，因為它目前提供 MongoDB 3.6.x。
正確的密鑰庫別名和名稱是 `unifi`。如果自定義的 SSL 證書失效，請驗證正確的密鑰庫和別名。之前的錯誤并不影響`ubnt`工作，盡管這在技術上來講不正確。如果您在社區中發現了這些無效步驟，請指出它們，以便我們解決它們。
初始數據庫遷移將比平時花費更長的時間。在此過程中，您可能會遇到 mongo 占用大量甚至是全部的 CPU 利用率。請耐心等待，取決于您的歷史數據和系統配置內容大小，整個過程可能會耗時 15 分鐘以上。請您像以前一樣謹慎地對待您的數據，并在升級之前對它們進行備份。
如果將控制器設置成綁定到特權端口（<1024），則控制器不會被啟動，因為它現在以非 root 用戶身份運行。
如果您的控制器在 UniFi Cloud Key（UCK）上運行，請您確保其使用了 0.6.4 或更高版本的固件，否則無法啟動 UniFi 服務。該固件可通過控制器或其本地管理頁面中的常規升級機制來完成。請您確保在升級 UCK 固件之前先進行備份，因為您會需要在之后重新恢復它。并且，您最好在進行任何控制器升級之前都預先進行備份。
在 5.7.x 中刪除了對 PicoM2 和第一代 AC 模型的支持。請在此處查看我們的公告。
從發布分支 5.7.x 開始，我們對無線上行鏈路功能進行了一些重要更改（此處的功能詳細信息）。
應在有線 AP 上禁用此選項，但需要在無線 AP 上啟用此選項。
如果在下行鏈路/無線 AP 上禁用此選項，則 AP 將與網絡斷開連接并需要進一步操作（包括物理訪問）。
如果從 5.6> 5.7升級，則已在有線 AP上禁用此功能，但如果從早期的 5.7 升級。然后，可以在有線 AP 上啟用此功能。
同樣，應僅在下行鏈路/無線 UAP 上啟用此選項。不應在有線 UAP 上啟用它。
我們從無線上行鏈路中刪除了“啟用自動上行鏈路故障轉移”，因為不再需要它。
我們添加了選擇 AP 自動進行 Mesh 組網的功能。這可以通過選中設備屬性 > 配置 > 無線上行連接下 “允許網狀連接到另一個接入點”選項來完成。
我們添加了設置上行鏈路優先級的功能。這允許您為下行鏈路/無線 AP 指定首選上行鏈路。
固定 IP 地址（DHCP 保留）需要是唯一 IP 地址，同一 IP 無法被分配給多個設備。對于配置中已有 IP 重復的情況，USG 只會將固定 IP 分配到最近活躍的那臺設備上。控制器的 server.log 會包含一條日志消息：“跳過為用戶 [< MAC 地址>] 提供重復的固定 IP <IP 地址>” （skip provisioning duplicate fixed IP <IP address> for user[<MAC address>]），被忽略的那個 IP 代表發生沖突。
可用的升級路徑

<=5.10.11 | <=5.9.33 | <=5.8.30 | <=5.7.28 | <=5.6.40和大多數早期版本（退回 3.1.0）。此列表可能存在某些特定于版本的例外。
以上版本用于指示從最近發布的分支機構升級所支持的版本。只要您使用該版本或該分支中的早期版本，就可以（直接）升級到此版本。
如果您使用的是比上述版本更新的版本，那么您必須等到此版本更新，以便它支持從您正在運行的版本升級。
發布分支由前 2 個數字決定（如 5.10,5.9,5.8 等）。分支中的版本是最后一個數字。較新的版本由較高的數字表示，較早的版本由較低的數字表示。所有發布分支都從 .0開始（例如5.10.0,5.9.0 等）。您可以直接升級的最早版本是 3.1.0。如果您的控制器版本以 2.x 或 1.x 開頭，那么您需要升級到 3.x 才能升級到此版本。

已知問題

如果禁用無線射頻或沒有設置任何 SSID，airTime 將無法工作。這將在以后的版本中修復。如果啟用了無線射頻，airtime 仍然無法正常工作，則可能需要強制刷新清除緩存。
如果您在短時間內連續快速啟動 2.4GHz 和 5GHz 頻譜掃描，將會導致開啟出錯。
airView 偶爾會停止工作。關掉它并重新啟動就可以了。
如果您在 airView 運行時啟動 airTime 掃描，那么 airView 將會停止工作，您需要關閉并重新啟動它來使其再次運行。這個問題也會在將來被修復。
當語言選擇為簡體中文時，可能會出現設備顯示不正常的情況，這個問題會在將來被修復。
儀表板上的一些統計數據仍在開發中。請分享您的任何反饋！
如果 Web 界面沒有正確顯示，那么可能會是瀏覽器緩存問題。請強制刷新，這將清除任何緩存問題。謝謝！

新增功能

添加夜間模式
添加 WiFi 體驗評分
添加網絡和 WiFi 性能優化功能
添加用于啟用 syslog 和 netconsole 以登錄到本地控制器的選項。
添加 What's New 頁面
在對 UniFi SDN 控制器頁面將為我們的用戶提供我們一種視覺處理，很容易審查中控制器取得了新的更新What's New
根據設備功能配置交換機端口速度。

自 5.9.29 以來控制器錯誤修正/更改：

添加雙向防火墻規則以阻塞 IPS 檢測到的流量。
為設備添加不支持的狀態。
添加臨時固件更新。* UAP, UAP-LR, UAP-OD, UAP-OD5
為不支持的設備添加“采用和升級”操作。
添加 WAN 轉換事件/警報的圖標。
將 SIP 3261 非保留字符添加到 SIP 用戶名，擴展名和密碼字段。
添加固定vs內聯屬性面板首選項。
將繁體中文（ZH_TW）添加到語言列表中。
添加選項僅為高性能客戶端禁用 5GHz （自動優化網絡功能）。
為某些系統事件添加固件錯誤檢測標志。*
為啟用自動優化網絡功能添加事件。
將不可用的文本添加到統計信息概述模塊。
運行自定義升級時檢查最新固件。
用照片替換設備圖標。
為端口圖表使用新的樣式。
使表格中的操作按鈕變粘。
被阻止的客戶端不計入關聯失敗小組件。
在站點導入時包括手動站點到站點 VPN。
改進控制器向導。
提高相鄰接入點的準確性。
改進自動定位工具提示。
使用 UBNT 帳戶改進本地登錄的工具提示。
改進最活躍的 AP 小組件
改進向導中的導航
改善全局站點導航。
允許設置交換機端口名稱與配置文件名稱相同
將首選項作為用戶界面移至設置。
按鈕改進。
更新了事件和警報。
更新了數據監察和統計信息樣式。
更新了流量統計表樣式。
更新 UniFi 網絡的 logo 和標題。
更新了設備網格狀態欄。
更新了DPI 圖表UI。
AP 屬性面板 - RF 工具提示定位改進。
控制器更新可用彈出窗口 - 添加要忽略的選項。
在 WPA 企業級設置中修復 RADIUS 配置文件工具提示。
IPS 映射：更改語言后不會刷新國家/地區標簽。
在 UniFi Cloud Key（僅限第一代）上 MongoDB 大小超過 1.25GB 時生成事件。
修復防火墻組和靜態路由的有效 IPv6 地址的錯誤拒絕。
固件更新服務返回錯誤時修復固件緩存。
修復在升級控制器時可能阻止數據庫遷移的錯誤。
修復站點概述中的缺失的 logo。
頁面重新加載后修復空的屬性面板。
修正了當在低高度頁面上保持打開狀態時發行說明會彈跳的問題。
修復空 ISP 圖X軸刻度。
修復 USG 概述屬性面板中的移動溫度。
修復始終顯示有關不允許信道的警告。
修復設備表圖標填充。
修復最近版本的 Firefox 上的 WebRTC 功能。
修復各種文本溢出問題。
修復顯示錯誤值的客戶端歷史標簽。
修復已知客戶端的不一致性
在客戶端列表視圖中修復不正確的客戶端上行鏈路。
使用 PPPoE 和 DHCPv6 修復雙 DHCPv6-PD 節點。
修復壓縮數據庫z功能。
在查看詳情 / 交換機統計數據視圖中修復一些未翻譯的字符串。
在致命頁面上修復XSS。
修復 interim update interval 配置。
修復損壞的設備dist。模塊顏色選擇器。
修復“熱點管理器” > “付款和交易” > 單擊“付款”按鈕中的控制臺錯誤
修復nanoHD / In-Wall HD（以及可能的其他SKU）的批量編輯。
使用默認/較低日志級別時修復不可讀的控制器日志。
修復可能導致設備陷入采用狀態的問題。
修正當試圖采用USG時可能發生的NPE，以及每次從USG發出的通知。
修復添加客戶端表單中的驗證。
修復應用于其他屬性面板的 AP VLAN 切換。
修復長名稱重疊。
修復屬性面板中 USG 缺少的采用按鈕。
修復當從概述切換到應用程序時沒有DPI數據。
修復工具提示的位置和大小。
修復UniFi AP-BaseStationXG無法通過模型排序的問題
修復儀表板 DPI 模塊的圖標大小。
修復交換機端口配置文件標記網絡復選框上的間距。
修復使用自動優化網絡功能時的無線上行檢測
修復和改進數據庫處理以緩解大型數據庫的遷移問題（此處報告）。
修復切換小組件上不正確的 LAN 流量計數器
憑證打印。
修復在“設備”面板中顯示 Tx 和 Rx Radio 值的問題。
修復了使用一種射頻顯示 Wi-Fi 體驗的問題。
修復固件通知對齊。
修復 IPS 日期范圍。
修復采用多個 USG 的工具提示。
刪除連接到 WLAN 的用戶組時修復錯誤消息。
當沒有可用的 PoE 選項時，在交換機端口配置文件表單上隱藏 PoE 標簽。
airView 中的按鈕之間沒有邊距。
消除設備屬性中交換機功耗的模糊性。
切換 ISP 上傳/下載顏色。
端口使用小組件清理和組件化。
舊版（Svg）地圖 - 在應用動畫時將設備標記移動到左上角時為 Chrome 錯誤添加解決方法。
儀表板主要狀態：在沒有可用的 WiFi 體驗（即 0 個 AP）時修復案例，但顯示垂直分隔符。
為 STP 阻塞事件添加缺少的圖標。
防火墻：修復保存 IPv6 規則。
IPS：修復在某些情況下不正確的 Geo Location。
安全性改進。
各種錯誤修復和改進。

*此升級將在管理員通過控制器升級的任何設備上運行。它只能在 4.0.6 之前運行固件時提到的模型上運行。這些設備首先必須升級到 4.0.10，然后才能從那里升級到所需的 4.x 版本。

軟件定義網絡(Software Defined Network, SDN)在InfoWorld于2011年11月公布的將影響未來10年的十項新技術中排名第二。2012年7月，SDN代表廠商Nicira被 VMware以12.6億美元收購，隨后Google宣布成功在其全球10個IDC網絡中部署SDN，這促使SDN引起業界的強烈關注。到底SDN與傳統網絡架構有何區別？其帶來哪些顛覆性創新？

現有網絡中，對流量的控制和轉發都依賴于網絡設備實現，且設備中集成了與業務特性緊耦合的操作系統和專用硬件，這些操作系統和專用硬件都是各個廠家自己開發和設計的。

SDN是一種新型的網絡架構，它的設計理念是將網絡的控制平面與數據轉發平面進行分離，從而通過集中的控制器中的軟件平臺去實現可編程化控制底層硬件，實現對網絡資源靈活的按需調配。在SDN網絡中，網絡設備只負責單純的數據轉發，可以采用通用的硬件;而原來負責控制的操作系統將提煉為獨立的網絡操作系統，負責對不同業務特性進行適配，而且網絡操作系統和業務特性以及硬件設備之間的通信都可以通過編程實現。

如下圖所示，與傳統網絡相比，SDN的基本特征有3點：

控制與轉發分離。轉發平面由受控轉發的設備組成，轉發方式以及業務邏輯由運行在分離出去的控制面上的控制應用所控制。

控制平面與轉發平面之間的開放接口。SDN 為控制平面提供開放可編程接口。通過這種方式，控制應用只需要關注自身邏輯，而不需要關注底層更多的實現細節。

邏輯上的集中控制。邏輯上集中的控制平面可以控制多個轉發面設備，也就是控制整個物理網絡，因而可以獲得全局的網絡狀態視圖，并根據該全局網絡狀態視圖實現對網絡的優化控制。

SDN的典型架構共分三層，最上層為應用層，包括各種不同的業務和應用;中間的控制層主要負責處理數據平面資源的編排，維護網絡拓撲、狀態信息等; 最底層的基礎設施層負責基于流表的數據處理、轉發和狀態收集。SDN本質上具有“控制和轉發分離”、“設備資源虛擬化”和“通用硬件及軟件可編程”三大特性，這至少帶來了以下好處。

第一，設備硬件歸一化,硬件只關注轉發和存儲能力，與業務特性解耦，可以采用相對廉價的商用的架構來實現。

第二，網絡的智能性全部由軟件實現,網絡設備的種類及功能由軟件配置而定,對網絡的操作控制和運行由服務器作為網絡操作系統(NOS)來完成。