將 UniFi Controller 從 Mac Mini 遷移到 Cloud Gateway Max 的步驟

將 UniFi Controller 從 Mac Mini 遷移到 Cloud Gateway Max 的步驟

將 UniFi Network Application（控制器）從 Mac Mini（自託管軟體版本）遷移到 Cloud Gateway Max 的過程，主要依賴備份還原（Backup and Restore）。這是官方推薦的方法，能保留您的網路設定、VLAN、SSID、防火牆規則等配置，而無需重新採用所有設備（如 AP、交換器）。整個過程通常只需 30-60 分鐘，但請在非高峰期進行，以避免中斷。

前置條件與注意事項

• 版本相容性：確保 Mac Mini 上的 UniFi Network Application 版本與 Cloud Gateway Max 上的版本相同或較舊（新版可向下相容）。遷移前，先在 Mac Mini 更新控制器至最新版（從 ui.com/download/unifi 下載 macOS 版本）。
• 備份類型：使用「Network Application Backup」（.unf 檔案），這只包含 Network 應用設定。如果您還使用 Protect（攝像頭）或 Talk 等其他應用，請分別備份。
• 警告：
  • 遷移後，設備會自動連接到新控制器，但若有 Layer 3 採用（跨 VLAN），可能需手動調整 Inform URL。
  • Cloud Gateway Max 會取代您的路由器（如有 USG），需手動配置路由相關設定（如 DHCP、防火牆），因為軟體控制器不支援這些。
  • 備份不包含自訂腳本或第三方整合；若有，需手動重置。
  • 斷開舊控制器後，設備若未自動切換，可能需在舊控制器「Forget」設備。
• 工具：瀏覽器、SSH（選用，用於進階調整）。

詳細步驟

以下步驟基於 Ubiquiti 官方文件與使用者經驗（如 Reddit r/Ubiquiti 討論）。

1. 備份當前設定（在 Mac Mini 上）：
   • 開啟 UniFi Network Application（透過瀏覽器登入：通常為 http://localhost:8443 或您的 Mac IP）。
   • 前往 Settings > System > Backups（或舊版介面：Settings > Maintenance > Backup）。
   • 點擊 Download Backup，選擇「Full Backup」或「Configuration Only」（推薦全備份，包含統計資料）。
   • 儲存 .unf 檔案到安全位置（如 USB 或雲端）。檔案大小約 1-10 MB，視設定複雜度而定。
   • 驗證備份：可上傳到測試環境檢查是否完整。
2. 準備 Cloud Gateway Max：
   • 開箱後，使用隨附電源與乙太網路線連接。
   • 將 WAN 埠（Port 5）連接到您的 modem 或現有網路（DHCP 取得 IP）。
   • 透過手機 App（UniFi Network App）或瀏覽器（預設 IP：192.168.1.20 或使用 App 掃描）開始初始設定。
   • 更新韌體：登入後，前往 Settings > Updates，安裝最新 UniFi OS（需 3.1+ 版本）。這可能需 10-20 分鐘重啟。
   • 重要：若要最小干擾，可將 Cloud Gateway Max 的 LAN IP 設定為與舊控制器相同（預設 192.168.1.1，若衝突則調整）。
3. 還原備份到 Cloud Gateway Max：
   • 在初始設定或登入後，前往 Settings > System > Backups（或 Control Plane > Backups）。
   • 點擊 Restore Backup，上傳從 Mac Mini 下載的 .unf 檔案。
   • 確認還原：系統會自動套用設定，重啟約 5-10 分鐘。
   • 登入新控制器，檢查 Devices 清單：您的 AP、交換器等應顯示「Connected」。
4. 切換設備管理（Inform Host 調整）：
   • 保持所有 UniFi 設備連接到現有網路（勿斷開）。
   • 在 Cloud Gateway Max 上，前往 Settings > System > Advanced > Inform Host，記下其 IP（例如 192.168.1.1）。
   • 返回 Mac Mini 舊控制器，前往 Settings > System > Advanced，將 Inform Host 改為 Cloud Gateway Max 的 IP。這會讓設備開始向新控制器報告。
   • 等待 5-10 分鐘，所有設備應自動採用（Adopt）。若未發生：
     • 在舊控制器上，選取每個設備 > Forget Device。
     • 在新控制器上，手動 Adopt 設備（點擊 Adopt 按鈕）。
   • 若使用 SSH 進階調整：在設備上執行 set-inform http://<新 IP>:8080/inform（需啟用 SSH）。
5. 移除舊控制器並驗證：
   • 一旦所有設備在 Cloud Gateway Max 上線（綠燈），斷開 Mac Mini 的 UniFi 應用（停止服務或卸載）。
   • 在 Cloud Gateway Max 上，檢查 Insights > Known Clients 和 Networks，確保流量正常。
   • 測試功能：連線 Wi-Fi、存取網路、檢查日誌（Settings > System > Logs）。
   • 若有 Protect 應用：分別備份並還原（.ubk 檔案），步驟類似。
6. 後續優化：
   • 配置 Cloud Gateway Max 特定功能：如 Multi-WAN、PoE（若適用）、或新增儲存（NVMe SSD）。
   • 啟用雲端備份：Settings > System > Backups > Auto Backup，設定雲端同步。
   • 若遷移失敗：工廠重置 Cloud Gateway Max（按住重置鈕 10 秒），重新還原備份。

常見問題排除

• 設備未顯示：重啟設備或檢查防火牆（確保 UDP 10001 埠開放）。
• 版本不符：若還原失敗，先更新新裝置至舊版，然後升級。
• 無路由功能：Cloud Gateway Max 內建路由器，遷移後需手動設定 WAN/LAN（Settings > Networks）。

此過程 99% 情況下無需重置設備。若您的設定複雜（如多站點），建議先在測試環境試遷移。更多細節可參考 Ubiquiti 官方備份指南。