AIRoute

基于 OmniRoute (v3.8.46) fork,全面适配中国网络环境、数据合规要求与国产云生态。

237+ Provider · 90+ 免费额度 · 17 种路由策略 · RTK+Caveman 压缩引擎

你遇到的问题,AIRoute 来解:

适合谁用?

• 个人开发者 — 零成本接入 90+ 免费模型,一个 API Key 搞定所有 AI 能力
• 创业团队 — 不用逐个对接 Provider,智能路由自动控成本、保可用
• 企业 IT — 合规、审计、加密、不出境,满足等保与《数据安全法》要求
• AI 应用构建者 — Coze/Dify 等 Agent 平台一键接入,MCP 95 工具开箱调用

目录

项目定位

国内增强特性

P0 — 合规底座(必选)

P1 — 功能增强

P2 — 企业级

架构概览

┌──────────────────────────────────────────────────────────┐
│ IDE / CLI (Claude Code, Codex, Cursor, Cline ...) │
└─────────────────────────┬────────────────────────────────┘
 │ http://localhost:20128/v1
 ▼
┌──────────────────────────────────────────────────────────┐
│ AIRoute — 智能路由网关 │
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌──────────────────┐ │
│ │ 区域感知路由 │ │ PIPI 合规层 │ │ 10级压缩管线 │ │
│ │ (CN优先策略) │ │ (脱敏/管控) │ │ (RTK+Caveman) │ │
│ └─────────────┘ └─────────────┘ └──────────────────┘ │
│ ┌─────────────┐ ┌─────────────┐ ┌──────────────────┐ │
│ │ ×ばつ3层 │ │ MITM 审计 │ │ MCP(95工具)/A2A │ │
│ │ (Provider/ │ │ (HMAC链式) │ │ (Coze/Dify适配) │ │
│ │ Key/Model) │ │ │ │ │ │
│ └─────────────┘ └─────────────┘ └──────────────────┘ │
└───────────────┬──────────┬──────────────┬────────────────┘
 ▼ ▼ ▼
 ┌──────────┐ ┌──────────┐ ┌─────────────┐
 │ 国产云 │ │ 国际云 │ │ 免费额度 │
 │ 盘古/百炼 │ │ OpenAI/ │ │ Kiro/Qoder/ │
 │ 混元/千帆 │ │ Claude/ │ │ Pollinations│
 │ DeepSeek │ │ Gemini │ │ Cloudflare │
 └──────────┘ └──────────┘ └─────────────┘

国内特性文件清单

核心合规

src/
├── lib/
│ ├── piiSanitizer.ts # [修改] 增加18位身份证、11位手机号、银联卡PII模式
│ ├── compliance/
│ │ └── dataExportControl.ts # [新增] 数据出境管控:域名白名单+出境日志
│ ├── db/
│ │ ├── encryption.ts # [修改] CN区强制加密策略
│ │ ├── core.ts # [修改] PG异步初始化路径、pg_dump备份
│ │ ├── pgSqlTranspiler.ts # [新增] SQLite→PG SQL自动转译(15+规则)
│ │ ├── pgMigrationRunner.ts # [新增] PG专用迁移执行器(information_schema)
│ │ ├── migrations_pg/
│ │ │ ├── 022_add_memory_fts5.sql # [新增] FTS5→tsvector/GIN PG覆盖
│ │ │ └── 023_fix_memory_fts_uuid.sql # [新增] rowid→SERIAL+PG触发器覆盖
│ │ └── adapters/
│ │ ├── types.ts # [修改] SqliteDriverKind扩展postgresql
│ │ ├── driverFactory.ts # [修改] resolveDbType(), SQLCipher/PG路径
│ │ ├── sqlcipherAdapter.ts # [新增] SQLCipher完整适配器
│ │ └── pgAdapter.ts # [新增] PostgreSQL完整适配器
│ ├── cnProviderModelSync.ts # [新增] 国产模型自动同步服务
│ └── integrations/
│ ├── coze/adapter.ts # [新增] Coze(扣子) Agent平台适配
│ └── dify/adapter.ts # [新增] Dify Agent平台适配
├── mitm/
│ ├── mitmAuditLogger.ts # [新增] HMAC链式MITM审计日志
│ ├── cnScopeLimitation.ts # [新增] CN区MITM作用域限制(80+域名绕过)
│ ├── manager.ts # [修改] CN作用域校验、审计日志集成
│ └── server.cjs # [修改] 区域感知DNS(AliDNS/Google)
├── domain/
│ └── policyEngine.ts # [修改] 注入cn-prefer-domestic等合规策略
├── shared/
│ ├── constants/
│ │ ├── providers/
│ │ │ ├── apikey/regional.ts # [修改] 华为/Coze/Dify前端展示字段
│ │ │ ├── search.ts # [修改] 百度/必应中国搜索Provider
│ │ │ ├── providers.ts # [修改] ENTERPRISE_CLOUD_PROVIDER_IDS
│ │ │ └── featureFlagDefinitions.ts # [修改] 区域感知"auto"默认值
│ │ └── utils/
│ │ ├── featureFlags.ts # [修改] isChinaRegion() + "auto"解析
│ │ └── inputSanitizer.ts # [修改] 中国PII模式
├── lib/a2a/skills/
│ ├── cozeDelegation.ts # [新增] Coze A2A技能
│ └── difyDelegation.ts # [新增] Dify A2A技能
└── instrumentation-node.ts # [修改] CN模型同步接入启动流程

Provider 注册

open-sse/config/providers/
├── registry/
│ ├── huawei/index.ts # [新增] 华为云ModelArts/盘古
│ ├── huawei-cn/index.ts # [新增] 华为云(中国区端点)
│ ├── coze-bot/index.ts # [新增] Coze(扣子)Bot
│ ├── dify-workflow/index.ts # [新增] Dify工作流
│ ├── deepseek/index.ts # [修改] 增加modelsUrl+passthroughModels
│ ├── doubao/index.ts # [修改] 增加modelsUrl+passthroughModels
│ ├── moonshot/index.ts # [修改] 增加modelsUrl+passthroughModels
│ ├── tencent/index.ts # [修改] 增加modelsUrl+passthroughModels
│ └── glm/index.ts # [修改] 增加modelsUrl+passthroughModels
├── index.ts # [修改] barrel导出
├── searchRegistry.ts # [修改] 百度/必应中国搜索
└── services/
 └── regionProviders.ts # [新增] 区域Provider配置

路由与策略

open-sse/services/
├── regionProviders.ts # [新增] 区域Provider配置与评分调整
├── autoCombo/scoring.ts # [修改] CN区评分权重上浮
└── combo/autoConfig.ts # [修改] CN区auto-combo默认配置

部署

deploy/
├── ack/airoute.yaml # [修改] DB_TYPE/PG连接/NetworkPolicy
├── cce/airoute.yaml # [修改] DB_TYPE/PG连接/NetworkPolicy
├── postgres/postgresql.yaml # [新增] PG StatefulSet独立部署
├── redis/redis.yaml # [新增] Redis StatefulSet
└── README.md # [修改] 数据库模式选择指南

配置

.env.example # [修改] DB_TYPE/DB_CONNECTION_STRING/SQLCIPHER_*环境变量

部署指南

环境变量速查

基础配置

安全配置(v3.8.46 安全加固后新增)

阿里云 ACK 部署

# 1. 创建命名空间
kubectl create namespace airoute
# 2. 创建加密密钥
kubectl create secret generic airoute-secrets \
 --namespace airoute \
 --from-literal=STORAGE_ENCRYPTION_KEY=$(openssl rand -hex 32)
# 3. 部署
kubectl apply -f deploy/ack/airoute.yaml
# 4. 验证
kubectl get pods -n airoute
kubectl port-forward svc/airoute 20128:20128 -n airoute

华为云 CCE 部署

kubectl apply -f deploy/cce/airoute.yaml

PostgreSQL 模式部署

# 先部署 PG
kubectl apply -f deploy/postgres/postgresql.yaml
# 再部署 AIRoute(DB_TYPE=postgresql)
# 详见 deploy/ack/airoute.yaml 中 DB_TYPE/DB_CONNECTION_STRING 配置

Docker 部署

前置要求

镜像说明

方式一:Docker Compose(推荐)

cp .env.example .env

AIRROUTE_REGION=cn
STORAGE_ENCRYPTION_KEY=<openssl rand -hex 32> # 加密密钥
JWT_SECRET=<32字符的随机字符串> # JWT 签名密钥
INITIAL_PASSWORD=<你的强密码> # 管理员密码,不可为 CHANGEME
REDIS_PASSWORD=<Redis密码> # Redis 认证密码

# 最小化启动(推荐大多数用户)
docker compose --profile base up -d
# 需要 Web-Cookie Provider 时
docker compose --profile web up -d
# 需要容器内 CLI 工具时
docker compose --profile cli up -d
# 容器内 CLI + CLIProxyAPI 侧车
docker compose --profile cli --profile cliproxyapi up -d
# 添加 Qdrant 语义记忆侧车(百万级向量场景)
docker compose --profile base --profile memory up -d
# 添加 Bifrost Go LLM 路由侧车
docker compose --profile base --profile bifrost up -d
# Host 模式:挂载宿主机已安装的 CLI 二进制
docker compose --profile host up -d

# 查看容器状态
docker compose ps
# 查看日志
docker compose logs -f AIRoute
# 健康检查
curl http://localhost:20128/api/monitoring/health

方式二:docker run

docker run -d --name airoute --restart unless-stopped \
 -p 20128:20128 \
 -e AIRROUTE_REGION=cn \
 -e STORAGE_ENCRYPTION_KEY=$(openssl rand -hex 32) \
 -e JWT_SECRET=$(openssl rand -hex 32) \
 -e INITIAL_PASSWORD=YourStrongPassword123! \
 -v airoute-data:/app/data \
 airoute:base

# 1. 启动 Redis
docker run -d --name airoute-redis --restart unless-stopped \
 redis:7-alpine \
 redis-server --save 60 1 --loglevel warning --requirepass your_redis_password
# 2. 启动 AIRoute
docker run -d --name airoute --restart unless-stopped \
 --link airoute-redis:redis \
 -p 20128:20128 \
 -e AIRROUTE_REGION=cn \
 -e STORAGE_ENCRYPTION_KEY=$(openssl rand -hex 32) \
 -e JWT_SECRET=$(openssl rand -hex 32) \
 -e INITIAL_PASSWORD=YourStrongPassword123! \
 -e REDIS_URL=redis://:your_redis_password@redis:6379 \
 -v airoute-data:/app/data \
 airoute:base

方式三:生产环境 Compose

# 启动(端口 20130/20131,与开发环境隔离)
docker compose -f docker-compose.prod.yml up -d --build
# 查看日志
docker compose -f docker-compose.prod.yml logs -f
# 停止
docker compose -f docker-compose.prod.yml down

构建自定义镜像

# 默认构建(runner-base)
docker build -t airoute:base .
# 指定 target
docker build --target runner-web -t airoute:web .
docker build --target runner-cli -t airoute:cli .
# 调整构建内存(默认 4GB,大型项目可能需要更多)
docker build --build-arg AIRoute_BUILD_MEMORY_MB=6144 -t airoute:base .
# 多平台构建(ARM64 / AMD64)
docker buildx build --platform linux/amd64,linux/arm64 -t airoute:base .

数据卷管理

# 备份数据
docker run --rm -v airoute-data:/app/data -v $(pwd):/backup alpine \
 tar czf /backup/airoute-backup-$(date +%Y%m%d).tar.gz -C /app data
# 恢复数据
docker run --rm -v airoute-data:/app/data -v $(pwd):/backup alpine \
 tar xzf /backup/airoute-backup-20260803.tar.gz -C /app

运行时内存调优

# 低内存 VPS(1-2 GB RAM)
docker compose --profile base up -d -e AIRoute_MEMORY_MB=512
# 高并发生产环境
docker compose --profile base up -d -e AIRoute_MEMORY_MB=2048

Docker Compose Profile 速查

常见问题

# 查看健康检查日志
docker inspect --format='{{json .State.Health}}' airoute | python3 -m json.tool
# 手动测试
docker exec airoute node healthcheck.mjs

# Docker 环境
sudo chown -R 1000:1000 ./data
chmod -R u+rwX ./data
# Podman 环境
podman unshare chown -R $(id -u):$(id -g) ./data

# 增大构建内存
docker build --build-arg AIRoute_BUILD_MEMORY_MB=6144 -t airoute:base .

docker compose --profile web up -d

cp .env.example .env
# 按 .env 中的注释说明逐项配置

本地源码运行

# 1. 确保 Node.js 版本正确
node -v # 应输出 v22.x 或 v24.x 或 v25.x
# 2. 复制环境变量并修改
cp .env.example .env
# 编辑 .env,必填项:
# AIRROUTE_REGION=cn
# STORAGE_ENCRYPTION_KEY=<openssl rand -hex 32>
# JWT_SECRET=<>=32字符的随机字符串>
# INITIAL_PASSWORD=<强密码,不可为 CHANGEME>
# 3. 安装依赖
npm install
# 4. 如果切换过 Node 版本,需重编译原生模块
npm rebuild better-sqlite3
# 5. 启动开发服务器
PORT=20128 npm run dev

公网暴露(FreeDomain + Cloudflare Named Tunnel)

# 1. 注册 FreeDomain 免费域名,将 NS 指向 Cloudflare
# (在 FreeDomain 面板把 NS 改为 Cloudflare 给的两个 NS 地址)
# 2. 安装 cloudflared CLI 并登录
cloudflared tunnel login # 浏览器授权,选你的域名
# 3. 创建 Named Tunnel 并配 DNS 路由
cloudflared tunnel create airoute-tunnel
cloudflared tunnel route dns airoute-tunnel airoute.你的域名.js.cool
# 4. 编写配置文件 ~/.cloudflared/config.yml
# tunnel: <Tunnel-ID>
# credentials-file: ~/.cloudflared/<Tunnel-ID>.json
# ingress:
# - hostname: airoute.你的域名.js.cool
# service: http://127.0.0.1:20128
# - service: http_status:404
# 5. 启动 Tunnel(AIRoute 须已在 127.0.0.1:20128 运行)
cloudflared tunnel run airoute-tunnel
# 可选:设为系统服务自启动
cloudflared service install # Windows/Linux/macOS 均可

# .env 中添加
NEXT_PUBLIC_BASE_URL=https://airoute.你的域名.js.cool
REQUIRE_API_KEY=true # 公网暴露后必须开启认证

开发路线图

已完成 (v3.8.46-cn)

进行中

规划中 (v3.9.x-cn)

快速开始

1. 安装与启动

npm install -g airoute
AIRROUTE_REGION=cn STORAGE_ENCRYPTION_KEY=$(openssl rand -hex 32) airoute

2. 连接 Provider

3. 配置 IDE/CLI

Base URL: http://localhost:20128/v1
API Key: [从仪表盘 Endpoints 页复制]
Model: auto # 零配置智能路由

4. 验证

curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"

核心能力概览(继承自 OmniRoute)

安全加固(v3.8.46 审计修复)

技术栈

数据库模式选择

License

AIRoute v1.0 cn · Node >=22.0.0

基于 OmniRoute 开源项目