管控台用戶手冊

# 前言

本文檔為金蝶Apusic分佈式緩存（AMDC）V2.0.5管控台產品的用戶手冊，詳細介紹 AMDC產品Web管控台的功能使用、配置方法及管理操作等內容。

本文檔基於當前 amdc-console 代碼及實際部署環境（http://172.17.47.213:3001/），使用 AMDC管理員 角色進行截圖與功能驗證；原有截圖與文字主體保留，僅調整與實際菜單不符的路徑說明。其他角色（系統管理員、安全管理員、審計管理員、租戶管理員）的菜單範圍可能不同，請以實際登錄角色為準。圖片若與當前界面存在差異，詳見文末「待確認圖片清單」。

# 適用對象

本文檔適用於AMDC產品運維工程師、IT系統運維工程師、開發工程師等人員。

# 相關文檔

了解更多AMDC V2.0.5產品相關的信息，請參閱以下AMDC V2.0.5產品手冊文檔集：

序號	手冊文檔	說明
1	金蝶Apusic分佈式緩存 V2.0.5 快速使用手冊	簡單介紹了如何快速上手使用AMDC 。
2	金蝶Apusic分佈式緩存 V2.0.5 安裝手冊	詳細介紹如何在各操作系統上安裝AMDC，以及AMDC服務啟停操作，產品的註冊過程。
3	金蝶Apusic分佈式緩存 V2.0.5 緩存核心用戶手冊	詳細介紹 AMDC 相關功能的使用、配置、管理及配套工具的使用方法。
4	金蝶Apusic分佈式緩存 V2.0.5 管控台用戶手冊	詳細介紹AMDC管控台相關功能的使用和操作說明。
5	金蝶Apusic分佈式緩存 V2.0.5 開發手冊	詳細介紹基於各開發語言進行AMDC客戶端應用開發的說明。
6	金蝶Apusic分佈式緩存 V2.0.5 遷移手冊	詳細介紹AMDC歷史版本遷移升級到V2.0.5版本的說明，以及Redis遷移到AMDC的說明。
7	金蝶Apusic分佈式緩存 V2.0.5 運維手冊	詳細介紹AMDC的監控、運維、安全加固等運維說明。
8	金蝶Apusic分佈式緩存 V2.0.5 性能優化手冊	詳細介紹AMDC性能調優的說明。

# 技術支持

AMDC產品提供全面的技術支持服務，您可以通過以下方式獲得技術支持：

網址：www.apusic.com
電話：400-855-5800
郵箱：support@apusic.com
金蝶雲社區：https://vip.kingdee.com/?productId=73&productLineId=14&lang=zh-CN

您在取得技術支持時，請提供如下信息：

您的姓名
公司信息與聯繫方式
操作系統及其版本
產品版本號
出現異常及錯誤的日誌、截圖等詳細信息

# 簡介

金蝶Apusic分佈式緩存軟件（Apusic In-Memory Data Cache，簡稱：AMDC），一款完全泛場景適用、高吞吐量、數據安全的分佈式緩存軟件，為大規模、高並發、高可用的關鍵應用提供安全可靠的緩存支撐能力；並兼容Redis協議與持久化數據文件，實現簡單快捷平穩替換Redis。

# 功能清單

# 管控台

功能	功能說明
多租戶管理	使用多租戶模型對不同業務或者管理團體進行數據隔離。
權限控制	提供功能使用權限控制，提高管控台安全性。
多集群管理	支持多集群的集中管理、節點啟停、節點彈性伸縮、配置等功能。
監控告警	提供緩存監控功能，檢測緩存狀態，並在緩存核心異常時發出告警通知。
數據分析	提供緩存數據big keys、hot keys、slowlog等數據分析功能。
自動部署	實現了AMDC數據緩存引擎的自動部署功能，系統自動完成全過程，更快更簡單。
可視化擴縮容	提供可視化的擴容/移除節點操作，沒有繁瑣的命令操作。
部署任務	部署過程/擴縮容過程可視化，可在任務列表查看進度與狀態。

# 相關概念

名詞	含義	使用說明
主節點	存儲數據，負責數據讀寫，負責數據同步	AMDC的默認模式，單機模式，單機模式下，主節點為單機模式
從節點	從主節點複製數據，參與數據同步（只讀）	從節點參與數據同步（只讀），當主節點故障時可自動切換為主節點，當主節點恢復時，從節點自動切換為從節點。
哨兵	監控主從節點，負責主節點故障轉移，負責主從節點同步	哨兵模式，當主節點掛掉時，自動切換為從節點，當從節點掛掉時，自動切換為主節點。
集群	由多台相互獨立的計算機組成的計算機服務系統	在本文中，主從/哨兵/集群三種模式都可以算是集群，集群模式特指多主節點數據分片存儲的模式。

# 新服務上線完整流程

下面以 AMDC 管理員 視角，演示一條完整的服務上線、升級與遷移操作流程。按本流程操作，一名不了解管控台的實施人員也能獨立完成部署、驗證、升級與遷移。

# 登錄控制台

打開瀏覽器，訪問 http://<serverIP>:3001/，進入登錄頁面。
輸入賬號 amdc_admin 和對應密碼：
- 管控台首次啟動時，會自動生成所有預置管理員賬號的初始密碼（包括 amdc_admin、三員管理員及租戶管理員），並寫入安裝目錄下的 ./resource/.initial_passwords 文件。
- 打開該文件，找到 amdc_admin: 後的 12 位隨機密碼作為首次登錄密碼。
- 首次登錄成功後，系統會強制要求按當前密碼策略修改密碼，修改完成後方可進入控制台主界面。密碼過期後再次登錄也會觸發強制修改。
點擊【登錄】進入控制台首頁。

登錄頁面

說明：本文檔後續操作均基於 AMDC 管理員 角色。其他角色（系統管理員、安全管理員、審計管理員、租戶管理員）的菜單範圍可能不同，請以實際登錄角色為準。

# 1. 資源準備

部署服務前，必須先在【資源管理】中準備好安裝包、License、機器和配置模板。

# 1.1 添加上傳安裝包

進入左側菜單【資源管理】>【安裝包管理】。
點擊右上角【上傳】按鈕，選擇目標版本的 AMDC 安裝包文件（如 AMDC-V2.0.5-xxxx-amd64.tar.gz）。
點擊【確定】完成上傳。

安裝包管理

# 1.2 上傳 License

進入左側菜單【資源管理】>【證書管理】。
點擊【上傳】按鈕，選擇有效的 License 文件，可同時上傳多個。
上傳後系統會自動解析，無效的 License 將無法保存。

License 管理

# 1.3 添加目標機器

進入左側菜單【資源管理】>【機器管理】。
點擊左側機器組旁的【+】按鈕，先創建一個機器組。
選中機器組，點擊左上方【添加】按鈕，填寫遠程服務器信息：

參數名	示例值	說明
用戶名	root	登錄遠程機器的用戶名
密碼	-	登錄遠程機器的密碼
SSH 端口	22	遠程 SSH 端口
Host	172.17.47.213	遠程機器 IP
備註	-	可選

確認目標機器連接狀態正常後再進行後續部署。

注意：同一個機器組只能添加相同架構芯片的機器；自動部署需要目標機器具備 tar、ss 命令。

機器管理

# 1.4 確認配置模板

進入左側菜單【資源管理】>【配置模板】。
確認已有緩存核心配置模板和哨兵配置模板（如使用哨兵模式）。
若需要自定義，可在此修改；與 IP、端口相關的非公共參數不會生效。

配置模板

# 2. 自動部署新服務

資源準備完成後，進入【部署管理】>【自動部署】，按 4 步嚮導完成服務部署。

自動部署基礎配置

# 2.1 基礎配置

在【基礎配置】步驟填寫：

服務名稱：唯一標識，僅支持英文、數字、下劃線、中劃線，不超過 24 個字符。
部署模式：選擇單機 / 主從 / 哨兵 / 集群 / 預生成節點。
安裝包：選擇已上傳的安裝包。
安裝目錄：如 /data/looper，節點實際位於 {seat}/{port}。
AMDC 密碼：緩存核心管理密碼，可點擊設置按鈕配置複雜度規則。
開機自啟：是否隨系統啟動自動運行。
sudo：是否使用 sudo 權限執行安裝命令。

自動部署其他設置

# 2.2 拓撲配置

選擇【自動】或【手動】拓撲模式：
- 自動：系統自動分配端口和節點角色，只需選擇機器和授權。
- 手動：逐節點配置機器、端口、角色和授權。
配置端口範圍（默認 6359–65535）和節點數量。
在【機器與授權】區域選擇目標機器，並為每台機器選擇 License 授權。

注意：所有機器需在同一機器組下；非哨兵節點必須選擇授權。

自動部署拓撲配置

# 2.3 配置模板

選擇緩存核心配置模板；若部署模式為哨兵，還需選擇哨兵配置模板。

# 2.4 確認部署

確認部署信息無誤後，點擊【執行任務】立即部署，或點擊【保存任務】僅保存待後續執行。
部署過程中可進入【部署管理】>【部署任務】查看任務狀態。
等待任務狀態變為「完成」。

部署任務

# 3. 服務驗證與監控

部署完成後，進入【部署管理】>【服務列表】查看新生成的服務。

服務列表

點擊服務名稱進入服務詳情。
點擊【監控】查看集群運行指標（內存、QPS、連接數等）。

服務監控

點擊【分析】進行 big keys、hot keys、slowlog 等數據分析。

數據分析

點擊頂部【命令行】按鈕，可執行 AMDC 命令驗證數據寫入/讀取。

# 4. 服務升級

當需要升級到新版本時：

在【資源管理】>【安裝包管理】中上傳新版本安裝包。
進入目標服務詳情，點擊頂部【升級回退】>【升級】，打開「集群升級」抽屜。
仔細閱讀升級說明：
- 升級會停止整個集群並替換二進制，期間集群不可用。
- 升級失敗時，系統會自動從備份回滾到升級前版本。
- 僅支持同版本或更高版本升級。
- 升級前會自動備份節點數據，請確保各節點磁盤空間充足。
在列表中選擇要升級到的安裝包，點擊【確認升級】。
等待升級任務完成，可在【部署管理】>【部署任務】或監控中心觀察狀態。

集群升級

# 5. 平滑遷移（可選）

若需將服務遷移到新硬件或新集群：

進入目標服務詳情，點擊頂部【集群運維】>【平滑遷移】，打開「集群遷移」彈窗。
在【填寫目標信息】步驟中，點擊【創建目標節點】，通過自動部署嚮導創建目標節點；創建完成後系統會自動回填目標 IP/Port/密碼。
點擊【下一步】進入【確認遷移】，閱讀遷移風險提示：
- 遷移過程中源集群將有短暫寫入凍結（約 30 秒）。
- 遷移完成後業務訪問 IP/端口會發生變更。
- 哨兵模式下哨兵節點不參與遷移，遷移後需檢查哨兵配置。
確認信息無誤後，點擊【確認遷移】，系統會自動完成增量同步與切換。
切換完成後，及時更新客戶端連接配置。

平滑遷移

# 6. 刷新節點

升級或遷移後，若控制台展示的節點信息與實際集群不一致：

進入目標服務詳情，點擊頂部【集群運維】>【刷新節點】。
在彈窗中查看節點變化對比結果（當前記錄節點數、實際探測節點數、變化說明）。
點擊【確認刷新】同步節點元數據。

刷新節點

# 7. 日常運維

告警：在【告警】>【告警通道】/【告警規則】中配置通知方式與閾值。
日誌切割：進入服務詳情 >【集群運維】>【日誌切割】，配置日誌保留天數和單文件大小限制。
備份恢復：進入服務詳情 >【數據管理】，定期執行數據備份，必要時執行恢復。
擴容/縮容：進入服務詳情，點擊【擴容】增加節點；選中節點後通過【節點操作】>【移除】減少節點。

# 環境準備與資源管理

在創建或運維 AMDC 服務之前，需要先在【資源管理】中準備好以下資源。

# 機器管理

進入【資源管理】>【機器管理】，機器管理頁面提供新增、編輯、刪除機器的功能入口。自動部署所需要的機器信息將在這裡進行創建。

# 新增機器

進入【資源管理】>【機器管理】，需要先有機器組才能新增機器，同一個機器組只能添加相同架構芯片的機器。點擊左側機器組旁的【+】按鈕新增機器組；選中機器組後，點擊左上方【添加】按鈕，填寫機器信息。

備註：只能新增連接正常的服務器，因此請確認目標機器連接狀態。

參數名	含義
用戶名	登錄遠程機器的用戶名，如：root
密碼	登錄遠程機器的密碼
ssh端口	登錄遠程機器的端口，如：22
Host	遠程機器的地址，如：192.168.x.x（示例IP，請替換為實際IP）
備註	可以為空

# 刪除機器

點擊【資源管理】>【機器管理】進入機器管理頁面，勾選需要刪除的機器，點擊機器列表右側【刪除】按鈕，即可刪除當前行機器，支持批量刪除。

# 編輯機器

點擊【資源管理】>【機器管理】進入機器管理頁面，勾選需要編輯的機器，點擊機器列表右側【編輯】按鈕，即可編輯當前行機器信息。

# 資源管理

資源管理用於存放 AMDC 的安裝包以及 License 文件，上傳的文件會經過管控的初步校驗以確定其可用性，並在自動部署中選擇使用。

說明：當前 AMDC 管理員菜單中，安裝包、License、機器、配置模板統一放在【資源管理】下。版本管理在當前菜單中未直接展示，若入口有變更請以實際菜單為準。

# 安裝包管理

進入【資源管理】>【安裝包管理】，用於上傳自動部署使用的安裝包。

上傳安裝包

點擊【上傳】按鈕，打開上傳安裝包的彈窗，點擊【選擇文件】來選擇需要上傳的安裝包，再點擊確定即可。

每次只能上傳一個安裝包，可以指定安裝包類型（c 或者 go）。

刪除安裝包

選中需要刪除的安裝包，點擊左上角【刪除】按鈕即可，支持同時刪除多個。

# License 管理

進入【資源管理】>【證書管理】，用於上傳自動部署使用的 License，上傳後 License 會被解析，無效的 License 將無法保存在管控台。

上傳 License

點擊【上傳】按鈕，打開上傳 License 的彈窗，點擊【選擇文件】來選擇需要上傳的 License 文件，再點擊確定即可，可同時上傳多個。
刪除 License

選中需要刪除的 License，點擊左上角【刪除】按鈕即可，支持同時刪除多個。

# 生成授權中心文件

在 License 管理頁面，點擊【生成授權中心文件】按鈕，可生成 acls.properties 授權中心配置文件，用於集群的 ACL 授權場景。

# 版本管理

版本管理用於查看和管理已部署 AMDC 實例的版本歷史，支持對實例進行版本回退操作。當前菜單入口請以實際部署環境為準。

# 配置模板

點擊【資源管理】>【配置模板】進入配置模板頁面，在該頁面中可以定義緩存核心、哨兵的配置模板，並在【自動部署】中使用該模板。

注意：與 IP、端口等非公共參數將不會在配置模板中生效，以保證自動部署的正常工作。

# 核心操作流程

本節按實際運維任務組織，介紹如何在控制台完成服務的全生命週期操作。

# 自動部署新服務

AMDC 管理員路徑：【部署管理】>【自動部署】

進入【自動部署】頁面後，按 4 步嚮導填寫部署信息：

基礎配置：服務名稱、部署模式、安裝包、安裝目錄、AMDC 密碼、sudo、開機自啟等。
拓撲配置：選擇自動/手動拓撲，配置節點數量、端口範圍、機器和 License 授權。
配置模板：選擇緩存核心配置模板（哨兵模式還需選擇哨兵配置模板）。
確認部署：確認信息後保存任務或直接執行。

填寫完成後，可點擊【保存任務】僅保存到【部署管理】>【部署任務】，或點擊【執行任務】立即開始部署。部署進度和狀態在【部署管理】>【部署任務】中查看。

前提條件：

已在【資源管理】>【機器管理】中添加目標服務器，且 SSH 連接正常。
已上傳安裝包（【資源管理】>【安裝包管理】）。
已上傳 License（【資源管理】>【證書管理】）。
目標服務器具備 tar、ss 命令。

基礎配置參數：

參數名	含義
服務名稱	服務唯一標識，僅支持英文、數字、下劃線、中劃線，不超過 24 個字符
部署模式	單機 / 主從 / 哨兵 / 集群 / 預生成節點
安裝包	選擇已上傳的 AMDC 安裝包版本
安裝目錄	服務安裝的根目錄（seat），如 `/data/redis`；節點實際位於 `{seat}/{port}`
AMDC 密碼	緩存核心管理密碼，點擊設置按鈕可配置複雜度規則
sudo	是否使用 sudo 權限執行安裝命令
開機自啟	服務是否隨系統啟動自動運行

自動部署基礎配置

可以通過開機自啟選項，實現部署完成之後服務的開機自啟動

自動部署其他設置

密碼後面的設置進入密碼格式要求設置界面，進行密碼複雜度和長度的設置

拓撲配置參數：

參數名	含義
拓撲模式	自動：系統自動分配端口和角色；手動：逐節點配置機器、端口、角色和授權
可用端口範圍	自動分配節點服務端口的起止端口，默認 6359–65535
主節點數	主節點數量，集群模式至少需要 3 個
從節點數	每個主節點對應的從節點數
哨兵節點數	哨兵模式專用，建議 3 個以上保證高可用
機器與授權	選擇部署機器，並為機器（非哨兵節點）選擇 License 授權；所有機器需在同一機器組下

自動部署拓撲配置

# 自動部署單機模式

控制台自動部署前請確保目標服務器連接正常，目標服務器已添加至機器列表中（參考機器管理），目標服務器具備 tar 命令、ss 命令。

操作步驟：

在基礎配置中選擇【單機】模式，主節點默認為 1、從節點默認為 0。
在拓撲配置中選擇機器並分配 License。
確認部署信息後點擊【安裝】按鈕，進行一鍵部署。

驗證自動部署結果：點擊【部署管理】>【服務列表】菜單，查看集群是否生成，並且狀態為健康。可以使用【命令行】做進一步的驗證。

# 自動部署主從模式

控制台自動部署主從模式前請確保目標服務器連接正常，目標服務器已添加至機器列表中（參考機器管理）。

操作步驟：

在基礎配置中選擇【主從】模式，根據頁面內容選擇 AMDC 核心安裝包和 License。
在拓撲配置中選擇機器、配置主從節點數量並分配 License。
點擊【安裝】即可自動實現主從部署。

# 自動部署哨兵模式

控制台自動部署哨兵模式前請確保目標服務器連接正常，目標服務器已添加至機器列表中（參考機器管理）。

操作步驟：

在基礎配置中選擇【哨兵】模式。
在拓撲配置中選擇機器、配置主從節點與哨兵節點數量並分配 License。
在配置模板步驟中選擇哨兵配置模板。
點擊【安裝】即可自動實現哨兵部署。

# 自動部署預生成節點模式

預生成節點用於平滑遷移等場景：提前部署好集群節點但不加入集群（不執行 CLUSTER MEET），供遷移時直接切換使用。

操作步驟：

在基礎配置中選擇【預生成節點】模式。
按集群模式配置節點數量、機器和授權。
執行部署後，節點處於待用狀態，後續可在【平滑遷移】中選擇使用。

# 導入已有集群或單機

對於不在控制台部署的AMDC緩存核心，可以導入控制台實現在控制台進行監控、修改、執行命令等操作。進入服務列表點擊【+】導入按鈕，根據頁面提示添加監控的集群/單機實例信息。

參數名	含義
集群名稱	自定義集群名稱
AMDC密碼	AMDC緩存核心的密碼
AMDC Node	AMDC緩存核心的IP:端口

# 擴容節點

點擊【擴容】按鈕，跳轉至自動擴容頁面，實現擴充主從模式的從節點，或者擴展集群模式的節點。

擴容時繼承原集群服務名稱，不可修改；目標部署模式根據原模式限制可選範圍：

單機 → 可擴容為主從或哨兵
主從 → 可擴容為主從或哨兵
哨兵 → 只能擴容為哨兵
集群 → 只能擴容為集群

擴容嚮導與自動部署一致，包含基礎配置、拓撲配置、配置模板、確認部署 4 個步驟。拓撲配置中會預填充原集群信息，按需調整節點數量、機器和授權後執行即可。

擴容部署

# 移除節點（縮容）

進入服務詳情 >【設置】，選中需要操作的節點，點擊【節點操作】下拉菜單：

節點操作

清空：清空當前選中節點的分佈式緩存數據。確認後執行。
移除：將選中節點從集群中移除。確認後執行；若移除的是主節點，系統會自動進行故障轉移或數據遷移（具體行為取決於部署模式）。

注意：移除節點會改變集群拓撲，建議在業務低峰期操作，操作前做好數據備份。

# 集群升級

點擊【設置】頁面上方【升級回退】下拉菜單中的【升級】，打開「集群升級」抽屜。

升級說明：

升級會停止整個集群並替換二進制，期間集群不可用。
升級失敗時，系統會自動從備份回滾到升級前版本。
僅支持同版本或更高版本升級；回退版本請使用平滑遷移。
升級前會自動備份節點數據，請確保各節點磁盤空間充足。

在列表中選擇要升級到的安裝包，點擊【確認升級】後，系統會創建升級任務並在後台執行。升級過程中可通過任務列表或監控中心觀察集群狀態。

集群升級

# 版本回退

點擊【設置】頁面上方【升級回退】下拉菜單中的【版本回退】，打開「版本回退」抽屜。

回退說明：

回退會停止整個集群並恢復歷史備份，期間集群不可用。
回退失敗時，系統會自動從本次備份回滾到回退前版本。
回退前會自動備份當前版本，請確保各節點磁盤空間充足。

在列表中選擇要回退到的歷史版本（會標註「升級備份」或「回滾快照」），點擊【確認回退】執行。

版本回退

# 平滑遷移

點擊【設置】頁面上方【集群運維】下拉菜單中的【平滑遷移】，可將數據從當前集群遷移到目標集群。

遷移說明：

平滑遷移通過增量同步將數據從源集群遷移到目標集群，遷移期間無需停機。
僅在切換瞬間存在短暫寫入凍結。
遷移完成後業務訪問 IP/端口會變更，請提前更新客戶端連接配置。
哨兵模式下哨兵節點不參與遷移，遷移後請檢查哨兵配置是否指向新的主從節點。

操作步驟：

在彈出的「集群遷移」窗口中，根據當前模式查看遷移說明。
點擊【創建目標節點】，在抽屜中通過自動部署嚮導創建目標節點；創建完成後系統會自動回填目標 IP/Port/密碼。
- 集群模式下需要為每個源節點創建對應的目標節點。
確認目標信息無誤後，點擊【下一步】進入確認遷移頁面。
閱讀遷移風險提示：遷移過程中源集群將有短暫寫入凍結（約 30 秒），請確保業務端可接受短暫寫入中斷，並提前準備好連接配置切換方案。
確認信息後執行遷移，系統會展示遷移進度。

平滑遷移

遷移確認

# 刷新節點與關聯機器

# 刷新節點

點擊【設置】頁面上方【集群運維】下拉菜單中的【刷新節點】，系統會重新探測集群實際節點拓撲，並與管控台當前記錄進行對比。

刷新說明：

確認刷新後會將新增節點納入管控、移除已脫離節點，並修正角色變化。
此操作僅同步節點元數據，不會停止或重啟節點，也不會影響業務訪問。
當控制台展示的節點數量、角色與實際集群不一致時，建議執行刷新節點。

刷新完成後會彈窗展示對比結果（當前記錄節點數、實際探測節點數、變化說明）。

刷新節點

# 關聯機器

進入【部署管理】>【服務列表】，點擊服務名稱進入服務詳情，再點擊【設置】進入集群設置頁面。選中對應節點，點擊【關聯機器】按鈕，將導入的節點與機器信息關聯起來，這樣能給節點提供完整管理功能。

# 日誌切割

點擊【設置】頁面「更多操作」中的【日誌切割】按鈕，可配置集群的日誌切割策略，包括日誌保留天數、單文件大小限制等參數。

# 解除管控

點擊【集群設置】頁面「更多操作」中的【解除管控】按鈕，可將該集群從管控台的納管狀態中移除。解除管控後，管控台將不再對該集群進行管理和監控，但集群本身仍會繼續運行。

# agent CLI 使用說明

# 概述

agent 是 cli-http 編譯後的二進制程序，通過 HTTP API 與 AMDC Console 進行交互。與直接連接緩存核心的 amdc-cli 不同，agent 面向管控台的資源、部署、任務和監控等管理操作，適用於自動化腳本、批量操作、CI/CD 集成以及無圖形界面的服務器環境。

兩者的主要區別如下：

工具	連接目標	主要能力
`amdc-cli`	AMDC 緩存核心	執行 Redis 協議命令、原生集群管理
`agent`	AMDC 管控台	執行部署、運維、任務、監控等管理操作

適用場景：自動化腳本、批量操作、CI/CD 集成、無圖形界面環境。

# 獲取 agent

agent 二進制程序隨 AMDC Console 安裝包一起發佈，解壓安裝包後可在 amdc_console/agent/ 目錄下找到對應平台的 agent 可執行文件（例如 Linux amd64 環境為 amdc_console/agent/agent_linux_amd64.tar.gz 解壓後的 agent）。

# 接入與認證

使用 agent 前，需要配置以下兩項環境變量：

AMDC_SERVER：AMDC 管控台訪問地址，例如 http://172.17.47.213:3001/。
AMDC_CLI_TOKEN：由管理員頒發的 AI Token，用於身份認證。

Linux / macOS 環境變量配置示例：

export AMDC_SERVER="http://<server-ip>:3001/"
export AMDC_CLI_TOKEN="<your-ai-token>"

1
2

Windows PowerShell 環境變量配置示例：

$env:AMDC_SERVER = "http://<server-ip>:3001/"
$env:AMDC_CLI_TOKEN = "<your-ai-token>"

1
2

配置完成後，可通過以下命令驗證連接是否正常：

agent cluster list

注意：AMDC_CLI_TOKEN 由管理員在管控台中生成並下發，請妥善保管，避免洩露。

# 全局參數

agent 支持以下全局參數，可用於覆蓋環境變量或調整輸出格式：

參數	說明	示例
`--server`	指定 AMDC 管控台地址	`--server http://<server-ip>:3001/`
`--cli-token`	指定 AI Token	`--cli-token <your-ai-token>`
`--json`	以 JSON 格式輸出結果	`--json`
`-h` / `--help`	查看幫助信息	`agent --help`

# 典型場景示例

# 查看集群列表

# 列出所有集群
agent cluster list

# 查看指定集群詳情
agent cluster get <cluster-id>

1
2
3
4
5

通過 agent cluster list 可快速獲取當前租戶下的所有集群概覽；使用 agent cluster get <cluster-id> 可查看指定集群的節點、狀態及配置詳情。

# 添加機器、證書、安裝包

# 創建機器組
agent machine group-create --name <machine-group-name>

# 向機器組添加機器
agent machine add --file machine.json

1
2
3
4
5

{
  "machine_group_name": "<machine-group-name>",
  "login_name": "root",
  "pwd": "<rsa-encrypted-base64-password>",
  "host": "<server-ip>",
  "sshport": 22,
  "note": "生產機器-01",
  "user_id": 1
}

1
2
3
4
5
6
7
8
9

注意：pwd 字段需先使用 RSA 加密，再進行 Base64 編碼。

# 上傳 License 證書
agent document upload-license --file <license-file-path>

# 上傳 AMDC 安裝包
agent document upload-pkg --file <package-file-path>

1
2
3
4
5

上述命令完成了自動部署前的資源準備：創建機器組、添加目標機器、上傳 License 與安裝包。

# 執行自動部署

agent autodeploy exec --file <deploy-config.json>

通過 JSON 配置文件描述部署參數（服務名稱、部署模式、節點拓撲、機器與授權等），agent 會自動向管控台提交部署任務並返回執行結果；後續可通過 agent task list 查看任務進度。

# 集群擴容

agent expand exec --file <expand-config.json>

擴容操作繼承原集群服務名稱，通過 --file 指定擴容配置文件，實現主從模式增加從節點或集群模式擴展分片節點。

# 查看監控大盤與慢日誌

# 查看全局監控大盤
agent monitor dashboard

# 查看指定節點的慢日誌
agent monitor slow-log --node-host <node-host>

1
2
3
4
5

agent monitor dashboard 匯總展示所有集群的運行概覽；agent monitor slow-log 用於查詢指定節點的慢日誌記錄，其中 --node-host 為目標節點地址，格式為 host:port。

# 常用命令速查

功能域	頂層命令	核心子命令
集群管理	`cluster`	`list`、`get`、`import`
集群運維	`cluster-manage` / `cm`	`node-info`、`config-get`、`config-update`、`backup`、`recover`、`flush`、`operate` 等
機器管理	`machine`	`list`、`add`、`group-create`、`group-list` 等
自動部署	`autodeploy`	`exec`
擴容縮容	`expand`	`exec`、`save`、`reduce`
部署資源	`document`	`pkg-list`、`upload-pkg`、`license-list`、`upload-license` 等
任務中心	`task`	`list`、`get`、`exec`
升級任務	`upgrade-task`	`list`、`get`、`create`、`rollback`
集群遷移	`migration`	`prepare`、`create`、`list`、`get`
監控診斷	`monitor`	`dashboard`、`dynamic`、`static`、`slow-log`、`keys-analyse`
配置模板	`conftemp`	`list`、`add`、`update`、`content`
操作歷史	`history`	`list`、`export`
ACL	`acl`	`list`、`create`、`update`、`delete`
密碼策略	`password-policy`	`get`、`update`

更多命令及參數說明，請使用 agent <command> --help 查看。

# AI 語料示例

在已配置好 AMDC_SERVER 和 AMDC_CLI_TOKEN 的環境中，可以直接將以下自然語言指令交給 AI，由其調用 agent 完成對應操作。

# 查看所有集群狀態

請使用 agent CLI 查看當前租戶下所有 AMDC 集群的列表，並以表格形式返回集群 ID、名稱、部署模式和狀態。

# 自動部署集群

請使用 agent CLI 在機器組 "prod-group" 上自動部署一個 3 主 3 從的 AMDC 集群模式服務，服務名稱為 "amdc-prod-01"，安裝目錄為 /data/amdc，使用已上傳的安裝包和 License，並返回部署任務 ID。

# 擴容集群

請使用 agent CLI 對集群 ID 為 &lt;cluster-id> 的服務進行擴容，新增 2 組主從節點，機器組為 "prod-group"，擴容完成後返回任務狀態。

# 查看節點慢日誌

請使用 agent CLI 查看節點 &lt;node-host> 上最近 50 條慢日誌，按耗時倒序排列。

# 批量上傳資源

請使用 agent CLI 將 /data/packages/AMDC-V2.0.5.tar.gz 安裝包 和 /data/licenses/amdc.lic License 文件上傳到管控台，並返回上傳後的資源 ID。

說明：AI 執行上述任務前，需確保當前環境已設置 AMDC_SERVER 和 AMDC_CLI_TOKEN，否則無法通過認證。

# 服務監控與告警

# 監控中心

路徑：【監控中心】

監控中心為全局監控大盤，匯總展示當前所有集群的運行概覽：

頂部指標卡：總集群數、健康集群、異常集群、總節點數。
狀態分佈：以環形圖展示健康、部分異常、異常集群佔比。
關鍵指標 Top5：內存、QPS、連接數 Top5 節點排行。
集群概覽：展示各集群名稱、部署模式、節點數、健康狀態、總內存使用及操作入口。

監控中心

# 服務監控

點擊服務欄目下的【監控】按鈕，進入集群監控頁面，這裡將展示當前集群的詳細信息以及重要指標項。不同角色進入服務列表的路徑略有差異：AMDC 管理員通過【部署管理】>【服務列表】進入；租戶管理員通過【服務列表】進入。

# 分析

點擊【監控】上方的【分析】按鈕進入【分析】頁面，在這裡可以進行緩存核心的bigkeys、hotkeys、memkeys、monitor、slowlog的數據分析查詢。

# 告警通道

告警通道指通知接收人的通知方式，amdc控制台提供Email形式的告警通道。

# 新增告警通道

進入【告警】>【告警通道】，點擊【新增】按鈕，新增告警通道。

參數名	含義
通道名稱	自定義
通道類型	Email
SMTP 地址	郵件傳送協議服務器
SMTP 端口	郵件服務器使用的端口
發件人郵箱	發送郵件的用戶名
密碼	發送人的郵箱密碼
收件人	當前租戶下的用戶，可多選，同時通知多人
備註	備註信息

# 編輯告警通道

進入【告警】>【告警通道】，選擇需要編輯的告警通道並點擊告警通道列表右側【編輯】按鈕，編輯告警通道。

# 刪除告警通道

進入【告警】>【告警通道】，勾選需要刪除的告警通道，點擊告警通道列表右側【刪除】按鈕，在確認框中點擊【確認】刪除告警通道。

# 告警規則

在控制台設置告警規則，滿足設置條件後將會在設置的時間內觸發告警！根據設置的頻率發送告警！

# 創建告警規則

告警規則分為對所有集群有效的全局告警規則和針對單個集群生效的局部告警規則，打開全局開關則針對所有集群生效。進入【告警】>【告警規則】，點擊頁面右上角【創建】按鈕，創建告警規則。

節點狀態告警：節點告警開關，開關開啟節點告警則開啟
規則名稱：自定義告警規則名稱
規則：設置告警觸發的條件
比較符：比較運算選擇
比較值：輸入告警比較數值，滿足該數值後將觸發告警
週期：規則檢查的週期：5min、10min、20min、30min、45min、1h、2h
是否生效：開關開啟告警規則生效
是否全局：默認否，選擇全局時該條規則將應用到當前租戶的所有集群

# 編輯告警規則

進入【告警】>【告警規則】，勾選相應的告警規則，點擊列表右側【編輯】按鈕，編輯告警規則。

# 刪除告警規則

進入【告警】>【告警規則】，勾選需要刪除的告警規則，點擊列表右側【刪除】按鈕，刪除告警規則。也可選擇多條告警規則點擊左上角【刪除】按鈕批量刪除。

# 賬號權限與安全

本節介紹管控台基於等保 2.0 的賬號體系與三員分立機制。如本章內容與你實際部署的界面有差異，請以登入後看到的為準。

# 角色體系與菜單可見性

管控台 V2.0.5 採用五角色體系，各角色登入後僅可見其職責範圍內的菜單，符合《信息安全技術網絡安全等級保護基本要求》（GB/T 22239-2019）中有關「管理用戶權限分離」的要求。

角色	賬號	職責	默認可見菜單
系統管理員	`sys_admin`	租戶管理、租戶管理員賬號管理	【租戶】> 租戶管理、賬號管理
安全管理員	`sec_admin`	全局安全策略、用戶鎖定/解鎖、密碼重置、訪問控制策略	【租戶】> 授權管理、密碼策略
審計管理員	`audit_admin`	審計策略、審計日誌查看與分析、審計報告（僅只讀）	【操作歷史】
租戶管理員	`tenant_admin`	本租戶內的賬號與密碼策略	【租戶】> 賬號管理、密碼策略、【操作歷史】
AMDC 管理員	`amdc_admin`	AMDC 實例的全局管理	【監控中心】、【部署管理】（服務列表、自動部署、部署任務）、【資源管理】（安裝包管理、證書管理、機器管理、配置模板）、【告警】

三員（系統管理員 / 安全管理員 / 審計管理員）由系統啟動時自動生成，每個角色有且僅有一個賬號，不能刪除；菜單互相獨立，不可兼任。

按賬號性質劃分，管控台功能的實際使用者分為兩類：

管理員賬號：擁有租戶 / 用戶管理權限，決定服務與數據資源如何分配。
租戶賬號：是租戶內的數據使用者，可使用服務並執行部分管理操作；不同租戶之間數據相互隔離；租戶管理員對租戶內服務僅有使用權，沒有擁有權（無法自行決定緩存核心的刪改）。

下圖展示五種角色登入後管控台的主菜單差異：

AMDC 管理員主菜單（監控中心 / 部署管理 / 資源管理 / 告警）

# 登入與首次改密

管控台首次啟動時，會自動為所有預置管理員賬號（包括三員、租戶管理員、amdc_admin）生成 12 位隨機密碼，寫入安裝目錄下的 ./resource/.initial_passwords 文件。

打開瀏覽器訪問管控台 URL（默認 http://<管控台 IP>:9001/），登入頁如下：

管控台登入頁

首次登入步驟：

輸入賬號（例如 sys_admin）。
輸入 .initial_passwords 文件對應行後的 12 位隨機密碼。
輸入頁面上的圖形驗證碼（不區分大小寫）。
點擊【登入】。

提示：密碼中包含特殊字符（例如 #、$、* 等）時，建議在瀏覽器中直接粘貼，避免被 shell / 終端解析時丟失字符。

首次登入成功後，會跳轉到強制改密頁，必須按當前密碼策略修改密碼才能進入主控台：

首次登入強制修改密碼頁（要求 8-32 位，含數字、大寫字母、小寫字母、特殊字符）

注意：首次改密失敗或新密碼不符合複雜度策略時，系統會停留在改密頁，提交後會顯示具體不符合項，請按提示修正後再次提交。

# 忘記預置賬號密碼時的重置方式

如果 .initial_passwords 文件已遺失，或預置賬號因多次登入失敗被鎖定（例如 amdc_admin 剩餘重試次數已耗盡），可在管控台可執行文件所在目錄使用 CLI 直接把該預置賬號的密碼重置為新的 12 位隨機值，賬號本身不會被鎖定或刪除。

操作步驟：

SSH 登入管控台伺服器，切換到 amdc-console 可執行文件所在目錄（默認 /home/mofant/test-soft/amdc/amdc_console）：
```
cd /home/mofant/test-soft/amdc/amdc_console
```
1
執行重置命令，指定預置賬號名（可選值：sys_admin / sec_admin / audit_admin / tenant_admin / amdc_admin）：
```
./amdc-console --reinit amdc_admin
```
1
執行成功後控制台會打印新密碼，例如：
```
账户 amdc_admin 的密码已重置。
新密码: Yg!.U,f19wmE
请使用新密码登录，并按提示修改密码。
```
1
2
3
立即在瀏覽器用新密碼登入對應賬號，按提示完成首次改密。

-reinit 參數說明：

僅對 5 個預置賬號生效，對在管控台內創建的業務賬號無效；
重置後賬號不會被禁用，並會清空鎖定計數器，無其他副作用；
重置命令需要在管控台可執行文件所在目錄（而非 AMDC 緩存核心目錄）執行，並對該目錄具有可讀可執行權限；
可通過 ./amdc-console --help 查看支持的參數（-c string 指定配置文件；-reinit string 重置預置賬號）。

# 三員管理

# 系統管理員（`sys_admin`）

登入後默認停留在【租戶】>【租戶管理】頁面，左側菜單只有「租戶管理」和「賬號管理」兩項：

系統管理員主控台 - 租戶列表

租戶管理

點擊右上角【創建】按鈕，彈出添加租戶對話框：

系統管理員 - 創建租戶對話框

填寫租戶名稱（必填、唯一）和備註（可選），點擊【確定】後返回列表。新建的租戶行會出現在列表中，並顯示創建時間：

系統管理員 - 創建後的租戶列表（含新建的「演示租戶 A」）

點擊租戶行的【租戶管理員】按鈕，會彈出該租戶下的租戶管理員賬號對話框，便於後續查看 / 維護租戶管理員與租戶的歸屬關係：

租戶管理員賬號對話框（按租戶查看其管理員賬號）

賬號管理

切換到【租戶】>【賬號管理】，可以查看管控台內的所有賬號（含租戶管理員與租戶用戶），並支持編輯：

系統管理員 - 賬號管理列表

點擊【創建】可彈出新建賬號對話框：

系統管理員 - 創建賬號對話框（用戶頭像 / 登入賬號 / 用戶名稱 / 電話 / 郵箱 / 密碼）

提示：創建賬號時必須輸入「密碼」字段，並符合當前密碼策略；賬號創建後默認啟用，可在列表中點擊【編輯】修改。

# 安全管理員（`sec_admin`）

登入後菜單僅有【租戶】>【授權管理】、【租戶】>【密碼策略】兩項，用於配置訪問控制與密碼策略：

授權管理

安全管理員 - 授權管理主頁

租戶中未分配組的用戶（沒有被分配到任何租戶的用戶），需要先在此頁面進行租戶授權，賬號才能登入使用。

修改用戶密碼

新建賬號沒有初始密碼，必須由安全管理員先在授權管理中設置一次密碼後賬號才能登入。選中目標用戶行，點擊列表上方的【修改密碼】按鈕即可。

激活 / 凍結

點擊列表上方【激活/凍結】按鈕，可切換該用戶的「啟用」與「凍結」兩種狀態。凍結後該賬號無法登入，但賬號信息保留。

密碼策略

進入【租戶】>【密碼策略】頁面。密碼策略由「預設檔」和「自定義」兩部分組成，保存後對所有租戶內的賬號立即生效：

安全管理員 - 密碼策略配置頁（預設檔 + 密碼複雜度 / 安全策略）

預設檔（不可修改，僅作快速選擇）：

預設檔	長度	最大重試	凍結時間	過期	歷史	必須包含
簡單	8-32 位	10 次	15 分鐘	90 天	0 次	數字、字母+數字
中等	10-32 位	5 次	30 分鐘	90 天	3 次	大寫、小寫、數字
複雜	12-32 位	3 次	60 分鐘	90 天	5 次	大寫、小寫、數字、特殊字符

注：預設檔之間的差別同時體現在密碼長度、歷史次數與重試/凍結策略上；單擊預設檔後下方「密碼策略配置」區域會自動填入對應數值，保存後即對所有租戶內的賬號生效。

自定義字段：

字段	默認值	說明
最小長度	8	不可低於此值
最大長度	32	上限
需要數字	開	密碼是否必須包含數字
需要大寫字母	關	密碼是否必須包含大寫字母
需要小寫字母	關	密碼是否必須包含小寫字母
需要特殊字符	關	密碼是否必須包含特殊字符
最大重試次數	5	連續登入失敗超過此次數後鎖定賬號
凍結時間（分鐘）	30	觸發鎖定後自動解鎖的等待時長
密碼過期天數	90	密碼有效天數，過期後強制修改
歷史密碼次數	5	修改密碼時不得與最近 N 次的歷史密碼重複