Data and Security

数据与安全

Web 面板与模型网关是两个独立服务，访问控制也不同。

网络边界

服务	默认行为
Web 控制面板	所有网卡、8000–9000 随机端口，API 需要本次启动生成的访问 Token
模型网关	所有网卡、8000–9000 自动端口，默认发布包不校验入站 Key

教程统一使用默认启动方式。面板的 Token 不会替模型网关提供鉴权，二者的访问控制独立。需要额外鉴权时使用 client-auth 构建；远程访问步骤见 安装。

浏览器跨域

网关默认允许所有浏览器来源，包括本地页面与浏览器沙箱来源；不支持跨源 Cookie 凭据。CORS 不是鉴权，默认模式允许网页调用可访问的网关并消耗供应商额度。

可设置精确来源白名单或禁用跨源请求：

codex-mixin config cors set --origin https://your-web-app.example
codex-mixin config cors set --disable
codex-mixin service restart

两条 cors set 是不同选项，按需要选一条。完整规则见 CORS 文档。

本地数据

默认在 ~/.codex-mixin/ 保存配置与状态，实际路径可由 codex-mixin interface --json 查询。

数据	注意事项
config.json / config.json.key	加密工作配置与解密密钥，两者都需保护
OAuth 凭据	本地保存并用于续期，不公开分享
usage.sqlite3	最近 5000 条上游回复的用量和性能元数据
gateway.log	运行日志，分享前检查凭据、账号与内部地址
导出 .b64 备份	含供应商凭据，只有 Base64 编码

Mixin 接入客户端时保留可恢复的托管状态；不为接入自动修改 Codex 的历史会话数据库。

提交问题前

保留版本、系统、操作步骤与相关错误。不要上传 API Key、Cookie、OAuth Token、config.json.key、配置备份或带面板访问 Token 的链接。供应商探测、测速与完整诊断可能访问上游，能力探测与测速可能产生费用。