From 6019a5899310cd311eeb44b13a9851fc1074b422 Mon Sep 17 00:00:00 2001 From: hotyue <52734432+hotyue@users.noreply.github.com> Date: Wed, 1 Apr 2026 06:50:06 +0000 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=AE=8C=E5=96=84=E9=A1=B9=E7=9B=AE?= =?UTF-8?q?=E8=87=AA=E8=BF=B0=E6=96=87=E6=A1=A3=EF=BC=8C=E5=8F=91=E5=B8=83?= =?UTF-8?q?=E5=88=9D=E7=89=88?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 44 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 44 insertions(+) diff --git a/README.md b/README.md index e69de29b..12bfd670 100644 --- a/README.md +++ b/README.md @@ -0,0 +1,44 @@ +# 🛡️ IP-Sentinel (IP 哨兵) + +> **一个极度轻量、零感知的 VPS IP 自动化养护与区域纠偏引擎。** + +专为解决 VPS IPv4 被 Google 等数据库错误定位到中国大陆/香港（俗称“送中”）等问题而生。IP-Sentinel 像影子一样潜伏在你的服务器后台，通过高度拟真的真实用户行为和动态养料注入，默默为你积累 IP 权重。 + +## ✨ 核心极客特性 + +* 🪶 **极致轻量 (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) +\`\`\` + +*安装过程中将引导你选择目标区域（目前支持日本、美国等，规则库持续更新中）。* + +## 📂 项目架构 (Monorepo) + +本项目采用企业级的“冷热数据分离”架构： + +\`\`\`text +📦 IP-Sentinel + ┣ 📂 core/ # 🧠 核心逻辑控制中心 (引擎、业务模块) + ┗ 📂 data/ # 🗂️ 全球数据规则库 + ┣ 📂 regions/ # 🧊 冷数据：各地区 GPS 基准配置 (固化) + ┣ 📂 keywords/ # 🔥 热数据：动态搜索词库 (OTA 自动更新) + ┗ 📜 user_agents.txt # 🔥 热数据：全局真实设备指纹池 +\`\`\` + +## 🤝 参与贡献 + +如果你想为项目增加新的节点（例如德国、英国、新加坡等），或者提供更丰富的本土化搜索词库，非常欢迎提交 Pull Request！ +只需在 `data/regions/` 新增对应国家的 JSON 规则，并在 `data/keywords/` 新增词库 txt 即可。 + +## ⚠️ 免责声明 + +本项目仅供网络原理研究、个人 VPS 维护学习使用。请遵守当地法律法规及目标服务商的 TOS（服务条款），切勿用于恶意高频请求或任何非法用途。使用者需自行承担因不当使用造成的 IP 封禁或其他相关风险。 \ No newline at end of file