GIAO TRINH KY THUAT

NODE n8n · C13 — GREAT LOTUS IP POOL

Dieu khien IP Pool DCOM 4G qua REST API cua B30 — 32 action, 6 nhom

Package n8n-nodes-c13_lotus_ip_pool@0.1.5 (live 0.1.4) · payload c13-lotus-ip-pool-v1 · Bien soan 2026-09-19

Loi noi dau

Cuon giao trinh nay huong dan toan dien node n8n C13 — Great Lotus IP Pool: mot node dong vai tro GIAO DIEN truc quan (typed wrapper) goi toi may chu B30 (lotus_python_proxy_script) qua REST API, de dieu khien va giam sat toan bo he thong Proxy 4G DCOM / IP Pool tu trong workflow n8n.

Doi tuong doc

Ky su van hanh workflow n8n can cap IP sach cho profile, doi IP, hoac giam sat pool IP 4G.
Ky su quan tri he thong proxy (B30/B27/DCOM) muon dieu khien qua n8n thay vi goi API tay.
Nguoi moi tiep quan, can hieu C13 dung o dau va khac gi ba node MQTT con lai (C10/C11/C12).

GHI CHÚ · KY LUAT NGUON CUA TAI LIEU NAY

Moi con so va ten thanh phan deu truy duoc ve mot trong ba nguon: (1) MA NGUON DANG CHAY — LotusIpPool.node.ts; (2) TAI LIEU NOI BO — Agent_Readme.md, Agent_Actions_Reference.md, memory du an (ip-pool-zone2); (3) ANH CHUP HE THONG SONG — mo node that trong n8n tren Chrome that (B35) luc bien soan. Cho nao khong truy duoc thi bo, khong doan cho du trang.

Da doi chieu va sua so voi tai lieu cu

Hang muc	Hieu biet cu / tai lieu cu	Su that trong ma nguon dang chay
So action	Agent docs ghi '26 action'	Thuc te ACTION_SPECS co 32 action (dem lai tung nhom)
Ban chat node	De nham 'node MQTT nhu C10/C11/C12'	C13 goi HTTP REST toi B30 (helpers.httpRequest), KHONG tu publish MQTT, KHONG credential
Phien ban	—	Repo 0.1.5, container dang chay 0.1.4 — bo 32 action key TRUNG NHAU (bump chi la chinh sua nho)

Bang trang thai he thong luc chup anh

Hang muc	Gia tri luc bien soan (2026-09-19)
n8n	phien ban 2.36.8 — container lotus_n8n, API cong 20150
Node C13	n8n-nodes-c13_lotus_ip_pool — repo 0.1.5, container 0.1.4 (32 action trung nhau)
Type node	n8n-nodes-c13_lotus_ip_pool.lotusIpPool · hien thi 'Great Lotus IP Pool'
So action / nhom	32 action / 6 nhom
payload version	c13-lotus-ip-pool-v1
Base URL mac dinh	http://lotus_python_proxy_script:8080 (host: http://127.0.0.1:20300)
Backend	B30 lotus_python_proxy_script (FastAPI) — da co giao trinh rieng HDID_00017
Credential	KHONG can (chi Base URL + Request Timeout)

Muc luc

⟳ Mở bằng Microsoft Word rồi bấm Ctrl+A → F9 để sinh mục lục kèm số trang.

PHẦN I

TONG QUAN

Chương 1 — C13 la gi va khac gi ba node con lai

C13 — Great Lotus IP Pool la node n8n dung de dieu khien va giam sat he thong IP Pool 4G. Thay vi phai tu cau hinh URL / Method / Header / Query / Body trong node HTTP Request generic cua n8n, nguoi dung co san node C13 voi dropdown chon nhom chuc nang va action cu the.

Hình 1.1. C13 goi HTTP REST toi B30; B30 moi lam viec voi Redis (B27) va MQTT (DCOM 4G).

LƯU Ý · C13 KHONG PHAI NODE MQTT NHU C10/C11/C12

C10/C11/C12 la 'MQTT command emitter' — tu dong goi ban tin MQTT. C13 la mot 'typed HTTP wrapper' — goi THANG REST API cua B30 bang this.helpers.httpRequest. B30 moi la ben noi chuyen voi Redis va phat lenh MQTT. Vi vay C13 KHONG can credential, chi can Base URL + Request Timeout.

C13 giai quyet van de gi

Cap IP sach cho profile duyet web — doc 03_NEW_IP (co che Get One First) roi gan cho profile.
Lam moi IP khi bi chan/ban — doi IP mot DCOM hoac ca pool bang lenh MQTT (qua B30).
Tu dong hoa vong doi IP — cau hinh Auto Move NEW->USING->DONE->NEW va timeout thu hoi.
Giam sat chat luong pool — thong ke Unique vs Duplicate, top IP trung, audit su kien.

Chương 2 — Kien truc data-driven va vong doi IP

Sinh UI + dinh tuyen HTTP tu mot nguon khai bao

Toan bo UI khong viet tay tung o. No sinh tu mang khai bao ACTION_SPECS (32 action), qua buildNodeProperties(). Moi action mang san httpMethod + httpPath.

Hình 2.1. ACTION_SPECS (32 action, moi cai co method+path) -> buildNodeProperties() sinh UI va ban do execute().

Vong doi IP va 5 bang trang thai Redis

Trung tam cua he thong la 5 bang Redis. IP di theo vong NEW -> USING -> DONE -> (xoay vong) NEW.

Hình 2.2. Vong doi IP qua 5 bang Redis; Auto Move dieu khien tung chang.

Bang (alias)	Khoa Redis	Y nghia
01_INFO	LOTUS:03_PROXY:01_INFO_JSON_MAN	Danh sach DCOM, card mang, nha mang, song, IP hien tai
02_ALIVE	LOTUS:03_PROXY:02_CLIENT_ALIVE_JSON_MAN	May Client online, nhip tim, trang thai ket noi
03_NEW_IP	LOTUS:03_PROXY:03_NEW_IP	IP moi sinh tu DCOM, chua duoc cap
04_USING_IP	LOTUS:03_PROXY:04_USING_IP	IP dang cap phat su dung, kem timestamp
05_DONE_IP	LOTUS:03_PROXY:05_DONE_IP	IP da su dung xong

PHẦN II

KIEN TRUC VA HA TANG

Chương 3 — Mot action = mot loi goi HTTP toi B30

Hình 3.1. execute() dinh tuyen tung tham so vao :path / query (GET) / body (POST-DELETE), roi goi httpRequest().

Voi moi tham so cua action, execute() phan loai:

Neu httpPath chua :ten_param — thay gia tri vao PATH (vd /api/redis/clear/:key_alias).
Neu la method GET — dua vao QUERY string (qs).
Neu la POST/DELETE/PUT — dua vao BODY JSON.

Ket qua B30 tra ve duoc dong goi thanh mot hoac nhieu item cua node. Loi HTTP nem NodeOperationError (hoac ghi vao output neu bat Continue On Fail).

GHI CHÚ · LOC VA GET ONE FIRST CHO ACTION DOC IP

Rieng ba action state.get_new_ip / get_using_ip / get_done_ip: sau khi goi B30, node LOC danh sach theo workpool va proxy_name. Neu bat Get One First, node chi tra 1 IP dau tien va GAN kem publicIp, proxy (ip:port), workpool, proxyName o cap root cua $json — de node sau cap ngay cho profile ma khong phai dao mang.

Hình 3.2. Get One First: tra 1 IP kem publicIp/proxy o cap root thay vi ca mang.

Chương 4 — Luong doi IP DCOM (change_ip) end-to-end

Hình 4.1. change_ip: Node C13 -> B30 -> MQTT -> Host B12 -> DCOM 4G xin IP moi -> ghi vao Redis NEW.

Khi goi action dcom.change_ip, C13 POST toi /api/mqtt/change-ip. B30 phat lenh changeIpRequest qua MQTT toi Host, Host ra lenh cho DCOM tuong ung ngat ket noi va xin cap Public IPv4 moi tu nha mang. IP moi duoc ghi vao bang 03_NEW_IP.

LƯU Ý · BROKER MQTT LA VPS NGOAI, KHONG PHAI NOI BO

Broker MQTT that la 128.199.200.17:1883 (VPS ngoai). Lenh doi IP la changeIpRequest (da sua typo changIpRequest 2026-08-14; ben nhan chap nhan ca hai). C13 khong cham MQTT truc tiep — moi thu qua B30.

PHẦN III

GIAO DIEN — MO XE TUNG MAN HINH

Chương 5 — Giai phau Node Detail View (NDV)

Hình 5.1. Giai phau NDV cua node C13 — 10 thanh phan chinh.

So	Thanh phan	Cong dung
1	Vung INPUT	Du lieu tu node truoc ('No input data' khi chua chay)
2	Nut Docs / dong	Docs mo trang muc luc tai lieu C13; dau X dong NDV
3	Base URL	Dia chi API B30 (bat buoc). Mac dinh http://lotus_python_proxy_script:8080
4	Request Timeout (ms)	Thoi gian cho phan hoi toi da tu B30 (mac dinh 10000)
5	Nhom Chuc Nang	Chon 1 trong 6 nhom (resource)
6	Thao Tac (Action)	Chon action cu the trong nhom
7	Notice tai lieu	Link 'Xem Tai Lieu Chi Tiet' cho action dang chon
8	O tham so action	Cac o rieng cua action (o day: WorkPool Loc...)
9	Tieu de node	'Great Lotus IP Pool' + bieu tuong
10	Vung OUTPUT	Ket qua tra ve; 'No output data' khi chua chay

Toan canh NDV va o ket noi chung

Hình 5.2. NDV mo mac dinh: Base URL, Request Timeout, hai dropdown, notice va cac o.

O chung	Kieu	Mac dinh	Y nghia
Base URL	string (bat buoc)	http://lotus_python_proxy_script:8080	Dia chi B30. Trong Docker dung ten container; host dung :20300
Request Timeout (ms)	number	10000	Thoi gian cho phan hoi toi da tu B30

Chon Nhom Chuc Nang

Hình 5.3. Dropdown Nhom Chuc Nang: 6 nhom (DCOM Control, IP State, Auto Move, IP Statistics, Audit, System).

Chương 6 — Nhom DCOM Control (Lenh MQTT)

Nhom gui lenh dieu khien DCOM qua MQTT (thong qua B30): doi IP, reboot, yeu cau cap nhat, xoa cache Host.

Hình 6.1. Dropdown Action nhom DCOM Control (Lenh MQTT) — moi dong kem tom tat.

Action (khong emoji)	HTTP	Tham so	Chuc nang
Doi IP DCOM (changeIpRequest)	POST /api/mqtt/change-ip	workpool, dcom_id	Doi IP 1 DCOM cu the
Doi IP Toan Bo Pool	POST /api/mqtt/change-ip-all	workpool*	Doi IP dong loat ca WorkPool
Khoi Dong Lai DCOM	POST /api/mqtt/reboot-dcom	workpool, dcom_id	Reboot modem DCOM bi treo
Khoi Dong Lai Tat Ca DCOM	POST /api/mqtt/reboot-all	workpool*	Reboot toan bo DCOM trong WorkPool
Yeu Cau Cap Nhat Trang Thai	POST /api/mqtt/request-info	workpool, client_uid	Host phat broadcast trang thai ngay
Xoa Cache Client Alive Tren Host	POST /api/mqtt/clear-client-alive	(khong)	Xoa file JSON nhip tim client
Xoa Cache Proxy Info Tren Host	POST /api/mqtt/clear-proxy-info	(khong)	Xoa file JSON cau hinh proxy DCOM

Hình 6.2. Panel tham so trong nhom DCOM Control (Lenh MQTT).

Chương 7 — Nhom IP State & Redis

Doc va chuyen doi 5 bang trang thai Redis. Ba action doc IP (NEW/USING/DONE) ho tro loc workpool/proxy_name va Get One First.

Hình 7.1. Dropdown Action nhom IP State & Redis — moi dong kem tom tat.

Action (khong emoji)	HTTP	Tham so	Chuc nang
Doc Toan Bo 5 Bang Redis	GET /api/redis/all	(khong)	Doc ca 5 bang trang thai
Doc Danh Sach IP Moi (03_NEW_IP)	GET /api/redis/new-ip	workpool, proxy_name, get_one_first	Hang doi IP sach chua cap
Doc Danh Sach IP Dang Dung (04_USING_IP)	GET /api/redis/using-ip	workpool, proxy_name, get_one_first	IP dang cap phat + timestamp
Doc Danh Sach IP Da Xong (05_DONE_IP)	GET /api/redis/done-ip	workpool, proxy_name, get_one_first	IP da dung xong
Doc Thong Tin DCOM Hien Huu (01_INFO)	GET /api/redis/info	(khong)	Card mang, nha mang, song, IP DCOM
Doc Danh Sach Client Alive (02_ALIVE)	GET /api/redis/client-alive	(khong)	Client online + nhip tim
Chuyen Doi Trang Thai IP (Move State)	POST /api/redis/move-ip	from_key, to_key, public_ip*	Chuyen 1 IP giua 2 bang
Xoa Du Lieu Bang Redis (Clear Key)	DELETE /api/redis/clear/:key_alias	key_alias* (01..05)	Xoa sach 1 bang trang thai

Hình 7.2. Doc IP Moi: WorkPool, Proxy Name, Get One First.

Hình 7.3. Move State: Source Key, Destination Key, Public IPv4 (deu bat buoc).

Hình 7.4. Clear Key: dropdown chon bang can xoa.

Hình 7.5. Dropdown Key Alias: 5 bang 01_INFO..05_DONE_IP.

Chương 8 — Nhom Auto Move & Timeout (Cau Hinh)

Cau hinh luong tu dong chuyen trang thai IP va timeout thu hoi IP dang dung.

Hình 8.1. Dropdown Action nhom Auto Move & Timeout (Cau Hinh) — moi dong kem tom tat.

Action (khong emoji)	HTTP	Tham so	Chuc nang
Xem Cau Hinh Timeout IP Dang Dung	GET /api/redis/config/using-timeout	(khong)	Doc timeout USING hien tai
Cai Dat Timeout IP Dang Dung	POST /api/redis/config/using-timeout	timeout_sec*	Dat timeout thu hoi IP tu dong
Xem Cau Hinh Auto Move IP	GET /api/redis/config/auto-move	(khong)	Doc trang thai auto-move
Thiet Lap Cau Hinh Auto Move IP	POST /api/redis/config/auto-move	new_to_using, using_to_done, done_to_new, using_to_done_delay	Bat/tat tung chang + do tre

Hình 8.2. Set Auto Move: 3 toggle chang + Do Tre USING->DONE.

Hình 8.3. Set Using Timeout: so giay timeout IP dang dung.

Chương 9 — Nhom IP Statistics (Thong Ke)

Thong ke chat luong pool: so IP Unique vs Duplicate theo thoi gian/nha mang, top IP trung lap.

Hình 9.1. Dropdown Action nhom IP Statistics (Thong Ke) — moi dong kem tom tat.

Action (khong emoji)	HTTP	Tham so	Chuc nang
Bieu Do Thong Ke Unique vs Duplicate	GET /api/ip-stats/chart	workpool*, range, network	Chuoi thoi gian unique vs duplicate
Danh Sach WorkPool Da Thong Ke	GET /api/ip-stats/workpools	(khong)	Liet ke WorkPool co du lieu
Danh Sach Nha Mang Da Thong Ke	GET /api/ip-stats/networks	(khong)	Liet ke nha mang co du lieu
Tong Hop So Luong IP Unique & Luot Quet	GET /api/ip-stats/pool-info	(khong)	Bao cao tong hop theo pool
Top IP Trung Lap Nhieu Nhat	GET /api/ip-stats/top-duplicates	workpool*, limit, network	Top IP bi cap trung nhieu nhat
Xoa Sach Du Lieu Thong Ke IP	POST /api/ip-stats/clear	(khong)	Xoa lich su thong ke (SQLite)

Hình 9.2. Chart: WorkPool, Khung Thoi Gian (dropdown), Nha Mang.

Hình 9.3. Dropdown Khung Thoi Gian: day/week/month/3month.

Hình 9.4. Top Duplicates: WorkPool, Gioi Han, Nha Mang.

Chương 10 — Nhom Audit Trail (Nhat Ky Kiem Toan)

Truy xuat nhat ky su kien he thong (doi IP, reboot, timeout, loi) va xep hang DCOM loi nhieu.

Hình 10.1. Dropdown Action nhom Audit Trail (Nhat Ky Kiem Toan) — moi dong kem tom tat.

Action (khong emoji)	HTTP	Tham so	Chuc nang
Lich Su Su Kien Kiem Toan (Audit Events)	GET /api/audit/events	hours, workpool, event_type, dcom_id, limit	Danh sach su kien co bo loc
Tong Hop Su Kien Theo WorkPool	GET /api/audit/summary	hours	Dem su kien theo WorkPool
Xep Hang DCOM Reboot/Timeout Nhieu Nhat	GET /api/audit/reboot-ranking	hours, limit	Phat hien modem/SIM loi
Xoa Toan Bo Lich Su Su Kien	POST /api/audit/clear	(khong)	Xoa nhat ky (SQLite)

Hình 10.2. Audit Events: hours, workpool, event_type, dcom_id, limit.

Chương 11 — Nhom System Health (Chan Doan)

Kiem tra suc khoe cac thanh phan cua tram dieu khien proxy.

Hình 11.1. Dropdown Action nhom System Health (Chan Doan) — moi dong kem tom tat.

Action (khong emoji)	HTTP	Tham so	Chuc nang
Kiem Tra Suc Khoe Toan Dien	GET /health	(khong)	FastAPI B30, Redis, MQTT, heartbeat Host
Kiem Tra Ket Noi Redis Server	GET /api/redis/status	(khong)	Host, port, ping latency Redis
Kiem Tra Ket Noi MQTT Broker	GET /api/mqtt/status	(khong)	Broker IP, port, connected state

PHẦN IV

CAC TAC VU CHINH

Chương 12 — Quy trinh chuan

Tac vu 1 — Cap mot IP sach cho profile

1. Chon nhom IP State, action Doc Danh Sach IP Moi (03_NEW_IP).

2. Dien WorkPool (vd WP1) va (tuy chon) Proxy Name de loc.

3. Bat Get One First -> node tra 1 IP kem publicIp/proxy o cap root $json.

4. Node sau lay ={{$json.publicIp}} / ={{$json.proxy}} gan cho profile GPM.

5. Sau khi dung xong, dung Move State chuyen IP tu 03_NEW_IP sang 04_USING_IP (roi 05_DONE_IP).

Tac vu 2 — Doi IP khi bi chan

1. Chon nhom DCOM Control, action Doi IP DCOM.

2. Dien WorkPool + DCOM ID (vd WP1 / eth1).

3. B30 phat changeIpRequest; DCOM xin IP moi; doc lai bang 03_NEW_IP de lay IP moi.

Tac vu 3 — Bat vong xoay IP tu dong

1. Chon nhom Auto Move, action Thiet Lap Cau Hinh Auto Move IP.

2. Bat NEW->USING, USING->DONE, DONE->NEW theo nhu cau; dat Do Tre USING->DONE.

3. Dat timeout USING (action Cai Dat Timeout) de thu hoi IP neu worker crash.

MẸO · GET ONE FIRST GIUP DOWNSTREAM DON GIAN

Khong bat Get One First thi phai tu duyet mang data[]. Bat len thi publicIp/proxy nam ngay cap root, node ke tiep dung thang ={{$json.publicIp}}.

PHẦN V

VAN HANH HANG NGAY

Chương 13 — Giam sat va cau hinh ket noi

Base URL dung o dau

Ngu canh	Base URL
Trong mang Docker n8n (mac dinh)	http://lotus_python_proxy_script:8080
Qua IP tinh noi bo container B30	http://114.114.114.30:8080
Tu may Host / Lab (test ngoai)	http://127.0.0.1:20300

Giam sat suc khoe

system.health — kiem tra tong the B30 + Redis + MQTT + heartbeat Host.
system.redis_status / mqtt_status — soi rieng tung ket noi khi health bao do.
stats.get_pool_info / get_top_duplicates — do chat luong pool: ti le trung lap cao = nha mang cap lai IP cu.
audit.get_reboot_ranking — phat hien modem/SIM/cong USB hong (reboot/timeout nhieu).

PHẦN VI

AN TOAN

Chương 14 — Cac thao tac pha huy

Mot so action xoa du lieu, khong hoan tac. Can than khi dung tren pool that.

Action	Hau qua	Luu y
state.clear_key	Xoa sach 1 bang Redis (vd 04_USING_IP)	Mat trang thai IP dang dung — worker co the mat IP
stats.clear	Xoa lich su thong ke IP (SQLite)	Mat du lieu unique/duplicate lich su
audit.clear	Xoa toan bo nhat ky su kien	Mat dau vet dieu tra su co
dcom.change_ip_all / reboot_all	Tac dong DONG LOAT ca WorkPool	Anh huong moi profile dang chay tren pool do

NGUY HIỂM · BASE URL SAI = GOI NHAM HE THONG

Base URL tro toi B30 nao thi tac dong len pool do. Kiem ky Base URL truoc khi chay cac action ghi/xoa/reboot. Cac cong 20350/20351 (B35) va API noi bo KHONG duoc mo ra Internet.

PHẦN VII

RUI RO VA SU CO

Chương 15 — Kich ban hong thuong gap

Kich ban	Bieu hien	Xu ly
B30 chua chay / sai Base URL	Node loi 'Loi khi goi API B30... Kiem tra ket noi'	Kiem B30 song (system.health tu host 20300), sua Base URL
Redis B27 mat ket noi	system.redis_status bao loi; doc bang tra rong	Kiem container B27, mang Docker
MQTT broker mat ket noi	change_ip khong co IP moi; mqtt_status do	Kiem broker 128.199.200.17 + Host B12
Get One First tra rong	publicIp = '' , success=false	Pool NEW het IP — chay change_ip truoc
Timeout HTTP	Node bao het thoi gian cho B30	Tang Request Timeout; kiem B30 co treo khong

PHẦN VIII

KHAC PHUC SU CO (BANG TRA)

Chương 16 — Trieu chung -> nguyen nhan -> cach chua

Trieu chung	Nguyen nhan co the	Cach chua
Tat ca action loi ket noi	Base URL sai / B30 chet	Doi Base URL; kiem B30 tu host :20300
Doc IP luon rong	Pool het IP moi / loc sai workpool	Chay change_ip; kiem ten workpool/proxy_name
Doi IP khong ra IP moi	DCOM treo / mat song / MQTT dut	reboot_dcom; kiem mqtt_status; xem audit reboot-ranking
IP ket o USING mai	Worker crash khong tra IP	Dat timeout USING; bat Auto Move USING->DONE
Ti le trung lap cao	Nha mang cap lai IP cu	Xem top-duplicates; doi khung gio doi IP

PHẦN IX

THUC HANH

Chương 17 — Cac bai lab

Lab 1 — Kiem tra suc khoe he thong

Muc tieu — Xac nhan B30/Redis/MQTT deu song.
Buoc — System -> Kiem Tra Suc Khoe Toan Dien; neu do, chay redis_status va mqtt_status.
Dat khi — health tra cac thanh phan 'ok'.

Lab 2 — Cap 1 IP sach cho profile

Muc tieu — Lay 1 IP tu 03_NEW_IP gan cho profile.
Buoc — IP State -> Doc IP Moi (WP1, Get One First=true) -> doc $json.publicIp/proxy.
Dat khi — $json.publicIp co gia tri IPv4.

Lab 3 — Doi IP mot DCOM

Muc tieu — Lam moi IP cua eth1.
Buoc — DCOM Control -> Doi IP DCOM (WP1, eth1) -> doc lai 03_NEW_IP.
Dat khi — IP moi xuat hien trong 03_NEW_IP.

Lab 4 — Bat vong xoay IP + timeout

Muc tieu — Tu dong hoa vong doi IP.
Buoc — Auto Move -> Thiet Lap (bat 3 chang) + Cai Dat Timeout (300s).
Dat khi — get_auto_move phan anh dung cau hinh vua dat.

Lab 5 — Do chat luong pool

Muc tieu — Danh gia ti le IP trung lap.
Buoc — IP Statistics -> Bieu Do (WP1, week) va Top IP Trung Lap.
Dat khi — Doc duoc chuoi unique/duplicate va danh sach IP trung.

PHẦN PL

PHU LUC

Phụ lục A — Chi tiet 5 bang Redis va dinh dang khoa

Cac khoa Redis theo tien to LOTUS:03_PROXY:. Move State can khoa day du (from_key/to_key).

01_INFO — LOTUS:03_PROXY:01_INFO_JSON_MAN — thong tin DCOM.
02_ALIVE — LOTUS:03_PROXY:02_CLIENT_ALIVE_JSON_MAN — client alive.
03_NEW_IP — LOTUS:03_PROXY:03_NEW_IP — hang doi IP moi.
04_USING_IP — LOTUS:03_PROXY:04_USING_IP — IP dang dung.
05_DONE_IP — LOTUS:03_PROXY:05_DONE_IP — IP da xong.

Phụ lục B — Bang day du 32 action -> HTTP endpoint

Nhom	Action	HTTP Method & Path
DCOM Control	Doi IP DCOM (changeIpRequest)	POST /api/mqtt/change-ip
DCOM Control	Doi IP Toan Bo Pool	POST /api/mqtt/change-ip-all
DCOM Control	Khoi Dong Lai DCOM	POST /api/mqtt/reboot-dcom
DCOM Control	Khoi Dong Lai Tat Ca DCOM	POST /api/mqtt/reboot-all
DCOM Control	Yeu Cau Cap Nhat Trang Thai	POST /api/mqtt/request-info
DCOM Control	Xoa Cache Client Alive Tren Host	POST /api/mqtt/clear-client-alive
DCOM Control	Xoa Cache Proxy Info Tren Host	POST /api/mqtt/clear-proxy-info
IP State & Redis	Doc Toan Bo 5 Bang Redis	GET /api/redis/all
IP State & Redis	Doc Danh Sach IP Moi (03_NEW_IP)	GET /api/redis/new-ip
IP State & Redis	Doc Danh Sach IP Dang Dung (04_USING_IP)	GET /api/redis/using-ip
IP State & Redis	Doc Danh Sach IP Da Xong (05_DONE_IP)	GET /api/redis/done-ip
IP State & Redis	Doc Thong Tin DCOM Hien Huu (01_INFO)	GET /api/redis/info
IP State & Redis	Doc Danh Sach Client Alive (02_ALIVE)	GET /api/redis/client-alive
IP State & Redis	Chuyen Doi Trang Thai IP (Move State)	POST /api/redis/move-ip
IP State & Redis	Xoa Du Lieu Bang Redis (Clear Key)	DELETE /api/redis/clear/:key_alias
Auto Move & Timeout	Xem Cau Hinh Timeout IP Dang Dung	GET /api/redis/config/using-timeout
Auto Move & Timeout	Cai Dat Timeout IP Dang Dung	POST /api/redis/config/using-timeout
Auto Move & Timeout	Xem Cau Hinh Auto Move IP	GET /api/redis/config/auto-move
Auto Move & Timeout	Thiet Lap Cau Hinh Auto Move IP	POST /api/redis/config/auto-move
IP Statistics	Bieu Do Thong Ke Unique vs Duplicate	GET /api/ip-stats/chart
IP Statistics	Danh Sach WorkPool Da Thong Ke	GET /api/ip-stats/workpools
IP Statistics	Danh Sach Nha Mang Da Thong Ke	GET /api/ip-stats/networks
IP Statistics	Tong Hop So Luong IP Unique & Luot Quet	GET /api/ip-stats/pool-info
IP Statistics	Top IP Trung Lap Nhieu Nhat	GET /api/ip-stats/top-duplicates
IP Statistics	Xoa Sach Du Lieu Thong Ke IP	POST /api/ip-stats/clear
Audit Trail	Lich Su Su Kien Kiem Toan (Audit Events)	GET /api/audit/events
Audit Trail	Tong Hop Su Kien Theo WorkPool	GET /api/audit/summary
Audit Trail	Xep Hang DCOM Reboot/Timeout Nhieu Nhat	GET /api/audit/reboot-ranking
Audit Trail	Xoa Toan Bo Lich Su Su Kien	POST /api/audit/clear
System Health	Kiem Tra Suc Khoe Toan Dien	GET /health
System Health	Kiem Tra Ket Noi Redis Server	GET /api/redis/status
System Health	Kiem Tra Ket Noi MQTT Broker	GET /api/mqtt/status

Phụ lục C — Bay da tra gia (memory IP_Pool / Zone2)

C.1 — Broker MQTT la VPS ngoai, remote_port ao

Broker MQTT that la 128.199.200.17:1883 (VPS ngoai), KHONG phai B06 noi bo. Trong he thong IP Pool, remote_port = 127001 la cong AO nghia 'session local' — moi cho do cong phai loai no ra.

C.2 — Client that o VM WP3, khong bat B14 tren HP1

Client RapidProxy that chay o VM WP3 172.16.30.21 (Docker), khong phai B14 tren HP1. DELL_Proxy nay o WP3 172.16.30.201:6868 (hien chi toi duoc tu trong LAN WP3). Bat B14 tren HP1 vua khong toi duoc thiet bi vua dang ky client trung ten.

C.3 — Lenh doi IP: changeIpRequest

Da sua typo changIpRequest -> changeIpRequest (2026-08-14); ben nhan chap nhan ca hai. Khi debug lenh doi IP, dung ten dung changeIpRequest.

C.4 — grep code IP_Pool phai dung command grep

Code IP_Pool nam trong Application/ = gitignored. grep o shell nay la ugrep bo qua file gitignored, nen phai dung command grep -rn khi tim trong code IP_Pool.

C.5 — B30 co giao trinh rieng

B30 (ScanIpProxy) da co giao trinh HDID_00017. C13 chi la giao dien n8n; chi tiet nghiep vu pool, auto-healing, Tuya IoT... xem giao trinh B30.

Phụ lục D — Tham so, thuat ngu, nguon

D.1 — Y nghia cac tham so hay dung

Tham so	Y nghia	Vi du
workpool	Vung lam viec / nhom may proxy	WP1, WP2, all
dcom_id	Cong DCOM USB tren Host	eth1, eth2
proxy_name	Ten may/card proxy	DELL_PROXY_01
get_one_first	Chi lay 1 IP dau + gan publicIp/proxy o root	true / false
from_key / to_key	Khoa Redis nguon/dich khi Move State	LOTUS:03_PROXY:03_NEW_IP
public_ip	IPv4 can chuyen trang thai	171.244.12.34
key_alias	Alias bang Redis can xoa	03_NEW_IP..05_DONE_IP
timeout_sec	Timeout USING (giay, > 0)	60, 300, 1800
range	Khung thoi gian thong ke	day, week, month, 3month
hours	So gio nhin lai audit (1..2160)	24, 72, 168
limit	So ban ghi toi da (1..5000)	50, 100, 500

D.2 — Thuat ngu

Thuat ngu	Y nghia
B30	lotus_python_proxy_script — may chu FastAPI quan ly IP Pool
B27	lotus_redis — kho trang thai IP (:20270)
DCOM	Modem USB 4G cap Public IP dong tu nha mang
WorkPool (WP)	Nhom may proxy o mot dia diem
Get One First	Che do tra 1 IP dau tien kem publicIp/proxy o root
Auto Move	Tu dong chuyen IP giua cac bang trang thai

D.3 — Nguon va cach dung tai lieu

Ma nguon — LotusIpPool.node.ts (~1119 dong); doi chieu ban dist trong container (0.1.4).
Tai lieu noi bo — Agent_Readme.md, Agent_Actions_Reference.md, memory ip-pool-zone2.
Anh chup — node that trong n8n (2.36.8) tren Chrome that (B35), workflow tao rieng de lam tai lieu.
Cong cu — docs/tools/docgen (shot_kit, annotate_kit, doc_kit) + skill /UID_04.

GHI CHÚ · MUC LUC VA SO TRANG

Mo bang Microsoft Word roi bam Ctrl+A -> F9 de sinh/cap nhat muc luc kem so trang. Ban PDF di kem da co muc luc dien san so trang.