一个极度轻量、零感知、支持中枢遥控的 VPS IP 自动化养护与区域纠偏引擎。
📢 官方战术交流频道: 🛰️ IP-Sentinel Matrix
专为解决 VPS IPv4 被 Google 等数据库错误定位到中国大陆/香港（俗称“送中”）等问题而生。IP-Sentinel 已从单机脚本全面跃升为 Master-Agent 分布式架构。它像影子一样潜伏在全球各地的服务器后台，通过高度拟真的真实用户行为为你默默积累 IP 权重，并允许你通过 Telegram 随时随地对整个舰队进行毫秒级“点名”与“遥控”。
- 🗺️ 全球拓扑矩阵 (Global Nexus)：v3.0.0 新特性。引入动态
map.json索引中心与多级地理架构 (国家-省州-城市)。安装脚本全自动解析云端地图，支持无限扩展全球节点，真正实现“按图索骥”。 - ☁️ 云端中枢 (Public Master)：引入官方公共机器人 @OmniBeacon_bot，新手无需部署 Master 司令部，一键回车即可接入全球养护矩阵，极大降低入伍门槛。
- 🧠 分布式中枢 (Master-Agent)：对于硬核极客，支持私有化部署。一台 Master 主控集成 SQLite 数据库，统管无数台 Agent 边缘节点，确保数据绝对私有。
- 🎮 TG 战术面板 (Command Center)：无需记忆繁琐命令，原生 Inline Keyboard 按钮驱动。支持一键调出节点列表、一键下发伪装指令、一键索要精准战报、毫秒级抓取实时运行日志。
- 🛡️ NAT 穿透与安全网关 (NAT-Friendly)：边缘节点采用 Python3 极轻量 Webhook 监听，完全自定义通信端口，完美支持受限 NAT 小鸡。独创 TG 转发授权机制，杜绝野生节点恶意接入。
- 👻 高仿真人类行为 (Human-Like)：摒弃死板的 Ping/Curl，引入单次会话指纹锁定、10 米级 GPS 坐标微抖动、以及 60~150 秒的真实阅读停顿拉伸，完美避开 AI 封控。
- 📡 OTA 静默进化 (Smart Updates)：系统每周日凌晨自动从云端拉取最新的“热搜词汇”和“真实设备指纹池”，确保养护行为与时俱进、永不过时。
本项目采用企业级的“主从控制”与“冷热数据分离”双重架构：
📦 IP-Sentinel
┣ 📂 master/ # 🧠 司令部：SQLite 存储、TG 监听与 Webhook 调度中心
┣ 📂 core/ # 🛡️ 边缘哨兵：Webhook 被动监听、高拟真养护引擎
┗ 📂 data/ # 🗂️ 全球数据规则库 (v3.0 全新拓扑)
┣ 📜 map.json # 🌐 全球区域索引大脑 (Master Index)
┣ 📂 regions/ # 🧊 冷数据：按 [国家/省州/城市] 深度细分的 LBS 锚点
┣ 📂 keywords/ # 🔥 热数据：按国家归类的动态搜索词库 (OTA 自动更新)
┗ 📜 user_agents.txt # 🔥 热数据：全局真实设备指纹池
v3.0.0 提供了两种接入模式，请根据您的战术需求选择：
适合不想折腾、只想快速养护 IP 的新兵。
- 关注机器人：在 TG 中关注 @OmniBeacon_bot 并发送
/start。 - 部署 Agent：在目标 VPS 上执行以下指令，安装过程中直接回车使用官方机器人，并输入您的 Chat ID：
bash <(curl -sL https://raw.githubusercontent.com/hotyue/IP-Sentinel/main/core/install.sh)
- 激活节点：安装完成后，您的手机会收到一条 #REGISTER# 暗号，将其转发给机器人即可完成入库。
适合追求绝对数据隐私、需自建机器人的领主。
- 部署 Master：找一台 VPS 作为大脑（仅需部署一台），执行：
bash <(curl -sL https://raw.githubusercontent.com/hotyue/IP-Sentinel/main/master/install_master.sh)
- 部署 Agent：在需要养护的机器上执行 Agent 脚本，输入您自建机器人的 Token 以及与 Master 一致的配置。
bash <(curl -sL https://raw.githubusercontent.com/hotyue/IP-Sentinel/main/core/install.sh)
- 激活节点：同上，将暗号转发给您自己的机器人即可。
🗑️ 一键无痕卸载 如果你需要清理某个边缘节点，只需重新运行 core/install.sh 并选择 [3]，或直接在节点终端执行：
bash /opt/ip_sentinel/core/uninstall.sh
📡 战术联络 (Community) 如果你在使用过程中遇到任何疑难杂症，或者想围观大佬们的养护战报，欢迎加入我们的基地：
- Telegram 频道: @IP_Sentinel_Matrix
🤝 参与贡献 如果你想为项目增加新的节点区域（例如德国、英国、新加坡等），或者提供更丰富的本土化搜索词库，非常欢迎提交 Pull Request！
v3.0 全球节点贡献规范：
- 在
data/regions/国家代码/省州代码/目录下新增对应城市的配置.json。 - 在
data/keywords/目录下新增或完善配套国家的词库kw_XX.txt。 - 最重要的一步： 在
data/map.json中登记你的国家、省州与城市信息。安装脚本将自动读取地图，在全球雷达中点亮你的节点！
