EduOpenAI Core 文档/环境变量配置
环境变量配置
.env 变量一览
所有密钥通过 .env 注入（不入库，本地管理）。改 .env 后必须 pm2 restart eduopenai --update-env。
模型配置
| 变量 | 说明 |
|---|---|
| QWEN_API_KEY | 阿里云百炼 API Key |
| QWEN_BASE_URL | https://dashscope.aliyuncs.com/compatible-mode/v1 |
| QWEN_MODELS | 可切换模型清单 |
| DEFAULT_MODEL | 默认模型，如 qwen:qwen3.7-max |
| TTS_QWEN_API_KEY / TTS_QWEN_BASE_URL | 语音合成配置 |
OSS 存储
| 变量 | 说明 |
|---|---|
| OSS_ACCESS_KEY_ID / OSS_ACCESS_KEY_SECRET | 阿里云 AccessKey（仅服务端使用） |
| OSS_BUCKET | OSS 存储桶（当前 ossvipeoe，华东1/上海，私有） |
| OSS_ENDPOINT | 如 oss-cn-shanghai.aliyuncs.com |
| OSS_PUBLIC_BASE_URL | 可选：自定义 CDN 域名 |
访问与嵌入
| 变量 | 说明 |
|---|---|
| ACCESS_CODE | 站点级访问码（空=关闭，iframe 嵌入必需） |
| ADMIN_ACCESS_CODE | 管理后台独立口令（/admin 鉴权） |
| ALLOWED_FRAME_ANCESTORS | iframe 白名单（构建时生效，如 https://learn.eduopenai.com） |
智训宝对接
| 变量 | 说明 |
|---|---|
| CORE_BASE_URL | 本平台对外地址（决定发布 liveUrl/课时播放地址） |
| EDUSOHO_API_BASE | 智训宝 API 地址（https://learn.eduopenai.com/api） |
| EDUSOHO_AUTH_TOKEN | 智训宝联调 token（由智云提供） |
警告
安全红线：AccessKey 等敏感信息禁止出现在前端代码/客户端 bundle，禁止硬编码到代码，统一环境变量注入。