4ndr0666/4ndr0ip

# 4ndr0ip: 自适应威胁中和

**4ndr0ip** 是一款浏览器扩展，旨在提供动态、有弹性的防御，以抵御 IP 记录服务和其他恶意跟踪器。与依赖过时的捆绑列表的静态拦截器不同，4ndr0ip 就像一个活体免疫系统，不断更新其情报，以便在威胁出现时将其中和。 ## 核心理念 静态防御已经过时。在基于 Web 的威胁不断变化的格局中，硬编码的拦截列表就像数字马奇诺防线——一种只能提供安全错觉的遗物。 4ndr0ip 基于**自适应防御**原则构建。它假设威胁形势在不断演变，并设计为随之演变，从而确保保护不是某个时间点的快照，而是一个持续的、自动化的过程。 ## 主要功能 - **动态威胁情报：** 每 24 小时自动从可信的远程源获取并应用最新的拦截列表。您的防御始终处于最新状态，无需手动更新扩展。 - **WebRTC 泄露防护：** 在 WebRTC 中禁用非代理的 UDP 连接，以防止您的真实 IP 地址暴露，即使在使用 VPN 时也是如此。 - **高性能过滤：** 利用 Chrome 原生的 `declarativeNetRequest` API 在网络层拦截恶意请求，在它们被处理之前。这确保了最大性能，且对浏览速度零影响。 - **零干预运行：** 安装后，4ndr0ip 在后台静默且自主地运行。无需配置任何设置，也不会中断您的工作流程。 - **设计上的弹性：** 内置强大的错误处理和数据清理协议。系统针对网络故障或情报源提供的格式错误数据进行了加固，确保稳定一致的运行。 ## 架构概览 4ndr0ip 是一个为现代 Web 构建的 Manifest V3 Chrome 扩展。其核心逻辑位于精简、高效的服务工作线程（`background.js`）中。 1. **初始化：** 安装后，扩展会立即获取最新的规则集，并创建一个持久化的闹钟，每 24 小时重新启动更新过程。 2. **数据获取：** 服务工作线程使用 `Promise.all` 并行获取多个拦截列表源，以实现最高效率。 3. **清理与摄入：** 所有传入的规则都经过程序化清理。系统显式地重建每条规则以匹配严格的 `declarativeNetRequest` 架构，丢弃任何多余或无效的数据。这一关键步骤保证了兼容性，并防止受污染的数据流导致 API 级别的错误。 4. **原子更新：** 新的、经过清理的规则集以原子方式应用。之前的所有动态规则集合在单个操作中被清除并替换，从而防止任何不一致或部分保护的状态。 ## 弹出窗口功能 扩展弹出窗口提供以下功能： - **扫描泄露：** 手动触发对当前页面的 IP 泄露扫描。 - **IPv6 检测：** 开启或关闭 IPv6 检测。 - **导出日志 (CSV)：** 将检测到的泄露日志导出为 CSV 文件。 - **清除日志：** 清除检测到的泄露日志。 - **显示泄露日志：** 切换泄露日志的显示。 ## 安装说明 1. 将此仓库下载为 `.zip` 文件并将其解压到本地计算机上的永久位置。 2. 打开 Google Chrome 并导航至 `chrome://extensions`。 3. 使用右上角的切换开关启用“开发者模式”。 4. 点击出现的“加载已解压的扩展程序”按钮。 5. 选择包含 `manifest.json` 的解压目录。 4ndr0ip 图标将出现在您的扩展工具栏中，并且它将立即开始其首次威胁情报更新。 ## 许可证 本项目在 MIT 许可证下获得许可。有关详细信息，请参阅 [LICENSE](LICENSE) 文件。

标签：declarativeNetRequest, DNS解析, IP地址保护, Manifest V3, MIT协议, Service Worker, VPN辅助, WebRTC泄露防护, 动态威胁情报, 反IP记录, 反追踪, 广告拦截, 开源项目, 恶意软件防护, 数据可视化, 浏览器扩展, 网络安全, 网络安全, 网络请求过滤, 自动化防御, 自定义脚本, 隐私保护, 隐私保护, 零干预