mirror of
https://github.com/hotyue/IP-Sentinel.git
synced 2026-06-29 21:31:32 +08:00
docs: 完善项目自述文档,发布初版
This commit is contained in:
44
README.md
44
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 封禁或其他相关风险。
|
||||
Reference in New Issue
Block a user