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 防禦

以下功能模組的 CLI 指令經過驗證有效，但請注意，其中部分指令仍可能與 GUI 設定衝突，請務必謹慎使用。

System
- System Info
- System Time
- LED
- PoE
- Time Range
L2 Features
- Port Config
- Port Isolation
- Loopback Detection
- LAG
- VLAN, except Protocol VLAN
- Multicast
- Spanning Tree
- LLDP
- PPPoE ID Insertion
L3 Features
- IPv4 Routing
- ARP
- Interface
- DHCP
QoS
- Class of Service
- Scheduler Settings
- Bandwidth Control
- Voice VAN
- Auto VoIP
Security
- 存取控制
- SSH/HTTPS/HTTP/Telnet/Serial Port Config
- AAA
- 802.1X
- Port Security
Maintenance
- Port Mirroring
- sFlow
- Ethernet OAM
- DLDP
- SNMP

1.3 重複設定

當透過 CLI 多次設定相同功能時，先前的設定可能會被覆蓋，以最後一次的設定為主。

a. 建議使用 CLI 設定檢視功能中的 “Show Running Config”，來確認目前生效的指令。

b. 如果您需要取消某個設定，請使用 “no” 指令。

c. 如果您需要修改特定設定，您可以輸入新的指令來覆寫該設定。

d. 套用最後設定，並透過 CLI 設定檢視功能確認該功能是否已正確設定且生效。

1.4 執行失敗

如果 CLI 指令執行失敗，會顯示錯誤並執行後續指令。您可以透過錯誤訊息查看錯誤詳細訊息，先前已經成功執行的命令則不會被取消。建議按照以下步驟進行操作：

a. 使用 CLI 設定檢視功能（Show Running Config）確認已生效的指令。如果需要取消它們，可以輸入“no”指令並將它們套用至設備。

b. 排除並更正錯誤的指令，重新產生 CLI 設定並將其套用至設備。

1.5 指令修改

如果您需要修改透過 CLI 發出的指令，請按照以下步驟進行：

a. 使用 CLI 檢視設定功能（Show Running Config）來確認已生效的指令，並整理需要取消的指令。

b. 輸入"no" 指令來取消設定，然後套用至設備。

1.6 禁止的指令

禁止修改使用者名稱和密碼、管理 VLAN、SDM 設定檔、重新啟動、重置、更新、匯入和匯出設定等 CLI 指令。使用其他 CLI 指令時，也請注意避免影響控制器的管理。

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	點選並選擇一個現有的指令檔檔案，以匯入指令行