AIRoute

面向国内合规增强的 AI 网关

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

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

一个入口聚合所有大模型，智能路由择优调度，数据不出境。

你遇到的问题，AIRoute 来解：

痛点	AIRoute 怎么解
OpenAI/Claude 在国内连不上，换一个 Provider 就得改一版代码	统一入口 — 所有 Provider 接入一个 API，下游零改动切换
DeepSeek 便宜但偶尔宕机，Claude 稳但贵，不知道该用谁	智能路由 — 17 种策略自动选：优先国产、成本最优、故障自动切换
想白嫖免费模型，但每个平台要单独注册、单独调接口	90+ 免费额度 — 内置免费 Provider，开箱即用，不花一分钱
用了海外模型，数据出境合规风险大	合规底座 — PII 自动脱敏、数据出境管控、强制加密，一个开关 `AIRROUTE_REGION=cn` 全搞定
多人/多团队共用，成本和权限管不住	企业级存储 — SQLCipher/PostgreSQL 双轨，审计日志、熔断限流、多租户就绪

适合谁用？

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

项目定位

AIRoute 是 OmniRoute 的国内合规 fork。OmniRoute 是一个开源的 AI Gateway，聚合 237+ LLM Provider、95 种 MCP 工具、17 种路由策略和 10 级 Token 压缩管线。AIRoute 在此基础上：

合规先行 — 满足《个人信息保护法》(PIPL)、《数据安全法》(DSL) 对 PII 脱敏、数据出境管控、强制加密的要求
本地优先 — 默认优先国内 Provider，降低跨境延迟 100-300ms
信创适配 — 华为云盘古、阿里云百炼、腾讯混元、百度千帆等国产大模型一等公民
企业级存储 — SQLCipher / PostgreSQL 双轨可选，满足等保与审计要求

核心开关：AIRROUTE_REGION=cn。设置后自动激活全部中国区特性。

国内增强特性

P0 — 合规底座（必选）

特性	说明	关键文件
华为云盘古 Provider	ModelArts / 盘古大模型接入，满足信创要求	`open-sse/config/providers/registry/huawei/index.ts`
国产 PII 脱敏	中国身份证号(18位)、手机号(11位)、银联卡号自动识别与脱敏	`src/lib/piiSanitizer.ts`, `src/shared/utils/inputSanitizer.ts`
强制加密	`AIRROUTE_REGION=cn` 时未配置 `STORAGE_ENCRYPTION_KEY` 拒绝启动	`src/lib/db/encryption.ts`
区域感知默认值	区域敏感配置项支持 `"auto"` 默认值，按 `AIRROUTE_REGION` 自动解析	`src/shared/constants/featureFlagDefinitions.ts`, `src/shared/utils/featureFlags.ts`

P1 — 功能增强

特性	说明	关键文件
百度/必应中国搜索	`baidu-search` 与 `bing-cn-search` 搜索 Provider	`open-sse/config/searchRegistry.ts`, `src/shared/constants/providers/search.ts`
数据出境管控	域名白名单 + 出境日志记录，符合《数据安全法》要求	`src/lib/compliance/dataExportControl.ts`
区域感知路由	国内 Provider 评分权重自动上浮，跨境 Provider 延迟惩罚	`open-sse/services/regionProviders.ts`, `open-sse/services/autoCombo/scoring.ts`
策略引擎合规	自动注入 `cn-prefer-domestic` / `cn-block-overseas-free-tier` 等策略	`src/domain/policyEngine.ts`
Coze/Dify 适配层	Agent 平台集成：RAG、工具调用、多轮工作流委托	`src/lib/integrations/coze/adapter.ts`, `src/lib/integrations/dify/adapter.ts`
ACK/CCE 部署模板	阿里云 ACK / 华为云 CCE 一键部署 YAML，含 HPA/PDB/NetworkPolicy	`deploy/ack/airoute.yaml`, `deploy/cce/airoute.yaml`

P2 — 企业级

特性	说明	关键文件
SQLCipher / PostgreSQL	企业级存储层三选一：SQLite(默认) / SQLCipher(中国区) / PostgreSQL(大规模)	`src/lib/db/adapters/sqlcipherAdapter.ts`, `src/lib/db/adapters/pgAdapter.ts`
PG SQL 转译器	15+ 自动转换规则：AUTOINCREMENT→SERIAL、datetime→CURRENT_TIMESTAMP 等	`src/lib/db/pgSqlTranspiler.ts`
PG 迁移覆盖	FTS5→tsvector/GIN、rowid→SERIAL+触发器等手工覆盖	`src/lib/db/migrations_pg/022_add_memory_fts5.sql`, `023_fix_memory_fts_uuid.sql`
MITM 审计日志	HMAC 链式校验和，防篡改审计所有 MITM 操作	`src/mitm/mitmAuditLogger.ts`
MITM 作用域限制	国内 80+ 金融/政务域名自动绕过；限制 tproxy-decrypt 等高危功能	`src/mitm/cnScopeLimitation.ts`
MITM DNS 区域感知	国内用 AliDNS (223.5.5.5)，海外用 Google DNS (8.8.8.8)	`src/mitm/server.cjs`
国产模型自动同步	6 大国产 Provider 模型列表后台轮询同步（6h 间隔，退避重试）	`src/lib/cnProviderModelSync.ts`
Provider modelsUrl	DeepSeek、豆包、Moonshot、腾讯混元、GLM 增加 modelsUrl 配置	`open-sse/config/providers/registry/{deepseek,doubao,moonshot,tencent,glm}/index.ts`

架构概览

┌──────────────────────────────────────────────────────────┐
│     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  │
        └──────────┘ └──────────┘ └─────────────┘

国内特性文件清单

以下仅列出 AIRoute 新增/修改的文件（不含 OmniRoute 原有文件）。

核心合规

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_*环境变量

部署指南

环境变量速查

变量	默认值	说明
`AIRROUTE_REGION`	—	设为 `cn` 激活全部中国区特性
`STORAGE_ENCRYPTION_KEY`	—	CN区强制要求，AES-256-GCM 密钥
`DB_TYPE`	`sqlite`	可选 `sqlite` / `sqlcipher` / `postgresql`
`DB_CONNECTION_STRING`	—	PostgreSQL 连接串（DB_TYPE=postgresql时必填）
`SQLCIPHER_KEY`	—	SQLCipher 密钥（DB_TYPE=sqlcipher时必填）
`PORT`	`20128`	API + 仪表盘端口
`DATA_DIR`	`~/.airoute/`	数据目录

阿里云 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

详见 deploy/README.md。

华为云 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 run -d --name airoute --restart unless-stopped \
  -p 20128:20128 \
  -e AIRROUTE_REGION=cn \
  -e STORAGE_ENCRYPTION_KEY=$(openssl rand -hex 32) \
  -v airoute-data:/app/data \
  airoute:latest

本地源码运行

cp .env.example .env
# 编辑 .env，设置 AIRROUTE_REGION=cn 和 STORAGE_ENCRYPTION_KEY
npm install
PORT=20128 npm run dev

仪表盘：http://localhost:20128 API端点：http://localhost:20128/v1

开发路线图

已完成 (v3.8.46-cn)

进行中

PG 覆盖迁移补全 — 为 025/075/096/103 号迁移文件编写 PostgreSQL 手工覆盖（涉及 JSON1 函数重写）
Node 22+ 升级指南 — 项目要求 >=22.0.0，当前本地环境为 Node 20，需 nvm 切换
GitHub 远程仓库 — 初始化远程仓库并推送

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

快速开始

1. 安装与启动

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

2. 连接 Provider

仪表盘 → Providers → 连接 DeepSeek / 阿里云百炼 / Kiro AI(免费)

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）

能力	详情
Provider	237+ LLM Provider，90+ 免费额度，11 个永久免费
路由策略	17 种：priority / weighted / cost-optimized / context-relay / fusion 等
压缩	10 级管线：Session-Dedup → CCR → RTK → Headroom → Relevance → Caveman → LLMLingua-2 → Lite → Aggressive → Ultra
压缩节省	最高 95%（RTK+Caveman 堆叠），平均 89%（工具密集会话）
MCP	95 工具 / 3 传输 / 30 作用域
A2A	JSON-RPC 2.0 + SSE，6 技能（含 Coze/Dify 委托）
韧性	三层独立：Provider 熔断器 → Key 冷却 → Model 锁定
协议	OpenAI / Claude / Gemini / Responses API 自动互译
安全	PII 脱敏 / 注入防护 / 视觉审查 / MITM 审计
内存	FTS5 全文搜索 + 向量检索（Qdrant/sqlite-vec）

技术栈

层	技术
运行时	Node.js 22.x / 24.x LTS（`>=22.0.0 <23 \|\| >=24.0.0 <27`）
语言	TypeScript 6.0，100% 类型覆盖（核心模块零 `any`）
框架	Next.js 16 + React 19 + Tailwind CSS 4
数据库	SQLite (better-sqlite3) / SQLCipher / PostgreSQL
校验	Zod（MCP 工具 I/O、API 契约）
协议	MCP (stdio/HTTP/SSE) + A2A v0.3 (JSON-RPC 2.0)
流式	Server-Sent Events + WebSocket
认证	OAuth 2.0 PKCE + JWT + API Keys + MCP Scoped Auth
测试	Node.js test runner + Vitest（21,000+ 测试用例）
平台	Desktop(Electron) / Android(Termux) / PWA
部署	Docker / ACK / CCE / Fly.io / 本地

数据库模式选择

模式	适用场景	环境变量	说明
SQLite	个人/小团队	`DB_TYPE=sqlite`(默认)	零配置，单文件
SQLCipher	中国区合规/等保	`DB_TYPE=sqlcipher`	透明加密，CN区自动默认
PostgreSQL	大规模/企业级	`DB_TYPE=postgresql`	含自动SQL转译、PG覆盖迁移

License

— 详见 LICENSE

AIRoute v3.8.46-cn · Node >=22.0.0 · MIT License

基于 OmniRoute 开源项目

Name		Name	Last commit message	Last commit date
Latest commit History 12 Commits
.github/workflows		.github/workflows
@airoute		@airoute
bin		bin
config		config
contrib/podman		contrib/podman
deploy		deploy
docs		docs
electron		electron
examples		examples
images		images
open-sse		open-sse
public		public
scripts		scripts
skills		skills
src		src
.dockerignore		.dockerignore
.editorconfig		.editorconfig
.env.example		.env.example
.gitignore		.gitignore
.gitleaks.toml		.gitleaks.toml
.markdownlint.json		.markdownlint.json
.node-version		.node-version
.npmignore		.npmignore
.npmrc		.npmrc
.nvmrc		.nvmrc
.prettierignore		.prettierignore
.size-limit.json		.size-limit.json
.trivyignore		.trivyignore
.vale.ini		.vale.ini
.zizmor.yml		.zizmor.yml
AGENTS.md		AGENTS.md
CHANGELOG.md		CHANGELOG.md
CLAUDE.md		CLAUDE.md
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.md		CONTRIBUTING.md
Dockerfile		Dockerfile
GEMINI.md		GEMINI.md
LICENSE		LICENSE
README.md		README.md
SECURITY.md		SECURITY.md
design.md		design.md
docker-compose.prod.yml		docker-compose.prod.yml
docker-compose.yml		docker-compose.yml
eslint.complexity.config.mjs		eslint.complexity.config.mjs
eslint.config.mjs		eslint.config.mjs
eslint.sonarjs.config.mjs		eslint.sonarjs.config.mjs
flake.lock		flake.lock
flake.nix		flake.nix
fly.toml		fly.toml
knip.json		knip.json
llm.txt		llm.txt
news.json		news.json
next.config.mjs		next.config.mjs
package-lock.json		package-lock.json
package.json		package.json
playwright.config.ts		playwright.config.ts
pnpm-workspace.yaml		pnpm-workspace.yaml
pnpm.json		pnpm.json
postcss.config.mjs		postcss.config.mjs
prettier.config.mjs		prettier.config.mjs
promptfooconfig.yaml		promptfooconfig.yaml
socket.yml		socket.yml
sonar-project.properties		sonar-project.properties
source.config.ts		source.config.ts
stryker.conf.json		stryker.conf.json
stryker.disablebail.json		stryker.disablebail.json
tsconfig.json		tsconfig.json
tsconfig.typecheck-core.json		tsconfig.typecheck-core.json
tsconfig.typecheck-noimplicit-core.json		tsconfig.typecheck-noimplicit-core.json
vitest.config.ts		vitest.config.ts
vitest.mcp.config.ts		vitest.mcp.config.ts

Folders and files

Latest commit

History

Repository files navigation

AIRoute

面向国内合规增强的 AI 网关

一个入口聚合所有大模型，智能路由择优调度，数据不出境。

目录

项目定位

国内增强特性

P0 — 合规底座（必选）

P1 — 功能增强

P2 — 企业级

架构概览

国内特性文件清单

核心合规

Provider 注册

路由与策略

部署

配置

部署指南

环境变量速查

阿里云 ACK 部署

华为云 CCE 部署

PostgreSQL 模式部署

本地 Docker

本地源码运行

开发路线图

已完成 (v3.8.46-cn)

进行中

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

快速开始

1. 安装与启动

2. 连接 Provider

3. 配置 IDE/CLI

4. 验证

核心能力概览（继承自 OmniRoute）

技术栈

数据库模式选择

License

About

Topics

Resources

License

Code of conduct

Contributing

Security policy

Uh oh!

Stars

Watchers

Forks

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages