From b64ab956582c835afd5e9578d9db00ed2af4de7f Mon Sep 17 00:00:00 2001 From: hotyue <52734432+hotyue@users.noreply.github.com> Date: Fri, 17 Apr 2026 15:05:05 +0000 Subject: [PATCH] =?UTF-8?q?docs:=20=E9=87=8D=E6=9E=84=E9=A1=B9=E7=9B=AE?= =?UTF-8?q?=E6=96=87=E6=A1=A3=EF=BC=8C=E6=AD=A3=E5=BC=8F=E5=8F=91=E5=B8=83?= =?UTF-8?q?=20v3.6.0=20=E9=9B=B6=E4=BF=A1=E4=BB=BB=20OTA=20=E6=9E=B6?= =?UTF-8?q?=E6=9E=84=E5=8F=8A=E5=85=A8=E8=88=B0=E9=98=9F=E5=8D=87=E7=BA=A7?= =?UTF-8?q?=E6=8C=87=E5=BC=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 52 +++++++++++++++++++++++++++++++--------------------- 1 file changed, 31 insertions(+), 21 deletions(-) diff --git a/README.md b/README.md index 7794aff..1d20e35 100644 --- a/README.md +++ b/README.md @@ -13,7 +13,8 @@ ## ✨ 核心极客特性 (Core Architecture) - 🎛️ **L5 降维中枢与动态状态机 (Microservices Console)**：引入四级战区降维解析与双轨身份制。全 Inline Keyboard 原位重绘交互，支持在 TG 面板一键下发毫秒级模块热启停 (Toggle)、丝滑改名与日志抓取，底层数据库实时刷新，彻底告别刷屏烦恼。 -- 🔄 **SSOT 溯源与热更新装甲 (Smooth Upgrade Engine)**：全系脚本彻底消灭硬编码，部署时动态抓取云端版本信标。搭载状态机嗅探逻辑与 OTA 预警探针，一键回车瞬间完成配置继承、数据同步与无损换代。 +- 🔄 **零信任 OTA 引擎 (Zero-Trust OTA Upgrade)**：[v3.6.0 巨献] 首创双端物理熔断机制。长官可通过私有中枢，一键向全球任意节点（或全舰队）下发 OTA 静默热重载指令。边缘节点自检授权后，将自动剥离交互进程、挂起后台拉取并无损覆盖系统内核，全程零感知。 +- 🛡️ **SSOT 溯源与热更新装甲 (Smooth Upgrade Engine)**：全系脚本彻底消灭硬编码，部署时动态抓取云端版本信标。自带状态机嗅探逻辑与防撞甲探测，即使是手动在终端运行安装，也仅需回车瞬间完成配置继承、数据同步与无损换代。 - 🗺️ **全球拓扑矩阵与活体词库 (Global Nexus)**：守护版图横跨亚欧美三大洲。接入 GitHub Actions 云端流水线，每日静默同步全球各大区当日 Google 真实热搜榜单与高权重本土站点，让伪装行为永远贴合当地网络脉搏。 - 👻 **资产持久化与错峰调度 (Hash-Seeded Persona)**：摒弃随机抽取指纹，基于节点物理 IP 哈希永久锁定 3 个绝对专属设备，完美构建高权重真实家庭内网画像。叠加按需智能分频与随机防并发休眠，化解“惊群效应”。 - 🖧 **底层路由死锁与高精度探针 (Hard-Bind Routing)**：底层探测引擎强力接管 curl 核心参数 (`--interface`)，将发出的每一滴伪装流量死死绑定在物理网卡或隧道 IP 上。配合多级 ISP 容灾链路，彻底杜绝双栈环境下的流量溢出与 API 误判。 @@ -39,7 +40,7 @@ ┃ ┣ 📂 regions/ # 🧊 冷数据：按 [国家/省州/城市] 深度细分的 LBS 锚点 ┃ ┣ 📂 keywords/ # 🔥 热数据：按国家归类的动态搜索词库 (OTA 自动更新) ┃ ┗ 📜 user_agents.txt # 🔥 热数据：由兵工厂每月锻造的绝对坐标专属设备库 - ┣ 📜 version.txt # 🚩 双端版本信标：Agent/Master 独立解耦的 KV 环境配置 (v3.5.1) + ┣ 📜 version.txt # 🚩 双端版本信标：Agent/Master 独立解耦的 KV 环境配置 ┗ 📂 telemetry/ # 👁️‍🗨️ 玻璃房计划：Cloudflare Workers 透明计数器网关源码 ``` @@ -49,11 +50,10 @@ ### 🔹 模式 A：私有独立模式 (全自主、强烈推荐) 适合追求绝对数据隐私与舰队最高控制权的领主。 - 💡 前瞻战略提示：强烈推荐采用私有部署！系统下一步即将支持基于私有中枢的 OTA 远程在线升级，届时全网边缘节点可实现一键静默换代！ +> ☢️ **核按钮系统已就绪**：采用私有部署，您将解锁 **OTA 远程静默升级** 权限！所有私有前线节点均可通过您的 TG 面板实现一键全网代码热重载换代！ -- 部署 Master (中枢大脑)：找一台 VPS 作为司令部（仅需部署一台），执行： - -```Bash +- **部署 Master (中枢大脑)**：找一台 VPS 作为司令部（仅需部署一台），执行： +```bash bash <(curl -sL https://raw.githubusercontent.com/hotyue/IP-Sentinel/main/master/install_master.sh) ``` - 部署 Agent (边缘哨兵)：在需要养护的机器上执行 Agent 脚本，安装时选择私有独立中枢，并分别输入您自建机器人的 [Token](https://blog.iot-architect.com/engineering-practice/create-private-telegram-bot-via-botfather) 以及您的个人 [Chat ID](https://blog.iot-architect.com/engineering-practice/get-telegram-personal-id-via-userinfobot) ： @@ -75,20 +75,26 @@ bash <(curl -sL https://raw.githubusercontent.com/hotyue/IP-Sentinel/main/core/i ``` - 激活节点：同上，将收到的暗号转发给官方机器人即可。 -### ⚠️ 架构级热升级指引 (Upgrade to v3.5.0) +## 🆙 架构级无损热升级指引 (Upgrade Guide) +### 📡 方式一：OTA 远程静默升级 (v3.6.0+ 私有中枢专属) +如果您是私有中枢领主，并且在前线节点安装时授权了 OTA 权限。当每日战报提示发现新版本时： -得益于 **v3.5.0 全新引入的 SSOT 版本锚点与状态机路由**，系统升级现已变得极其智能化。 +- 呼出您的司令部控制台 (/start)。 -**如果您是从远古旧版 (v3.3.1 / v3.3.2) 升级：** -1. 在终端再次运行对应的官方部署指令。 -2. 脚本会识别到您处于“前版本锚点时代”，会自动为您执行【跨代架构重组】。 -3. **关键动作**：由于节点命名防撞机制变更，升级后您的 TG 会收到一条新的 `#REGISTER#` 指令，请点击并发送一次以同步新身份。 -4. **清理**：在面板中手动剔除失联的旧节点即可。 +- 若需升级单个节点：进入 我的节点列表 -> 选择节点 -> ⚙️ 高级控制功能 -> 点击 🆙 远程升级客户端。 -**如果您已处于 v3.4.0+：** -所有的升级已进入**“极致静默平滑模式”**。安装引擎会动态抓取云端 `version.txt`，自动修正本地 `config.conf` 的版本号，一键回车，3 秒即可完成全系组件的热重载换代！ +- 若需升级全舰队：直接在顶级菜单点击 ⚠️ 全舰队 OTA 升级（请注意风险确认）。 -🗑️ 一键无痕卸载 +- 无需登录 SSH！ 节点收到指令后会在后台挂起静默拉取，并在几秒钟后通过 TG 重新给您发回带有新版本号的心跳确认！ + +### 💻 方式二：SSH 终端平滑直装 (适用于官方网关或老旧节点) +如果您的节点不支持 OTA，或者您的节点版本过于陈旧 (如 v3.3.1)： + +- 登录该节点的 SSH 终端，再次运行上面的 core/install.sh 官方安装指令。 + +- 安装引擎自带状态机嗅探逻辑，它会自动读取老旧数据，您只需一路回车，3 秒即可在本地完成配置继承、数据同步与新内核的无损覆盖热重载！ + +## 🗑️ 一键无痕卸载 如果你需要清理某个边缘节点，只需重新运行 `core/install.sh` 并选择 **[2]**，或直接在节点终端执行： ```Bash @@ -96,7 +102,7 @@ bash /opt/ip_sentinel/core/uninstall.sh ``` -### 🧓 传家宝老旧系统专用通道 (Debian 9) +## 🧓 传家宝老旧系统专用通道 (Debian 9) 如果你的小鸡系统版本过低（如 Debian 9），由于官方 APT 源已关闭且 Python 版本过旧，无法使用主线版本，请使用 **Legacy 兼容分支** 部署。 *(注意：该分支仅作基础维护，不享受新功能迭代，请尽可能升级你的系统)* @@ -105,19 +111,23 @@ bash /opt/ip_sentinel/core/uninstall.sh bash <(curl -sL https://raw.githubusercontent.com/hotyue/IP-Sentinel/legacy/core/install.sh) ``` -📡 战术联络 (Community) +## 📡 战术联络 (Community) + 如果你在使用过程中遇到任何疑难杂症，或者想围观大佬们的养护战报，欢迎加入我们的基地： - Telegram 频道: [@IP_Sentinel_Matrix](https://t.me/IP_Sentinel_Matrix) -🤝 参与贡献 +## 🤝 参与贡献 + 如果你想为项目增加新的节点区域（例如德国、英国、新加坡等），或者提供更丰富的本土化搜索词库，非常欢迎提交 Pull Request！ -**v3.0 全球节点贡献规范：** +## **v3.0 全球节点贡献规范：** + 1. 在 `data/regions/国家代码/省州代码/` 目录下新增对应城市的配置 `.json`。 2. 在 `data/keywords/` 目录下新增或完善配套国家的词库 `kw_XX.txt`。 3. **最重要的一步：** 在 `data/map.json` 中登记你的国家、省州与城市信息。安装脚本将自动读取地图，在全球雷达中点亮你的节点！ -⚠️ 免责声明 +## ⚠️ 免责声明 + 本项目仅供网络原理研究、个人 VPS 维护学习使用。请遵守当地法律法规及目标服务商的 TOS（服务条款），切勿用于恶意高频请求或任何非法用途。使用者需自行承担因不当使用造成的 IP 封禁或其他相关风险。 ## 保持联系