Omada SDN 控制器 CLI 設定指南（v5.9.9 或更高版本）

從版本 5.9 開始，Omada SDN 控制器支援了 CLI 設定功能，這允許您使用 CLI 建立和發布設定文件。這個功能被設計成一種備用方案，當一些功能或設定在 GUI 上不能使用或是設定時，可以使用 CLI 來實現。

Omada SDN 控制器支援兩種類型的 CLI 設定：站點 CLI 和設備 CLI。

■ 站點 CLI：設定檔將發佈到所有支援 CLI 設定的設備。

■ 設備 CLI：設定檔將發佈到支援 CLI 設定的選定設備。

目前，僅 Omada 交換器支援 CLI 設定。有關 Omada 交換器的 CLI 指令的更多訊息，請參閱 CLI 參考指南。

在使用 CLI 設定之前，請務必仔細閱讀以下注意事項和使用指南，以避免發生意外錯誤。如果您遇到任何問題，可以聯繫 TP-Link 技術支援。

 

1. 注意事項

1.1 一般注意事項

1. GUI 和 CLI 的設定應根據實際網路拓樸和需求進行整體規劃。

2. 請不要使用 CLI 來設定 GUI 上已有的功能，因為這可能會導致衝突並使裝置的設定結果與您期望不同。

a. 在使用新設備時，控制器將按照 GUI、站點 CLI，然後是設備 CLI 的順序對設備進行設定。如果存在設定衝突，則以最後套用的設定為主。

b. CLI 設定檔（包括站點 CLI 設定檔和設備 CLI 設定檔）在儲存後只能對設備套用一次，除非在應用結果中按下 "再次套用"，以觸發完整的應用設定。

c. 當設備升級其韌體時，控制器將按照 GUI、站點 CLI、然後設備 CLI 的順序將完整設定套用到設備。

d. 請注意，後面的設定可能會覆蓋前面的設定，導致透過 GUI、站點 CLI 或設備 CLI 多次修改相同功能後，不同設備會有不同的運行設定。

3. Omada Controller不會驗證設備的現有 GUI 和 CLI 設定。在執行新設定之前，請務必檢查現有設定。否則，套用設定後可能會出現預期外的結果，甚至可能導致設備離線。

4. 為避免設定衝突，如果您確定要使用 CLI 設定某項功能，建議您不要同時透過 GUI 進行設定。

5. 為避免因設定錯誤或衝突而導致設備與控制器斷開連線，建議僅透過 GUI 設定 VLAN、VLAN 介面、IP 位址、ACL 等，避免透過 CLI 修改這些相關設定。

 

1.2 無法生效的指令

請注意，在控制器模式下，由於硬體資源分配的原因，某些指令可能會無法正常運作。 即使包含了這些指令的 CLI 設定檔可以正確套用並在執行設定中列出，它們也可能不會生效，因為設備沒有硬體資源來執行它們。

以下功能模組的 CLI 指令無法設定或生效，應該避免使用：

• 協定 VLAN
• L2PT
• ERPS
• MAC/IP/封包內容/IPv6 ACL
• IPv4 IMPB
• IPv6 IMPB
• DHCPv4 過濾器
• DHCPv6 過濾器
• DoS 防禦

 

2. 站點 CLI

概述

站點 CLI 可以透過指令對站點上所有支援 CLI 設定的設備進行批次設定。

設定

1. 前往 設定 > CLI 設定 > 站點 CLI。

2. 點選 建立新的站點 CLI 設定檔 並根據您的需求建立 CLI 設定檔。

 說明：

• # 是一個特殊指令，表示進入設定模式，請在獨立的行列中進行設定，若您新增其他指令於同行列中，他們將視為無效。 • 如果指令以 ! 開頭，指令便無效。

 

名稱	指定 CLI 設定檔的名稱
描述	(選填) 輸入標示說明
CLI	手動輸入指令
從設備匯入 CLI	點選並選擇一台支援 CLI 設定的設備，以匯入其目前運行中的設定
從檔案匯入 CLI	點選並選擇一個現有的指令檔檔案，以匯入指令行

3. 按一下 儲存 以新增設定檔。新設定檔處於未啟用狀態，不會套用至設備。

4. 點選 套用 以套用 CLI。個人資料將變為啟用狀態並將設定套用於站點上所有支援 CLI 設定的設備。

說明：

一旦設定檔啟動，您將無法對其進行編輯。

如需檢查設定檔是否成功套用到設備並生效，請在 設備 > 應用結果 頁面按一下 查看 CLI 詳細資訊 查看設定結果。

說明：

刪除 CLI 設定檔對設備上現有的設定不會生效。要刪除這些設定，請使用  "no" 指令。

 

3. 設備 CLI

概述

設備 CLI 允許透過命令列對特定設備進行批次設定。

設備的 CLI 支援變數。您可以使用 %x% 格式來定義一個變數 x，然後為不同的交換器設定不同的值。當控制器將設備 CLI 設定套用到交換器時，它會自動將變數 %x% 修改為您設定的值。

設定

1. 前往 設定 > CLI 設定 > 設備 CLI。 按一下 建立新設備 CLI 設定檔 並根據您的需求建立 CLI 設定檔。

說明：

• # 是一個特殊指令，表示進入設定模式，請在獨立的行列中進行設定，若您新增其他指令於同行列中，他們將視為無效。 • 如果指令以 ! 開頭，指令便無效。

 

名稱	指定 CLI 設定檔的名稱
描述	(選填) 輸入標示說明
CLI	手動輸入指令。您可以在 CLI 模板輸入 %xxx% 定義變數。
從設備匯入 CLI	點選並選擇一台支援 CLI 設定的設備，以匯入其目前運行中的設定
從檔案匯入 CLI	點選並選擇一個現有的指令檔檔案，以匯入指令行

2. 點擊 下一步。 選擇要套用 CLI 設定檔的設備。

3. 按一下 儲存 以新增設定檔。新設定檔處於未啟用狀態，不會套用至設備。

4. 點擊 套用 以套用此 CLI。設定檔將變更為啟動狀態並將設定套用到您選擇的設備。

說明：

一旦設定檔啟動，您將無法對其進行編輯。

如需檢查設定檔是否成功套用到設備並生效，請在 設備 > 應用結果 頁面按一下 查看 CLI 詳細資訊 查看設定結果。

說明：

刪除 CLI 設定檔對設備上現有的設定不會生效。要刪除這些設定，請使用  "no" 指令。