1 line
5.1 KiB
JSON
1 line
5.1 KiB
JSON
{"repo": "ccbkkb/aizasy", "files": {"README.md": {"98f3799feacdbe9579ac4f05e4bf4a5b3e22de32": {"t": 1785846893.1331482, "n": 3293, "h": "782bdbb91dcefb9a", "c": "# AIzaSy - Gemini API Gateway ⚡\n\n\n\n\n\n\n**AIzaSy** 是一个专为 Google Gemini API 设计的极简、高性能、绝对隐私优先的反向代理网关。\n\n本项目诞生于一个极客目标：**如何在仅有 1 核 1GB 内存 (1C1G) 的低端 VPS 上，实现千万级高并发的 API 转发，并完美规避 Google 严苛的 IP 风控？**\n\n最终，我们融合了 Go 语言并发调优、Docker 网络隔离与 Linux 内核级 WireGuard 路由，打造出了这套开箱即用的终极数据管道。\n\n---\n\n## ✨ 核心特性\n\n* 🛡️ **自带 Cloudflare WARP 出口洗白**\n * 内置自动化脚本，首次启动时**全自动注册并提取 WARP 节点**。\n * 通过赋予容器 `NET_ADMIN` 权限，在 Docker 内部拉起 Linux 内核级 `wg0` 网卡。\n * 所有发往 Google 的 API 请求会被强制路由至 Cloudflare 骨干网，彻底隐藏 VPS 真实机房 IP，**完美免疫 Google WAF 封锁与网段清洗**。\n* 🚀 **榨干 1C1G 的极限性能调优**\n * 放弃沉重的框架，采用经过极致优化的 Go 原生 `net/http`。\n * 引入 `sync.Pool` 内存对象复用，彻底拯救低配机器在高并发下的 GC 压力。\n * 内部隔离并注入 C100K 级别的 `sysctl` 操作系统网络参数。\n* 🔒 **绝对隐私保护 (Zero-Knowledge Logging)**\n * 严格遵循 **BYOK (Bring Your Own Key)** 原则。\n * **网关绝对不记录、不存储、不拦截任何 API Key。**\n * 底层日志输出采用“无差别全域抹杀”正则算法，无论你在 URL 中携带多长的私钥，控制台与日志中只会留下 `?key=***`，确保万无一失。\n* ⚡ **完美支持流式输出 (SSE)**\n * 针对 AI 大模型打字机效果深度优化，抛弃响应缓冲 (`FlushInterval = -1`)，实现零延迟数据透传。\n* 🐳 **真正的零配置 (Zero-Config) 部署**\n * 一行代码拉起，无需配置繁琐的 WireGuard 参数，无需折腾 Go 编译环境。支持 `x86_64` 与 `arm64` 双架构。\n\n---\n\n## 🚀 快速部署 (Quick Start)\n\n你只需要一台安装了 Docker 和 Docker Compose 的 Linux 服务器（需内核支持 WireGuard，主流 VPS 均满足）。\n\n### 1. 创建 `docker-compose.yml`\n\n创建一个新目录并写入以下配置文件：\n\n```yaml\nservices:\n aizasy-api:\n image: ghcr.io/ccbkkb/aizasy:latest\n container_name: aizasy-gateway\n restart: always\n ports:\n - \"8080:8080\" # 左侧可修改为你宿主机想暴露的端口\n \n # 允许配置动态跨域 (留空或不写则默认允许所有来源 '*')\n environment:\n - CORS_ALLOWED_ORIGINS=*\n \n # 【核心：赋予容器操作内核网卡的权限】\n cap_add:\n - NET_ADMIN\n - SYS_MODULE\n \n volumes:\n # 持久化 WARP 配置文件，防止重启后重新注册触发风控\n - warp-data:/etc/wireguard\n \n # 突破文件句柄限制\n ulimits:\n nofile:\n soft: 1048576\n hard: 1048576\n \n # 注入高并发内核参数与路由防崩溃标记\n sysctls:\n - net.ipv4.conf.all.src_valid_mark=1\n - net.core.somaxconn=65535\n - net.ipv4.tcp_tw_reuse=1\n - net.ipv4.ip_local_port_range=1024 65000\n - net.ipv4.tcp_keepalive_time=600\n\nvolumes:\n warp-data:\n```\n\n### 2. 一键启动\n\n```bash\ndocker compose up -d\n```\n> **提示：** 首次启动时，容器会在后台向 Cloudflare 申请免费的 WARP 账户并生成配置，大约需要 3-5 秒。你可以通过 `docker logs -f aizasy-gateway` 观察优雅的启动日志。\n\n---\n\n## 📖 如何使用 (Usage)\n\n部署成功并为你的服务器绑定域名后，只需在任何兼容 Gemini API 的客户端（如 LobeChat、ChatGPT-Next-Web）或代码中，将官方域名：\n`generativelanguage.googleapis.com`\n\n**替换为你的网关地址，例如：**\n`https://gemini.aizasy.com` (换成你自己的域名)\n\n**CURL 测试示例：**\n\n```bash\ncurl -H 'Content-Type: application/json' \\\n -X POST 'https://你的域名/v1beta/models/gemini-1.5-pro:generateContent?key=你的API_KEY' \\\n -d '{\n \"contents\":[{\"parts\":[{\"text\": \"用一句话解释量子计算。\"}]}]\n }'\n```\n\n---\n\n## 👨💻 鸣谢与开源声明\n\n* **Maintainer / Author**: [@ccbkkb](https://github.com/ccbkkb)\n* 本项目完全开源，旨在为开发者社区提供稳定、干净的 AI 接口聚合基础设施。\n* **Privacy Pledge**: We act solely as a dumb pipe. Your data is your data.\n* **Linux.do**: The place where the author studies and lives ❤️ & the largest Chinese-language AI discussion community 🔥.\n\n如果你觉得这个项目帮助到了你，欢迎点亮右上角的 ⭐️ **Star** ！\n"}}}} |