Great Lotus IP Pool — Tài liệu node C13

Điều khiển và quản lý IP Pool (DCOM 4G proxy, Redis state, MQTT reset, Audit, Stats) kết nối tới B30

Mỗi action trong n8n có một link 📘 dẫn thẳng tới trang tương ứng bên dưới. Tổng cộng 32 action trong 6 nhóm.

Cấu hình kết nối chung

Trường	Ý nghĩa	Mặc định
`Base URL`	Địa chỉ API server B30 (lotus_python_proxy_script).	`http://lotus_python_proxy_script:8080` (nội bộ Docker n8n) hoặc `http://127.0.0.1:20300`
`Request Timeout (ms)`	Thời gian chờ tối đa phản hồi từ B30 trước khi báo timeout.	`10000` ms (tăng lên 60000ms cho các thao tác reboot/reset)

1. DcomControl 7 action

Action	HTTP Endpoint	Chức năng	Tham số
🔄 Đổi IP DCOM (changeIpRequest) `dcom.change_ip`	`POST /api/mqtt/change-ip`	Gửi lệnh MQTT changeIpRequest tới thiết bị DCOM cụ thể trong WorkPool để ngắt kết nối mạng và xin cấp phát Public IPv4 mới từ nhà mạng (Viettel/Vina/Mobi). Yêu cầu nhập workpool (vd WP1) và dcom_id (vd eth1).	2
🔄 Đổi IP Toàn Bộ Pool (changeIpAllDcomRequest) `dcom.change_ip_all`	`POST /api/mqtt/change-ip-all`	Gửi lệnh MQTT changeIpAllDcomRequest đổi toàn bộ IP của tất cả các cổng DCOM trong WorkPool cùng lúc. Dùng khi cần làm mới toàn bộ pool IP của một trạm làm việc.	1
⚡ Khởi Động Lại DCOM (rebootDcomRequest) `dcom.reboot_dcom`	`POST /api/mqtt/reboot-dcom`	Gửi lệnh MQTT rebootDcomRequest khởi động lại modem DCOM USB khi thiết bị bị treo, mất sóng hoặc không nhận lệnh đổi IP thông thường.	2
⚡ Khởi Động Lại Tất Cả DCOM (rebootAllDcomRequest) `dcom.reboot_all`	`POST /api/mqtt/reboot-all`	Gửi lệnh MQTT rebootAllDcomRequest khởi động lại toàn bộ các modem DCOM trong toàn bộ WorkPool.	1
📡 Yêu Cầu Cập Nhật Trạng Thái (poolInfoRequest) `dcom.request_info`	`POST /api/mqtt/request-info`	Gửi lệnh poolInfoRequest yêu cầu Host quét và phát broadcast thông tin trạng thái DCOM hiện tại ngay lập tức, không cần chờ chu kỳ quét định kỳ.	2
🧹 Xoá Cache Client Alive Trên Host `dcom.clear_client_alive`	`POST /api/mqtt/clear-client-alive`	Gửi lệnh clearClientAliveRequest yêu cầu Host giải phóng bộ nhớ và xoá file JSON lưu trữ thông tin nhịp tim sống của các Client.	0
🧹 Xoá Cache Proxy Info Trên Host `dcom.clear_proxy_info`	`POST /api/mqtt/clear-proxy-info`	Gửi lệnh clearProxyInfoRequest yêu cầu Host giải phóng bộ nhớ và xoá file JSON thông tin cấu hình proxy DCOM.	0

2. IpState 8 action

Action	HTTP Endpoint	Chức năng	Tham số
📋 Đọc Toàn Bộ 5 Bảng Redis `state.get_all`	`GET /api/redis/all`	Đọc toàn bộ dữ liệu của cả 5 bảng quản lý IP trong Redis: 01_INFO (DCOM hiện hữu), 02_ALIVE (Client sống), 03_NEW_IP (IP mới), 04_USING_IP (IP đang dùng), 05_DONE_IP (IP đã dùng).	0
✨ Đọc Danh Sách IP Mới (03_NEW_IP) `state.get_new_ip`	`GET /api/redis/new-ip`	Đọc danh sách các IP mới sinh ra từ DCOM nhưng chưa được gán cấp phát (03_NEW_IP). Thường dùng làm hàng đợi cấp IP sạch cho profile duyệt web.	3
⏳ Đọc Danh Sách IP Đang Dùng (04_USING_IP) `state.get_using_ip`	`GET /api/redis/using-ip`	Đọc danh sách các IP đang được cấp phát cho các tác vụ/profile sử dụng (04_USING_IP), kèm mốc thời gian bắt đầu sử dụng.	3
✅ Đọc Danh Sách IP Đã Xong (05_DONE_IP) `state.get_done_ip`	`GET /api/redis/done-ip`	Đọc danh sách các IP đã sử dụng xong (05_DONE_IP). Dùng để kiểm tra IP đã qua xử lý trước khi xoay vòng hoặc làm sạch.	3
ℹ️ Đọc Thông Tin DCOM Hiện Hữu (01_INFO) `state.get_info`	`GET /api/redis/info`	Đọc bảng 01_INFO_JSON_MAN chứa danh sách DCOM, card mạng, nhà mạng, tín hiệu sóng và IP hiện tại của từng DCOM trên trạm proxy.	0
💓 Đọc Danh Sách Client Alive (02_ALIVE) `state.get_client_alive`	`GET /api/redis/client-alive`	Đọc bảng 02_CLIENT_ALIVE_JSON_MAN chứa thông tin các máy Client đang online, nhịp tim và trạng thái kết nối tới hệ thống.	0
🔀 Chuyển Đổi Trạng Thái IP (Move State) `state.move_ip`	`POST /api/redis/move-ip`	Chuyển một địa chỉ IP từ trạng thái này sang trạng thái khác (vd từ NEW sang USING hoặc từ USING sang DONE) theo khóa Redis chỉ định.	3
🗑️ Xoá Dữ Liệu Bảng Redis (Clear Key) `state.clear_key`	`DELETE /api/redis/clear/:key_alias`	Xoá sạch dữ liệu một bảng trạng thái trong Redis theo alias chỉ định (01_INFO, 02_ALIVE, 03_NEW_IP, 04_USING_IP, 05_DONE_IP). Cẩn trọng khi dùng.	1

3. Config 4 action

Action	HTTP Endpoint	Chức năng	Tham số
⏱️ Xem Cấu Hình Timeout IP Đang Dùng `config.get_using_timeout`	`GET /api/redis/config/using-timeout`	Đọc cấu hình thời gian timeout tối đa của một IP khi ở trạng thái USING (tính bằng giây). Khi vượt quá thời gian này, IP được coi là hết hạn.	0
⚙️ Cài Đặt Timeout IP Đang Dùng `config.set_using_timeout`	`POST /api/redis/config/using-timeout`	Cài đặt thời gian timeout tối đa cho IP ở trạng thái USING. Giúp thu hồi IP tự động nếu worker bị crash hoặc không trả IP.	1
🔄 Xem Cấu Hình Auto Move IP `config.get_auto_move`	`GET /api/redis/config/auto-move`	Đọc trạng thái bật/tắt và thời gian delay của tiến trình nền tự động dịch chuyển trạng thái IP (NEW → USING → DONE → NEW).	0
⚙️ Thiết Lập Cấu Hình Auto Move IP `config.set_auto_move`	`POST /api/redis/config/auto-move`	Cấu hình bật/tắt các chặng chuyển trạng thái tự động và độ trễ giữ IP ở trạng thái USING trước khi chuyển sang DONE.	4

4. IpStats 6 action

Action	HTTP Endpoint	Chức năng	Tham số
📊 Biểu Đồ Thống Kê Unique vs Duplicate `stats.get_chart`	`GET /api/ip-stats/chart`	Lấy dữ liệu chuỗi thời gian thống kê số lượng IP duy nhất (Unique) so với IP bị trùng lặp (Duplicate) theo khoảng thời gian (day/week/month/3month) và nhà mạng.	3
🏢 Danh Sách WorkPool Đã Thống Kê `stats.get_workpools`	`GET /api/ip-stats/workpools`	Liệt kê danh sách tất cả các WorkPool đã ghi nhận dữ liệu thống kê IP trong cơ sở dữ liệu.	0
📶 Danh Sách Nhà Mạng Đã Thống Kê `stats.get_networks`	`GET /api/ip-stats/networks`	Liệt kê danh sách tất cả các nhà mạng viễn thông (Viettel, VinaPhone, MobiFone...) có trong cơ sở dữ liệu thống kê.	0
📈 Tổng Hợp Số Lượng IP Unique & Lượt Quét `stats.get_pool_info`	`GET /api/ip-stats/pool-info`	Xem báo cáo tổng hợp: tổng số IP duy nhất, tổng số lượt quét và tỷ lệ trùng lặp cho từng WorkPool.	0
⚠️ Top IP Trùng Lặp Nhiều Nhất `stats.get_top_duplicates`	`GET /api/ip-stats/top-duplicates`	Truy xuất danh sách các địa chỉ IP bị nhà mạng cấp trùng lặp nhiều lần nhất kèm số lần trùng và thời gian xuất hiện gần nhất.	3
🗑️ Xóa Sạch Dữ Liệu Thống Kê IP `stats.clear`	`POST /api/ip-stats/clear`	Xóa toàn bộ dữ liệu lịch sử thống kê IP trùng lặp trong cơ sở dữ liệu SQLite của B30.	0

5. Audit 4 action

Action	HTTP Endpoint	Chức năng	Tham số
📜 Lịch Sử Sự Kiện Kiểm Toán (Audit Events) `audit.get_events`	`GET /api/audit/events`	Truy xuất danh sách nhật ký sự kiện kiểm toán hệ thống (đổi IP, reboot, timeout, lỗi) với các bộ lọc theo số giờ gần nhất, workpool, loại sự kiện, DCOM.	5
📊 Tổng Hợp Sự Kiện Theo WorkPool `audit.get_summary`	`GET /api/audit/summary`	Thống kê tổng hợp số lượng sự kiện phân loại theo từng WorkPool trong N giờ qua.	1
🏆 Xếp Hạng DCOM Reboot/Timeout Nhiều Nhất `audit.get_reboot_ranking`	`GET /api/audit/reboot-ranking`	Bảng xếp hạng các thiết bị DCOM bị reboot hoặc timeout nhiều nhất. Hữu ích để phát hiện modem hỏng, SIM lỗi hoặc cổng USB chập chờn.	2
🗑️ Xóa Toàn Bộ Lịch Sử Sự Kiện `audit.clear`	`POST /api/audit/clear`	Xóa sạch toàn bộ nhật ký lịch sử sự kiện kiểm toán trong cơ sở dữ liệu SQLite.	0

6. System 3 action

Action	HTTP Endpoint	Chức năng
💚 Kiểm Tra Sức Khỏe Toàn Diện `system.health`	`GET /health`	Kiểm tra sức khỏe tổng thể của trạm điều khiển proxy: tình trạng FastAPI B30, kết nối Redis B27, kết nối MQTT Broker và heartbeat từ Host.
🔴 Kiểm Tra Kết Nối Redis Server `system.redis_status`	`GET /api/redis/status`	Kiểm tra chi tiết trạng thái kết nối tới máy chủ Redis (host, port, ping latency).
📡 Kiểm Tra Kết Nối MQTT Broker `system.mqtt_status`	`GET /api/mqtt/status`	Kiểm tra chi tiết trạng thái kết nối tới MQTT Broker (broker IP, port, connected state).

Sinh tự động bởi tools/gen_doc_html.js từ ACTION_SPECS (package n8n-nodes-c13_lotus_ip_pool@0.1.5) · 2026-08-15 · Đừng sửa tay file này — sửa _notes/ hoặc source rồi chạy lại npm run doc:build.