Spider RPC 管理接口完整參考：RESTful API 與控制台入口

Spider RPC 管理接口完整參考手冊

Spider 中間件在獨立管理模式下提供豐富的 RESTful API，支持運行時動態查詢路由、下游節點、客戶端連接、發布/代理服務、性能指標、拓撲樹等，並內置 Web 管理控制台。本文匯總所有已實現的接口，供運維與開發快速查閱。

核心管理 API 列表

使用說明

• 所有接口均為 GET 請求，返回 HTML/JSON 格式（具體視實現）。
• ip:port 為 Spider 節點綁定的管理端口（spider.xml 中 pluginId="spider.localService" 下 server.port）。
• 服務中心模式下，控制台功能更豐富；獨立模式下上述 API 均可用。
• 性能指標（metrics.html）包含 QPS、延遲分位數、錯誤率、線程池狀態等，定期 reset-metrics 便於觀測近期窗口。
• 拓撲樹（node-tree.html）可視化展示整個集群節點關係，排查路由環路、孤立節點利器。

典型運維場景

1. 新上線服務驗證：調用 /exports.html 確認服務已發布，/routes.html 驗證路由生效。
2. 流量突增排查：/metrics.html 觀察 QPS/延遲，/clients.html 定位高頻調用方。
3. 下游節點異常：/clusters.html 檢查工作節點存活狀態，/dyn-route-caches.html 核對動態路由緩存。
4. License 更新：調用 /generate-license-key.html 生成新授權，分發至節點。

安全建議

• 管理端口不對公網暴露，僅允許運維網段/跳板機訪問。
• 生產環境建議在 Nginx 層面添加 Basic Auth 或 IP 白名單。
• 定期輪換 License，避免洩露導致未授權節點加入集群。