手動 ssh 接管 Unifi wifi ap

手動 ssh 接管 Unifi wifi ap

前言

如果你是 Ubiquiti UniFi 網路設備的愛用者，你可能也遇過這個經典場景：一次意外的斷電或跳電後，所有設備陸續恢復正常，唯獨某一台 AP 在控制台（UniFi Controller）上顯示「需要接管 (Adoption Pending)」，但無論你如何嘗試點擊接管、重啟 AP，甚至是用 SSH 登入後執行 set-inform，它就是無動於衷，始終無法成功納管。

這篇文章將分享我遭遇此問題的根本原因，以及如何透過「手動跨網段」的方式，將這台迷途的 AP 重新拉回正軌。

---

問題分析：為何 AP 會變成網路孤兒？

在深入研究後，我登入我的 UDM-SE 控制台，發現了問題的癥結點：

• 我的內網環境： 192.168.100.0/24
• UDM-SE (控制器) IP： 192.168.100.1
• 出問題的 AP 顯示 IP： 192.168.201.181

很明顯，這台 AP 不知道什麼原因，在重啟後取得了一個完全不同網段的 IP 位址 (192.168.201.x)。由於它與我的控制器 (192.168.100.1) 不在同一個子網路內，兩者無法直接通訊，導致控制器看得到它「發出的求救信號」，卻無法完成後續的接管程序。

---

解決方案：手動將 AP 拉回正確的網段

要解決這個問題，我們需要先「將錯就錯」，讓我們的電腦能與 AP 溝通，再手動把它設定回正確的網路。

步驟一：手動設定電腦 IP

首先，我們需要讓操作用的電腦進入 AP 所在的 192.168.201.x 網段。

1. 打開你電腦的網路設定。
2. 將 IP 設定從「自動取得 (DHCP)」改為「手動設定」。
3. 填入以下資訊 (記得先記下你原本的設定，方便事後改回來)：
   • IP 位址： 192.168.201.100 (或任何 192.168.201.x 網段未被使用的 IP)
   • 子網路遮罩： 255.255.255.0
   • 路由器/閘道器： 留空或填 192.168.201.1 均可，這一步影響不大。

步驟二：SSH 登入 AP

現在你的電腦已經和 AP 處於同一個網段，可以透過 SSH 連線了。

打開終端機或命令提示字元，輸入以下指令登入 AP (預設帳號密碼通常是 ubnt/ubnt，或使用你自行設定的 SSH 帳密)：

ssh [email protected]

步驟三：執行關鍵指令

成功登入後，我們要執行一個核心指令，一次性地告訴 AP「該去哪裡報到」以及「自己的新地址是什麼」。

將以下整串指令複製並貼上執行：

set-inform http://192.168.100.1:8080/inform && ifconfig br0 192.168.100.15 netmask 255.255.255.0 && route add default gw 192.168.100.1

指令詳解：

• set-inform http://192.168.100.1:8080/inform: 強制 AP 向你的 UDM-SE 控制器 (192.168.100.1) 進行回報。
• ifconfig br0 192.168.100.15 netmask 255.255.255.0: 立刻將 AP 自身的 IP 位址修改為 192.168.100.15 (請確保此 IP 在你的內網中是可用的、未被佔用的)。
• route add default gw 192.168.100.1: 同時，設定 AP 的預設閘道器為你的 UDM-SE。
• &&: 串接指令，確保它們依序執行。

執行後，你會馬上與 AP 斷線，這是正常的，因為它的 IP 已經變了。

步驟四：完成接管與還原設定

1. 回到你的 UDM-SE 控制台介面，你會發現該 AP 現在顯示的 IP 是 192.168.100.15，並且處於可以接管的狀態。點擊「接管 (Adopt)」即可順利完成。
2. 別忘了！ 將你電腦的網路設定改回「自動取得 (DHCP)」，恢復正常上網。

---

結論

UniFi AP 偶爾會因斷電等因素導致網路設定錯亂，跑到奇怪的網段。遇到這種情況時，標準的 set-inform 指令會因為網路不通而失效。核心解法就是「手動建立臨時通道」，先讓自己能與 AP 對話，再強制把它拉回正確的網路設定。希望這個經驗能幫助到遇到同樣問題的你！