diff --git a/README.md b/README.md index d80a6c0..153aa9c 100644 --- a/README.md +++ b/README.md @@ -1,44 +1,60 @@ -# 🛡️ IP-Sentinel (IP 哨兵) +# 🛡️ IP-Sentinel (分布式 IP 哨兵集群) -> **一个极度轻量、零感知的 VPS IP 自动化养护与区域纠偏引擎。** +> **一个极度轻量、零感知、支持中枢遥控的 VPS IP 自动化养护与区域纠偏引擎。** -专为解决 VPS IPv4 被 Google 等数据库错误定位到中国大陆/香港(俗称“送中”)等问题而生。IP-Sentinel 像影子一样潜伏在你的服务器后台,通过高度拟真的真实用户行为和动态养料注入,默默为你积累 IP 权重。 +专为解决 VPS IPv4 被 Google 等数据库错误定位到中国大陆/香港(俗称“送中”)等问题而生。IP-Sentinel 已从单机脚本全面跃升为 **Master-Agent 分布式架构**。它像影子一样潜伏在全球各地的服务器后台,通过高度拟真的真实用户行为为你默默积累 IP 权重,并允许你通过 Telegram 随时随地对整个舰队进行毫秒级“点名”与“遥控”。 ## ✨ 核心极客特性 -* 🪶 **极致轻量 (Zero-Resource)**:主控引擎采用 `nice -n 19` 进程降权机制,只在 CPU 绝对空闲时运行,对小内存 VPS 上的建站或代理等主营业务**真正零影响**。 -* 👻 **防僵尸网络特征 (Cron Jitter)**:独创全局随机休眠调度机制(0~1小时内随机触发),彻底打散全球并发请求,完美避开 Google AI 对大规模并发脚本的封控。 -* 🧠 **高仿真人类行为 (Human-Like)**:摒弃死板的 Ping/Curl,引入单次会话指纹锁定、10 米级 GPS 坐标微抖动、以及 60-120 秒的真实阅读停顿拉伸。 -* 📡 **OTA 静默进化 (Smart Updates)**:彻底解耦逻辑与数据。系统每周自动从云端节点拉取最新的“热搜词汇”和“真实设备指纹池”,确保养护行为永不过时。 - -## 🚀 极速安装 (一键部署) - -只需在你的 Linux 终端(Debian/Ubuntu/CentOS 等)以 root 身份运行以下一行命令,即可开启全自动养护: - -```bash -bash <(curl -sL https://git.94211762.xyz/hotyue/IP-Sentinel/raw/branch/main/core/install.sh) -``` - -*安装过程中将引导你选择目标区域(目前支持日本、美国等,规则库持续更新中)。* +* 🧠 **分布式中枢 (Master-Agent)**:彻底解决多台 VPS 的管理痛点。一台 Master 主控集成 SQLite 数据库与 Telegram 机器人,统管无数台 Agent 边缘节点,告别 API 消息冲突。 +* 🎮 **TG 战术面板 (Command Center)**:无需记忆繁琐命令,原生 Inline Keyboard 按钮驱动。支持一键调出节点列表、一键下发伪装指令、一键索要精准战报、**毫秒级抓取实时运行日志**。 +* 🛡️ **NAT 穿透与安全网关 (NAT-Friendly)**:边缘节点采用 Python3 极轻量 Webhook 监听,**完全自定义通信端口**,完美支持受限 NAT 小鸡。独创 TG 转发授权机制,杜绝野生节点恶意接入。 +* 👻 **高仿真人类行为 (Human-Like)**:摒弃死板的 Ping/Curl,引入单次会话指纹锁定、10 米级 GPS 坐标微抖动、以及 60~150 秒的真实阅读停顿拉伸,完美避开 AI 封控。 +* 📡 **OTA 静默进化 (Smart Updates)**:系统每周日凌晨自动从云端拉取最新的“热搜词汇”和“真实设备指纹池”,确保养护行为与时俱进、永不过时。 ## 📂 项目架构 (Monorepo) -本项目采用企业级的“冷热数据分离”架构: +本项目采用企业级的“主从控制”与“冷热数据分离”双重架构: ```text 📦 IP-Sentinel - ┣ 📂 core/ # 🧠 核心逻辑控制中心 (引擎、业务模块) + ┣ 📂 master/ # 🧠 司令部:SQLite 存储、TG 监听与 Webhook 调度中心 + ┣ 📂 core/ # 🛡️ 边缘哨兵:Webhook 被动监听、高拟真养护引擎 ┗ 📂 data/ # 🗂️ 全球数据规则库 ┣ 📂 regions/ # 🧊 冷数据:各地区 GPS 基准配置 (固化) ┣ 📂 keywords/ # 🔥 热数据:动态搜索词库 (OTA 自动更新) ┗ 📜 user_agents.txt # 🔥 热数据:全局真实设备指纹池 ``` -## 🤝 参与贡献 +🚀 极速部署 (Quick Start) +请准备一个 Telegram Bot Token 和你的个人 Chat ID。整个集群的部署分为两步: -如果你想为项目增加新的节点(例如德国、英国、新加坡等),或者提供更丰富的本土化搜索词库,非常欢迎提交 Pull Request! -只需在 `data/regions/` 新增对应国家的 JSON 规则,并在 `data/keywords/` 新增词库 txt 即可。 +第一步:部署中枢司令部 (Master) +找一台网络稳定的 VPS 作为大脑(仅需部署一台),以 root 身份执行: -## ⚠️ 免责声明 +```Bash +bash <(curl -sL https://git.94211762.xyz/hotyue/IP-Sentinel/raw/branch/main/master/install_master.sh) +``` +完成后,你的机器人将开始全局接客,等待边缘节点注册。 +第二步:部署边缘哨兵 (Agent) +在你需要养护 IP 的无数台目标机器(包括 NAT 机器)上执行: + +```Bash +bash <(curl -sL https://git.94211762.xyz/hotyue/IP-Sentinel/raw/branch/main/core/install.sh) +``` +安装时输入与 Master 相同的 Bot Token 及自定义 Webhook 端口。安装完毕后,请在手机 TG 端将生成的 #REGISTER# 暗号转发给机器人,完成安全授权入库! + +🗑️ 一键无痕卸载 +如果你需要清理某个边缘节点,只需重新运行 core/install.sh 并选择 [3],或直接在节点终端执行: + +```Bash +bash /opt/ip_sentinel/core/uninstall.sh +``` + +🤝 参与贡献 +如果你想为项目增加新的节点区域(例如德国、英国、新加坡等),或者提供更丰富的本土化搜索词库,非常欢迎提交 Pull Request! +只需在 data/regions/ 新增对应国家的 JSON 规则,并在 data/keywords/ 新增词库 txt 即可。 + +⚠️ 免责声明 本项目仅供网络原理研究、个人 VPS 维护学习使用。请遵守当地法律法规及目标服务商的 TOS(服务条款),切勿用于恶意高频请求或任何非法用途。使用者需自行承担因不当使用造成的 IP 封禁或其他相关风险。 \ No newline at end of file