权威清单永远是仓库里带注释的 api/.env.example;本文按用途分组讲「为什么要填、怎么填对」。一个通用规则:env 里写 KEY=(空字符串)等同于未配置,会触发默认值回退——想清空就直接注释掉整行。
LLM 网关三件套(必填)
DEEPSEEK_API_KEY(你的网关 key——名字是历史遗留,对任意 OpenAI 兼容网关通用)、OPENAI_BASE_URL(网关地址,到 /chat/completions 之前为止)、AI_MODEL(该网关认识的模型 id)。.env.example 里内置了 DeepSeek / OpenRouter / Groq / Together / OpenAI / Ollama 六组模板,取消注释你选的那组即可。要让 AI 能读图,需选视觉模型(如 gpt-4o-mini、qwen-vl-plus)。
三把服务端密钥(生产必改)
ADMIN_SECRET(/admin/* 运维接口的鉴权密钥)、JWT_SECRET(登录态签名)、USER_API_KEY_ENCRYPTION_SECRET(世界主人自带 Key 在服务端的加密密钥)。三段都用长随机串且互不相同:openssl rand -hex 32 跑三次。
网络与路径
PORT(后端端口,默认 3000)、DATABASE_PATH(SQLite 文件位置,相对路径从仓库根解析,Docker 模式固定为 /app/data/database.sqlite 并挂载到宿主机 ./data)、CORS_ALLOWED_ORIGINS(允许跨域的前端来源,逗号分隔,上公网后记得加你的域名)、PUBLIC_API_BASE_URL(对外公开的 Web 根地址,不带 /api)。根 compose 另支持 APP_PORT 控制前端映射端口(默认 80)。
可选:MiniMax 媒体生成
MINIMAX_API_KEY / MINIMAX_BASE_URL 供朋友圈与视频号里 NPC 自动生成视频 / 音乐使用。完全可选:不填只是这部分功能显示「媒体生成未启用」占位,聊天、朋友圈、群聊等其余功能不受影响。
可选:SMTP 邮件双通道
SMTP_* 用于邮箱验证码登录。留空 SMTP_HOST 时验证码会打印到服务端日志(开发 mock 模式),凭证就绪后填入即真实发送。另有一组可选的 SMTP_OVERSEAS_*:按收件人邮箱域名分流(gmail/outlook 等海外域名走海外通道),未配置则自动回落默认通道——典型组合是国内通道配国内邮件服务、海外通道配 Gmail/SES。
相关问题
隐界支持哪些大模型?
隐界的模型层完全可换:OpenAI、Anthropic、Google、DeepSeek,以及本地的 Ollama / vLLM 都能配置。不同角色甚至可以用不同模型,按场景与成本自由分配。隐界可以完全离线运行吗?
可以。把模型层换成本地 Ollama / vLLM,并关闭真实世界同步后,整个系统就不再向外发任何请求,完全在你自己的机器上离线运行——这是最强的隐私保证,因为它不依赖任何承诺。隐界可以自部署吗?难不难?
可以,且难度等同跑一个普通 web 服务。如果你用过 docker compose,三步即可拥有自己的实例:克隆仓库、复制 .env、docker compose up。API、前端、数据库、向量索引全部跑在你自己的机器上。