GitHub上开源项目 Antigravity-Proxy 详解：AntiGravity无需开启 TUN 代理模式配置，1分钟搞定！

Antigravity-Proxy 是一个开源的透明代理注入工具，专为 Antigravity AI IDE 设计，可在 Windows 下无 TUN 模式强制应用 SOCKS5/HTTP 代理。本文介绍项目原理、安装配置、使用方法及安全注意事项，适合开发者部署和调试网络环境。

一、Antigravity-Proxy 是什么？

Antigravity-Proxy（由 yuaotian 发布在 GitHub 上） 是一个专注于 Antigravity AI IDE 的开源透明代理注入工具。它的核心目的不是一般的 HTTP/SOCKS 代理，而是通过DLL 注入与进程流量劫持，在 Windows 环境下将 Antigravity 的网络请求强制导向指定的 SOCKS5 或 HTTP 代理，无需启用 TUN/虚拟网卡模式。

Antigravity 自身作为 Google 生态中的 AI 编程 IDE，在某些场景下其 API 请求可能直接跳过系统代理，导致网络代理设置无效。对于需要通过本地代理、调试工具、流量分析器或特殊 VPN 环境下工作的开发者来说，这一限制会成为阻碍。Antigravity-Proxy 就是为解决这一痛点而开发的工具。

二、项目核心特点

1. 免 TUN 强制代理

传统方法下，在使用代理时很多应用程序需要启用 TUN 或虚拟网卡来劫持流量。Antigravity-Proxy 则通过 DLL 注入的方式直接将目标进程网络请求重定向到代理服务器，无需启用系统级 TUN 驱动。这在 Windows 下尤其有用，因为 TUN 配置通常需要管理员权限或额外驱动安装。

2. 透明注入与流量劫持

该项目利用系统级注入技术，将自定义的代理逻辑注入到 Antigravity 应用进程中，从而对其发出的所有网络请求进行拦截与修改。这种方式类似“影子代理”，可以在程序内部实现代理控制逻辑，对开发者调试和本地网络测试非常便利。

3. 支持 SOCKS5 和 HTTP 代理

Antigravity-Proxy 可直接支持常见的代理协议，包括 SOCKS5 和 HTTP Proxy。这使其适配各种网络环境更灵活，例如用于局域网代理、远程调试代理、或者本地自建流量转发服务。

三、为何需要 Antigravity-Proxy？

Antigravity IDE 在国内或受限网络环境下，常见的问题包括：

API 请求绕过系统代理，导致无法访问模型服务；
在启用 TUN 模式失败或配置复杂时无法让 Antigravity 正常联网；
需要定制开发者侧的 API 代理、测试环境监控等。

在这些情况下，Antigravity-Proxy 提供了一种兼容性更好、部署更简单的方式来解决流量劫持与重定向问题。

四、如何安装与使用 Antigravity-Proxy

虽然该项目有实验性质，可能对新手存在一定难度，但基本使用流程如下（基于社区经验整理）：

环境要求

Windows 系统（优先支持）
需要配置好目标代理服务器（例如本地 SOCKS5 或 HTTP 代理）
拥有 Antigravity IDE 安装路径

安装步骤（简要）

从 GitHub 克隆 Antigravity-Proxy 仓库到本地。
根据 README（或 docs 目录）准备编译/注入工具和依赖环境。
配置代理参数，比如指定代理服务器地址与端口。
通过编译或构建工具生成注入 DLL，启动目标 Antigravity 进程时注入该模块。

注意：注入操作需要管理员权限，并且应仅用于研发或本地调试环境，避免在生产或不受信任环境下使用。

五、项目架构与实现原理

Antigravity-Proxy 的实现核心包括以下几个部分：

DLL 注入模块
利用 Windows 进程注入技术，将代理拦截模块注入到 Antigravity IDE 进程中，以实现对网络请求 API 调用的替换逻辑。
代理劫持拦截逻辑
注入模块拦截网络层 API（例如 Winsock 或 HTTP 请求函数），根据配置将流量转发到指定代理。
配置与运行脚本
项目仓库通常包含配置示例文件、构建脚本和调试说明，便于二次开发和测试。
日志与调试支持
可输出代理状态、被劫持请求、目标响应等日志信息，便于开发者分析和调试。

这些机制使 Antigravity-Proxy 不依赖系统底层 TUN 驱动，而是直接在进程内进行网络操作控制。

六、安全性与风险提示

使用 Antigravity-Proxy 时需要注意下面风险：

注入与劫持类工具可能被杀毒软件误报或阻止，需先在安全软件中排除相关行为。
DLL 注入本身具有一定安全风险，应确保使用来源可信并清楚原理，不要在未知环境或生产机器中运行。
务必不要将敏感 API Key 或凭据暴露在公共代理中，以免泄露或滥用。

整体上，该工具更适合开发环境调试、测试网络流量或学习研究使用。

七、实际应用场景示例

1. 本地代理调试

当 Antigravity 出现 API 请求无法通过本地代理转发时，可使用 Antigravity-Proxy 强制将请求重定向到本地调试代理（如 Charles、Fiddler、Burp Suite）。

2. 网络环境受限访问

在某些受限网络环境（如公司内网或防火墙限制）下，Antigravity 可能无法正常连接外部服务。使用 Antigravity-Proxy 可让开发者通过指定代理绕过限制。

3. 负载监控与日志记录

对于研究人员或系统开发者来说，Antigravity-Proxy 可以捕获和记录 IDE 发送的 API 请求与响应，便于追踪数据流和问题分析。

八、与其它 Antigravity 生态工具对比

在 GitHub 上，与 Antigravity-Proxy 相关的工具还有不少，例如：

Antigravity-Manager（账号管理）：为 Antigravity 工具提供账号切换和管理功能，方便切换不同 API Key 等配置。
Antigravity-Claude-Proxy：可以将 Antigravity 内部模型暴露出来用于其他工具调用，例如 Claude Code 等。

与这些工具不同，Antigravity-Proxy 核心聚焦在代理劫持与网络流量控制。这使它在特定场景下的价值更为明显，例如开发者需要在无 TUN 环境下强制代理流量。

九、结语

Antigravity-Proxy 是一个定位清晰的开源项目，它通过 Windows 注入与透明代理实现了 Antigravity IDE 网络控制的需求。对于开发者在本地进行代理调试、网络测试或复杂环境访问时，它提供了更灵活的解决方法。尽管目前项目仍属实验性，尚未完全兼容最新 Antigravity 版本，但它的技术思路和实现方式具有一定学习与实践价值。