跳到主要内容
隐界

环境变量完整参考

api/.env 按四组理解:LLM 网关三件套、三把服务端密钥、网络与路径、可选的媒体与邮件。一处历史命名要知道:DEEPSEEK_API_KEY 其实是通用网关 key,任意 OpenAI 兼容网关都填它。

权威清单永远是仓库里带注释的 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、前端、数据库、向量索引全部跑在你自己的机器上。

相关内容

返回自部署文档
分享XTelegramLINE微博
环境变量完整参考 · 隐界 Enclave