About this project

IP-Sentinel Lite is a lightweight monitoring and correction tool for VPS users. Its main features include egress IP detection, Google region correction, Telegram daily reports, and fully automatic operation based on systemd timers. The project is implemented natively in shell and depends only on curl and jq. The installation script supports interactive selection of regions and configuration of a Telegram Bot. The tool identifies IPv4, IPv6, and Cloudflare Warp through multi-level ISP probing, and simulates user behavior to gradually correct IP geolocation attribution, thereby solving the problem of Google region recognition deviation. The system includes two scheduled tasks: runner executes Google region correction every hour, and report refreshes data at UTC 04:30 every day and sends a Telegram daily report. The daily report covers node name, egress IP, IP attributes, number of correction executions, success/failure/warning statistics, win rate, recent execution snapshots, and system status summary. The project provides complete installation, update, and uninstall scripts as well as a troubleshooting guide. Logs can be viewed through journalctl or /opt/ip_sentinel/logs/sentinel.log. The README explicitly states that this tool is intended only for network principle research and VPS maintenance learning, and users must bear the risks arising from improper use.