hotyue / IP-Sentinel

# 🛡️ IP-Sentinel (分布式 IP 哨兵集群)
> **一个极度轻量、零感知、支持中枢遥控的 VPS IP 自动化养护与区域纠偏引擎。**
> **💡 提示：如果本项目提升了您的节点稳定性，请点击右上角点亮 🌟 Star！您的支持是我们持续研发和维护指纹库的核心动力。**
📢 官方战术交流频道: 🛰️ IP-Sentinel Matrix
专为解决 VPS IP 被 Google 等数据库错误定位到中国大陆/香港（俗称“送中”）等问题而生。IP-Sentinel 已从单机脚本全面跃升为 **Master-Agent 分布式架构**。它像影子一样潜伏在全球各地的服务器后台，通过高度拟真的真实用户行为为你默默积累 IP 权重，并允许你通过 Telegram 随时随地对整个舰队进行毫秒级“点名”与“遥控”。
## ✨ 核心极客特性 (Core Architecture)
- 📊 **深海声呐全维探针 (Deep Sea Sonar)**：内嵌强效正则去污的 JSON 提取引擎，无损展现免掩码的真实 IP 情报。聚合 Scamalytics、AbuseIPDB 等五大权威防欺诈库，精准嗅探代理/VPN特征、25端口及流媒体原生解锁状态，并自带 Google “送中”高危预警与污染趋势图谱。
- ⚡ **无损高并发引擎 (WAL Concurrency)**：司令部 SQLite 数据库全面激活 `WAL` (Write-Ahead Logging) 模式与毫秒级排队算法。即使对 500 台边缘节点发起全军总攻，也能完美规避 `database is locked` 与 Telegram `429` 拦截。
- 🪶 **模块化极简部署 (Modular & Zero-Bloat)**：全栈剔除第三方依赖，基于 Python3 原生标准库运行。安装入口采用高内聚低耦合的引导层架构（Bootstrapper），配合 `bash -c` 纯净挂载，全面适配 Debian/Alpine/CentOS 等全系 Linux，杜绝管道流污染。
- 🎛️ **扁平化指挥矩阵 (Flat Command Matrix)**：引入扁平化四级战区降维视图与双轨身份制。深度定制 Inline Keyboard 逃生舱交互，支持原位丝滑重绘 (In-place UI Edit) 与二次高危确认（Secondary Confirmation），实现毫秒级模块热启停与跨地域深海声呐投放。
- 🔄 **全栈零信任 OTA 引擎 (Zero-Trust OTA Upgrade)**：首创双端物理熔断机制。长官可通过私有中枢，一键向全舰队下发静默热重载指令；更支持**「司令部金蝉脱壳」**，实现真正的全栈去 SSH 化运维。
- 🛡️ **自动化防线操纵 (Autopilot Firewalls)**：安装与卸载阶段自动嗅探底层组件（UFW / Firewalld / iptables / ip6tables），实施双栈（IPv4 & IPv6）冗余通道的自动化放行与闭环抹杀，全程零敞露。
- 🗺️ **全球拓扑矩阵与活体词库 (Global Nexus)**：接入 GitHub Actions 云端兵工厂，每日静默同步全球各大区真实热搜榜单与高权重本土站点，让伪装行为永远贴合当地网络脉搏。
- 👻 **绝对时空对齐与高频错峰 (UTC-Seeded Scheduling)**：全栈强制接管底层时钟为**绝对 UTC 时间**。全舰队以 **20 分钟 (每日 72 次)** 的极高密度进行养护巡逻，叠加基于部署锚点的天然削峰与随机防并发休眠，完美化解十万级集群的“惊群效应”。
- 🖧 **三级容灾架构与智能多宿主 (Multi-IP Fallback)**：底层引擎强力接管发包参数 (`--interface`) 并双重过滤 WARP/TUN 等假公网环境。创新引入三级阶梯脱壳与多宿主弹匣装填，彻底杜绝探针假死与流媒体失明误报。
**—— 💎 骨干基建特征 ——**
- 🏭 **全自动云端军工厂 (CI/CD Data Factory)**：依托 GitHub Actions 构建双轨无人值守流水线。**每月 1 日**批量锻造 4000+ 带有绝对物理分区的原生终端指纹库；**每日凌晨 (UTC)** 实时抓取全球各战区 Google 真实热搜榜单与本土骨干新闻 RSS。为前线舰队源源不断地输送最鲜活的伪装弹药。
- 🔒 **叹息之墙 (Zero-Trust HMAC)**：底层通讯引入 时间戳 + HMAC-SHA256 军用级动态签名。指令有效期仅 60 秒（阅后即焚），未授权请求直接触发系统级 403 物理熔断，彻底免疫中间人抓包与重放攻击。
- ☁️ **云端中枢 (Public Master)**：官方公共机器人 @OmniBeacon_bot ，新手免自建，一键接入极速入伍！同时支持硬核极客私有化 SQLite 分布式部署。
## 📂 项目架构 (Modular Monorepo)
本项目已迈入 v4.3.0 现代工程时代，采用高内聚的模块化与“冷热数据分离”双重架构：
 [code] 
## 🚀 极速部署 (Quick Start)
> 🛡️ **跨平台装甲支持**：Debian / Ubuntu / CentOS / RHEL / Alpine Linux / Arch Linux
⚠️ 指令规范：全系统已升级为防污染内存加载。请严格复制下方完整指令，切勿使用 curl | bash 以防中断！
系统现提供两种接入模式，请根据您的战术需求选择：
### 🔹 模式 A：私有独立模式 (全自主、强烈推荐)
适合追求绝对数据隐私与舰队最高控制权的领主。
> ☢️ **核按钮系统已就绪**：采用私有部署，您将解锁 **OTA 远程静默升级** 权限！所有私有前线节点均可通过您的 TG 面板实现一键全网代码热重载换代！
- **部署 Master (中枢大脑)**：找一台 VPS 作为司令部（仅需部署一台,可以与Agent装在同一台VPS），执行：
- 官方部署教程
 [code] 
- 部署 Agent (边缘哨兵)：在需要养护的机器上执行 Agent 脚本，安装时选择私有独立中枢，并分别输入您自建机器人的 Token 以及您的个人 Chat ID ：
- 官方部署教程
 [code] 
- 激活节点：安装完成后，您的手机会收到一条 #REGISTER# 注册暗号，将其转发给您自己的机器人即可完成编队入库。
### 🔸 模式 B：官方公共模式 (最简体验)
适合不想折腾、只想快速体验养护效果的新兵。
> ☢️ **核按钮系统已阉割**：采用官方BOT，您将失去 **OTA 远程静默升级** 权限！所有私有前线节点只能通过SSH登录进行更新换代！
- 关注机器人：在 TG 中关注官方安全网关 @OmniBeacon_bot 并发送 /start。
- 部署 Agent：在目标 VPS 上执行以下指令，安装过程中选择官方公共网关，并输入您的 Chat ID：
- 官方部署教程
 [code] 
- 激活节点：同