docker部署Antigravity-Manager

Antigravity-Manager：专业级AI账号管理与协议代理系统详解

一、项目简介

Antigravity-Manager 是一款专业的 AI 账号管理与切换工具，为 Antigravity 提供一键无缝账号切换功能。它不仅是一个账号管理工具，更是打破 API 调用壁垒的终极解决方案。通过该工具，您可以将常见的 Web 端 Session (Google/Anthropic) 转化为标准化的 API 接口，消除不同厂商间的协议鸿沟。

核心功能亮点：

智能账号仪表盘：全局实时监控所有账号的健康状况
强大的账号管家：支持 OAuth 2.0 授权、多维度导入
协议转换与中继：兼容 OpenAI、Anthropic、Gemini 等多种协议
模型路由中心：支持自定义模型映射与智能分级路由
多模态与 Imagen 3 支持：高级画质控制与超强 Payload 支持

二、安装指南

1. 官方资源

GitHub 地址 ：https://github.com/lbjlaq/Antigravity-Manager
最新版本：v4.1.28 (截至2026年3月31日)

2. Docker 安装（推荐）

Docker 部署是服务器或 NAS 环境下的最佳选择，安装过程简洁高效。

2.1 基本命令

bash 复制代码

# 直接运行 (推荐)
# - API_KEY: 必填。用于所有协议的 AI 请求鉴定。
# - WEB_PASSWORD: 可选。用于管理后台登录。若不设置则默认使用 API_KEY。
docker run -d --name antigravity-manager \
  -p 8045:8045 \
  -e API_KEY=sk-your-api-key \
  -e WEB_PASSWORD=your-login-password \
  -e ABV_MAX_BODY_SIZE=104857600 \
  -v ~/.antigravity_tools:/root/.antigravity_tools \
  lbjlaq/antigravity-manager:latest

2.2 不同架构镜像地址

由于网络原因，国内用户可能需要使用镜像加速：

x86_64 架构：

bash 复制代码

registry.cn-hangzhou.aliyuncs.com/qiluo-images/antigravity-manager:latest

ARM64 架构（如树莓派、Apple Silicon）：

bash 复制代码

registry.cn-hangzhou.aliyuncs.com/qiluo-images/linux_arm64_antigravity-manager:latest

完整命令示例（x86）：

bash 复制代码

docker run -d --name antigravity-manager \
  -p 8045:8045 \
  -e API_KEY=sk-your-api-key \
  -e WEB_PASSWORD=your-login-password \
  -e ABV_MAX_BODY_SIZE=104857600 \
  -v ~/.antigravity_tools:/root/.antigravity_tools \
  registry.cn-hangzhou.aliyuncs.com/qiluo-images/antigravity-manager:latest

2.3 重要参数说明

API_KEY：必填参数，用于所有协议的 AI 请求鉴权
WEB_PASSWORD：可选参数，用于管理后台登录，若不设置则默认使用 API_KEY
ABV_MAX_BODY_SIZE：请求体大小限制，单位为字节，示例中设置为 100MB (104857600 字节)
持久化卷 ：-v ~/.antigravity_tools:/root/.antigravity_tools 用于保存配置和账号数据

2.4 忘记密钥解决方案

如忘记设置的密钥，可通过以下命令找回：

bash 复制代码

# 查看容器日志
docker logs antigravity-manager

# 或直接查看配置文件
grep -E '"api_key"|"admin_password"' ~/.antigravity_tools/gui_config.json

3. 其他安装方式

除 Docker 外，Antigravity-Manager 还支持多种安装方式：

3.1 终端一键安装（推荐）

bash 复制代码

# Linux / macOS
curl -fsSL https://raw.githubusercontent.com/lbjlaq/Antigravity-Manager/v4.1.28/install.sh | bash

# Windows (PowerShell)
irm https://raw.githubusercontent.com/lbjlaq/Antigravity-Manager/main/install.ps1 | iex

3.2 手动下载

前往 GitHub Releases 下载对应系统的安装包：

macOS: .dmg (支持 Apple Silicon & Intel)
Windows: .msi 或便携版 .zip
Linux: .deb 或 AppImage

三、基本使用

1. 管理后台访问

安装完成后，通过浏览器访问：

管理后台：http://服务器IP:8045
API 地址：http://服务器IP:8045/v1

2. 添加账号

登录管理后台
点击 "Accounts / 账号" → "添加账号" → "OAuth"
按照弹窗提示完成授权流程
授权完成后，系统会自动保存账号

3. OAuth 授权流程详解

在应用中点击"添加账号"，系统会预生成授权链接
复制链接并在浏览器中打开完成授权
授权成功后，浏览器会显示"✅ 授权成功!"
应用会自动继续完成授权并保存账号；如未自动完成，可点击"我已授权，继续"手动完成

四、快速接入示例

1. 接入 Claude Code CLI

bash 复制代码

# 启动 Antigravity，并在"API 反代"页面开启服务
export ANTHROPIC_API_KEY="sk-antigravity"
export ANTHROPIC_BASE_URL="http://127.0.0.1:8045"
claude

2. Python 客户端接入

python 复制代码

import openai

client = openai.OpenAI(
    api_key="sk-antigravity",
    base_url="http://127.0.0.1:8045/v1"
)

response = client.chat.completions.create(
    model="gemini-3-flash",
    messages=[{"role": "user", "content": "你好，请自我介绍"}]
)
print(response.choices[0].message.content)

3. 图片生成 (Imagen 3) 示例

python 复制代码

import openai

client = openai.OpenAI(
    api_key="sk-antigravity",
    base_url="http://127.0.0.1:8045/v1"
)

# 生成图片
response = client.images.generate(
    model="gemini-3-pro-image",
    prompt="一座未来主义风格的城市，赛博朋克，霓虹灯",
    size="1920x1080",  # 支持任意 WIDTHxHEIGHT 格式
    quality="hd",      # "standard" | "hd" | "medium"
    n=1,
    response_format="b64_json"
)

# 保存图片
import base64
image_data = base64.b64decode(response.data[0].b64_json)
with open("output.png", "wb") as f:
    f.write(image_data)

五、高级配置

1. 鉴权逻辑说明

场景 A：仅设置了 API_KEY
- Web 登录：使用 API_KEY 进入后台
- API 调用：使用 API_KEY 进行 AI 请求鉴权
场景 B：同时设置了 API_KEY 和 WEB_PASSWORD (推荐)
- Web 登录：必须使用 WEB_PASSWORD，使用 API Key 将被拒绝（更安全）
- API 调用：统一使用 API_KEY

2. Docker 环境变量配置

bash 复制代码

# 指定数据存储目录
-e ABV_DATA_DIR=/app/data

# 仅绑定本地地址（更安全）
-e ABV_BIND_LOCAL_ONLY=true

# 自定义最大请求体大小
-e ABV_MAX_BODY_SIZE=104857600  # 100MB

3. 模型映射与路由设置

在"模型路由中心"页面，您可以：

设置系列化映射：将复杂的原始模型 ID 归类到"规格家族"
专家级重定向：支持自定义正则表达式级模型映射
智能分级路由：根据账号类型（Ultra/Pro/Free）自动优先级排序

六、常见问题解决

1. 403 Forbidden 错误处理

检查 API 响应中是否包含 Google 验证链接
确认账号是否符合 Google One AI 计划使用要求
部分 403 错误可能会在等待一段时间后自动恢复正常

2. Docker 容器重启后配置丢失

确保正确挂载了持久化卷：

bash 复制代码

-v ~/.antigravity_tools:/root/.antigravity_tools

3. 配额耗尽问题

系统会自动轮换到可用账号
可在"API 反代"页面查看账号健康状态
启用"额度保护"功能，防止配额被意外耗尽

七、安全提示

重要提醒：由于谷歌加强风控，第三方工具会违反服务条款而被暂停使用 Antigravity、Gemini CLI 或 Gemini Code Assist。使用第三方软件、工具或服务访问 Antigravity、Gemini CLI 或 Gemini Code Assist（例如，使用 OpenClaw 和 Antigravity OAuth）违反了适用的条款和政策。此类行为可能导致您的帐户被暂停或终止。

如果认为帐户被误封，可通过此链接进行申诉。

八、结语

Antigravity-Manager 作为一款专业的 AI 账号管理与协议代理工具，通过其强大的功能集，为 AI 开发者和爱好者提供了稳定、高速且成本低廉的本地 AI 中转解决方案。无论是个人使用还是团队协作，它都能显著提升多账号管理和 API 调用的效率。

随着 AI 生态的不断发展，Antigravity-Manager 也在持续迭代更新，为用户提供更完善的功能和更稳定的体验。建议关注项目 GitHub 页面或官方 Telegram 频道，获取最新动态和功能更新。

本文基于 v4.1.28 版本整理，如有更新，请以官方文档为准。