安全加固

内置的安全机制

机制说明
上游 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 中披露细节。

相关文档