跳到主要内容
隐界

Docker Compose 一键部署

克隆仓库 → 复制并填写 .env → docker compose up -d,三步把主 App 和 Core API 一起跑起来;自带健康检查,数据落在宿主机 ./data 目录。这是推荐的自部署路径。

  1. 1.准备依赖与 API Key

    机器上装好 Docker 24+ 与 Docker Compose v2。再准备一把 LLM 网关的 API Key——任意 OpenAI 兼容网关都行(DeepSeek、OpenRouter、Groq、OpenAI,或本地 Ollama),选型建议见「BYOK 与模型供应商」一文。

  2. 2.克隆仓库并配置 .env

    git clone 仓库后执行 cp api/.env.example api/.env,打开 api/.env 至少填上:LLM 网关三件套(DEEPSEEK_API_KEY / OPENAI_BASE_URL / AI_MODEL)、ADMIN_SECRET、JWT_SECRET、USER_API_KEY_ENCRYPTION_SECRET(三段互不相同的长随机串,可用 openssl rand -hex 32 生成)、CORS_ALLOWED_ORIGINS 与 PUBLIC_API_BASE_URL(你的访问地址,不带 /api)。完整变量说明见「环境变量参考」一文。

  3. 3.启动

    在仓库根目录执行 docker compose up -d。默认会启动两个容器:web(静态前端,暴露 APP_PORT,默认 80)与 api(Core API,暴露 PORT,默认 3000),均带健康检查;web 容器内的 nginx 已把 /api、/socket.io、/health 转发给 api,对外就是单一入口。只想起后端可以 docker compose up -d api。SQLite 数据落在宿主机 ./data/database.sqlite。

  4. 4.验证

    curl http://localhost/healthz 与 curl http://localhost/health 都应返回 200。然后浏览器打开主 App 地址注册第一个账号——第一个登录的用户即成为世界主人。

相关问题

  • 隐界可以自部署吗?难不难?
    可以,且难度等同跑一个普通 web 服务。如果你用过 docker compose,三步即可拥有自己的实例:克隆仓库、复制 .env、docker compose up。API、前端、数据库、向量索引全部跑在你自己的机器上。
  • 自部署隐界需要什么配置?需要 GPU 吗?
    不一定需要 GPU。如果你用云端模型 API(OpenAI、Anthropic 等),一台能跑 Docker 的普通服务器或家用主机就够了——推理在云端完成,本机只跑应用与数据库。只有当你想用本地模型(Ollama / vLLM)离线推理时,才需要相应的显存与算力。
  • 隐界可以完全离线运行吗?
    可以。把模型层换成本地 Ollama / vLLM,并关闭真实世界同步后,整个系统就不再向外发任何请求,完全在你自己的机器上离线运行——这是最强的隐私保证,因为它不依赖任何承诺。

相关内容

返回自部署文档
分享XTelegramLINE微博
Docker Compose 一键部署 · 隐界 Enclave