# 私有化部署

来源: https://docs.aicentos.com/enterprise/deployment

Language: zh-CN

> 把接入网关部署到你自己的环境：调用明细与审计记录全部留在你的边界内

如果合规要求数据不能离开自有环境，或需要长期留存调用明细与审计记录，我们可以把模型接入网关**部署到你自己的服务器或私有云**。业务数据、调用明细、审计记录全部落在你的边界内。私有化是可选项，交付费用单独计算；模型调用部分仍按量计费，见[合同与对公结算](https://docs.aicentos.com/enterprise/billing-contract)。

## 这个形态解决什么

| 诉求          | 私有化部署                                         |
| ----------- | --------------------------------------------- |
| 明细与审计数据不出边界 | 调用明细与审计记录写入**你自己的数据库**，平台侧不接收                 |
| 长期留存与自定义周期  | 保留策略由你设定，支持独立日志库（含 ClickHouse），可配置为不自动清理      |
| 内部审计可检索     | 审计覆盖登录、安全、操作、令牌四类事件，可按用户 / 密钥 / 时间 / 请求 ID 检索 |
| 接入内部系统      | 日志库对你开放，可自行接入 BI、SIEM 或备份流程                   |
| 源码可审计       | 网关基于开源实现（AGPL-3.0），代码公开可查，不存在无法验证的黑盒          |

## 部署形态

| 项    | 说明                                                |
| ---- | ------------------------------------------------- |
| 位置   | 你的内网或私有云                                          |
| 组件   | 网关服务 + 数据库（PostgreSQL / MySQL）+ 缓存（Redis）；日志可独立建库 |
| 交付物  | 容器镜像与编排文件、配置模板、部署说明                               |
| 上游接入 | 渠道与上游连接方式在交付方案中确认                                 |
| 运维   | 部署与日常运维由你或我们按方案分担                                 |

## 部署后可自行配置的能力

私有化不只是“数据留在本地”，也意味着**配置权交到你手里**。以下都是网关本身具备、在公有云形态下由平台统一设定的能力，私有化后由你的管理员自行决定：

| 配置项   | 可自行设定的内容                             |
| ----- | ------------------------------------ |
| 上游渠道  | 接入你自有的上游渠道与密钥，配置渠道分组与可用模型范围          |
| 路由与重试 | 渠道路由策略、失败重试规则、渠道健康检查与自动停用 / 恢复阈值     |
| 认证方式  | 密码登录、OIDC 单点登录、Passkey，以及二次验证的强制策略   |
| 成员与准入 | 自行创建成员账号、分配角色与细粒度权限；用单点登录返回的属性设定准入条件 |
| 请求防护  | 用户级与密钥级的速率限制阈值、请求来源校验规则              |
| 计费与定价 | 模型定价、分组倍率与额度规则，用于内部的成本分摊             |

**这些都是可配置项，交付时不代表已替你配好**，具体开到什么程度、由谁运维，在交付方案中约定。

## 数据边界

```
你的程序  →  你部署的网关  →  上游模型厂商
              ↑
        明细与审计在这里写入你的数据库
```

* 调用明细与审计记录**只写入你的数据库**，平台侧不接收、不存储这部分数据
* 我们不接入你的数据库，也无法远程读取其中的内容
* 请求内容会转发到上游，其数据留存政策按厂商官方条款执行

## 与公有云形态的对照

|         | 公有云（aicentos.com） | 私有化部署            |
| ------- | ----------------- | ---------------- |
| 网关位置    | 平台侧               | 你的环境             |
| 明细与审计记录 | 平台侧数据库，留存可合同约定    | 你的数据库，策略自行设定     |
| 明细导出    | 控制台查询，正式对账单走人工    | 直连你自己的数据库，导出方式自定 |
| 成员账号管理  | 主账号 + 成员密钥 + 分组   | 完整成员账号体系，自行创建与管理 |
| 单点登录    | 未开放               | 对接你自有的身份提供方      |
| 运维责任    | 我们负责              | 按交付方案分担          |
| 模型与上游更新 | 平台维护，你无需改动        | 按交付方案约定          |

## 许可与源码

网关基于 **AGPL-3.0** 开源实现交付。这一点对你有利：**部署在你环境里的代码是可审计的**，任何一方都无法在其中隐藏未声明的数据外发行为。分发与源码提供按该许可证要求执行，具体形式在交付方案中说明。

## 下一步

* 私有化按项目评估，需要先明确规模、合规要求与网络条件，见[合作与开通流程](https://docs.aicentos.com/enterprise/onboarding)
* 交付不改变合同与结算方式，见[合同与对公结算](https://docs.aicentos.com/enterprise/billing-contract)
* 安全口径见[数据安全与合规](https://docs.aicentos.com/enterprise/security-compliance)