企业级 AI 网关骨架。
- 多租户
- RBAC / ABAC
- 用量控制
- 敏感信息过滤
- 文档相似度保护
- 审计与统计
crates/core:请求 IR、策略抽象、配额抽象、DLP 抽象crates/identity:租户、主体、API Keycrates/policy:权限决策crates/safety:敏感信息与相似度检测crates/store:存储与审计crates/adapters:上游协议适配crates/gateway:网关编排crates/admin:管理 APIcrates/server:启动入口
GatewayStore:审计和用量存储边界,当前默认InMemoryStore,可替换为 SQLite/Postgres 实现。ProviderRegistry:上游模型提供商注册表,当前默认 echo provider,后续可接 OpenAI、Azure、Bedrock 或内部模型服务。DlpScanner:数据泄露保护扫描边界,当前包含相似度指纹实现,可扩展到飞书文档同步、向量检索和策略分级。
cargo run -p winux-gateway-server默认审计和用量流水保存在内存中。设置 WINUX_GATE_SQLITE_PATH 后会使用 SQLite 持久化:
WINUX_GATE_SQLITE_PATH=./winux-gateway.db cargo run -p winux-gateway-server默认租户、Subject 和 API Key 也保存在内存中。设置 WINUX_GATE_IDENTITY_SQLITE_PATH 后会使用 SQLite 持久化身份数据:
WINUX_GATE_IDENTITY_SQLITE_PATH=./winux-identity.db cargo run -p winux-gateway-server默认 DLP 文档指纹保存在内存中。设置 WINUX_GATE_DLP_SQLITE_PATH 后会使用 SQLite 持久化受保护文档指纹:
WINUX_GATE_DLP_SQLITE_PATH=./winux-dlp.db cargo run -p winux-gateway-server配置 OpenAI-compatible 上游后,模型名可以使用 openai:gpt-4o 这类 provider:model 格式:
WINUX_GATE_OPENAI_BASE_URL=https://api.openai.com/v1 \
WINUX_GATE_OPENAI_API_KEY=sk-... \
WINUX_GATE_OPENAI_PROVIDER_ID=openai \
cargo run -p winux-gateway-server可用 WINUX_GATE_DEFAULT_PROVIDER 修改不带前缀模型的默认 provider。
GET /healthzGET /readyzPOST /v1/chat/completionsGET /admin/v1/statsGET /admin/v1/auditsGET /admin/v1/usageGET /admin/v1/settingsPUT /admin/v1/settingsGET /admin/v1/safety/rulesPUT /admin/v1/safety/rulesGET /admin/v1/tenantsPOST /admin/v1/tenantsGET /admin/v1/subjectsPOST /admin/v1/subjectsGET /admin/v1/api-keysPOST /admin/v1/api-keysDELETE /admin/v1/api-keys/{key_id}GET /admin/v1/providersGET /admin/v1/dlp/documentsPOST /admin/v1/dlp/documentsDELETE /admin/v1/dlp/documents/{document_id}POST /admin/v1/dlp/scan
默认演示 key: demo-key
Admin 接口需要 WINUX_GATE_ADMIN_TOKEN,请求时带 Authorization: Bearer <token> 或 x-admin-token。
数据面可用 Authorization: Bearer <api-key> 或 x-api-key。
数据面返回会包含 provider_id 和 output,方便对接真实上游。
/admin/v1/settings 可调整 max_tokens_per_subject、max_input_chars、max_requests_per_minute、upstream_timeout_ms、upstream_failure_threshold、upstream_cooldown_ms 和 redact_on_safety_match。
创建 API Key 时可配置访问策略,deny 优先,* 支持前缀匹配:
{
"tenant_id": "demo",
"subject_id": "demo-user",
"labels": {
"team": "platform"
},
"access": {
"allowed_models": ["openai:*"],
"denied_models": ["openai:gpt-secret"],
"allowed_providers": ["openai"],
"denied_providers": []
},
"usage": {
"max_requests_per_minute": 60,
"max_input_chars": 20000
}
}可通过 PUT /admin/v1/safety/rules 热更新敏感信息规则,action 支持 block 或 redact:
{
"rules": [
{
"name": "secret-like text",
"pattern": "(?i)(api[_-]?key|secret|token|password)",
"action": "redact"
},
{
"name": "restricted document",
"pattern": "(?i)(confidential|internal only|restricted)",
"action": "block"
}
]
}注册受保护文档时可带来源和版本,适合飞书文档同步任务写入:
{
"document_id": "feishu-budget-2026",
"title": "2026 Budget",
"source": "feishu",
"source_url": "https://example.feishu.cn/docx/xxx",
"version": "2026-07-26T10:00:00+08:00",
"labels": ["confidential"],
"content": "company budget forecast hiring plan revenue and margin"
}