安全加固
内置的安全机制
| 机制 | 说明 |
|---|---|
| 上游 Key 加密存储 | 每个租户一把随机租户密钥,以 XChaCha20-Poly1305 加密上游 Key 与 Vertex 私钥;租户密钥再由账号自己的 API Key 加密 |
| 凭证隔离 | 应用只持有 XSI Key;转发前剥离调用方的全部凭证与客户端 IP 头,上游 Key 不会返回给普通账号 |
| 认证防护 | 按 IP 统计认证失败并临时封禁,无效 Key 负缓存 |
| 准入流水线 | IP、状态、额度、限速、资源与模型白名单逐层校验 |
| 租户隔离 | Key、配置与价格按租户隔离;账号管理只作用于自己的子树 |
| 注册防刷 | IP 与邮箱频率限制、渐进延迟、自动封禁与全站日配额 |
| 内存保护 | 进程启动时禁用内存转储 |
部署清单
密钥
- root Key 与数据库密码使用随机生成的值,
docker-compose.yml权限为600。 - root Key 只用于管理,不用于模型调用,不分发给应用。
- 应用使用独立的子账号 Key,按环境与用途拆分。
- 怀疑泄露时通过
POST /x-self轮换,旧 Key 立即失效。
网络
- 端口保持绑定
127.0.0.1,只允许反向代理访问 API 与控制台端口。 - PostgreSQL 与 Redis 不发布到主机端口(模板默认如此)。
- 全部入口启用 HTTPS。
-
TRUSTED_PROXY_CIDRS只包含你自己的代理地址,避免客户端伪造 IP。 - 在代理层屏蔽不需要对外暴露的工具路径:
/x-gkey、/x-ekey/、/x-dkey/。它们无需认证,只用于生成与编解码 Key,对外部用户没有用途。
location ~ ^/x-(gkey|ekey|dkey) { return 404; }- 如果不对公众开放,可按来源 IP 限制配置管理控制台的访问。
邮件
- 在
docker-compose.yml中为邮件服务配置自己的 SMTP。 - 保持模板中 API 容器的
EMAIL_SMTP、EMAIL_AUTH、EMAIL_PASS为空字符串,或显式设置为你自己的值,不要依赖代码中的默认值。 - 把
XAI_MAIL设为你自己的运营邮箱,接收未知模型、故障切换等通知。 - 注意欢迎邮件与 Key 轮换邮件中包含明文 API Key,请确保邮件链路使用 TLS。
上游 Key
- 查询 Key 时使用
fields=summary;full模式与GET /x-conf的休眠/禁用列表会返回明文。 - 为被上游吊销的 Key 配置
AUTO_DISABLE_KEY_STATUS=401,让其自动退出轮询。 - 定期轮换上游 Key,并在上游控制台设置用量上限作为最后一道防线。
访问控制
- 需要额度与限速生效的账号使用 Role 2 或 3(Role 0/1 不检查额度与限速)。
- 生产账号设置
AllowIPs;对外分发的账号设置AllowModels与Resources。 - 保持
USER_FILTER=true。 - 不开放注册的部署设置
SIGN_ENABLE=false;开放注册时配置SIGNUP_ALLOW_DOMAINS或SIGNUP_DENY_DOMAINS。
日志与错误
- 生产环境保持
LOG_ENABLE=false,排障时短时开启。 - 面向终端用户的服务可设置
MASK_ERRORS=true,隐藏上游错误细节。 - 在代理与应用日志中脱敏
Authorization、x-api-key请求头。
数据
- PostgreSQL 与 Redis 的备份复制到异机,并定期演练恢复。
- 限制宿主机上
backups/目录的访问权限。
漏洞报告
发现安全问题时,请发送邮件至 [email protected],不要在公开 Issue 中披露细节。