Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

19 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

winuxGate

企业级 AI 网关骨架。

目标

  • 多租户
  • RBAC / ABAC
  • 用量控制
  • 敏感信息过滤
  • 文档相似度保护
  • 审计与统计

结构

  • crates/core:请求 IR、策略抽象、配额抽象、DLP 抽象
  • crates/identity:租户、主体、API Key
  • crates/policy:权限决策
  • crates/safety:敏感信息与相似度检测
  • crates/store:存储与审计
  • crates/adapters:上游协议适配
  • crates/gateway:网关编排
  • crates/admin:管理 API
  • crates/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 /healthz
  • GET /readyz
  • POST /v1/chat/completions
  • GET /admin/v1/stats
  • GET /admin/v1/audits
  • GET /admin/v1/usage
  • GET /admin/v1/settings
  • PUT /admin/v1/settings
  • GET /admin/v1/safety/rules
  • PUT /admin/v1/safety/rules
  • GET /admin/v1/tenants
  • POST /admin/v1/tenants
  • GET /admin/v1/subjects
  • POST /admin/v1/subjects
  • GET /admin/v1/api-keys
  • POST /admin/v1/api-keys
  • DELETE /admin/v1/api-keys/{key_id}
  • GET /admin/v1/providers
  • GET /admin/v1/dlp/documents
  • POST /admin/v1/dlp/documents
  • DELETE /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"
}

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages