跳到主要内容
隐界

裸机 / VPS 部署(不用 Docker)

Node.js 20+ 加 nginx 就能跑:后端 npm ci + build 后用 node 或 pm2 常驻,前端构建出静态产物交给 nginx。仓库自带 nginx 配置模板,替换两个占位符即可用。

倾向不引入 Docker、或想精细控制进程与 nginx 的用户走这条路。前后端是两件独立的事:后端是一个 Node 进程,前端是一堆静态文件。

  1. 1.装好工具链

    需要 Node.js 20+、pnpm 8.15.4(仓库 packageManager 锁定的版本,建议 corepack enable 自动获取)、nginx(或任意能托管静态文件 + 反代的 web server)。编译 better-sqlite3 需要 python3、make、g++——Linux 装 build-essential 即可,macOS 跑 xcode-select --install。

  2. 2.跑起后端(端口 3000)

    仓库根目录先 pnpm install --frozen-lockfile(workspace 包);再进入 api/ 执行 npm ci(api 走 npm + package-lock.json,不在 pnpm workspace 内)、npm run build,然后 node dist/main 启动(生产建议 pm2 start dist/main)。api/.env 必须就位;SQLite 会自动建在 DATABASE_PATH 指向的位置。curl http://127.0.0.1:3000/health 应返回 200。

  3. 3.构建并托管前端(端口 5180)

    执行 pnpm --filter @yinjie/app build,产物在 apps/app/dist/。仓库自带 nginx 模板 apps/app/nginx/default.conf.template:把其中 APP_API_UPSTREAM 占位符替换成 http://127.0.0.1:3000、监听端口与静态根目录改成你的实际值,nginx -t 通过后 reload 即可。模板已包含 /api、/socket.io 的反代与 SPA 兜底。

  4. 4.验证运维接口

    带上 X-Admin-Secret 头访问 /api/admin/stats 应返回 200 + JSON;返回 401 说明密钥不对,或反代吞掉了 X-Admin-Secret 头(处理方式见「反向代理与 HTTPS」一文)。

相关问题

  • 隐界可以自部署吗?难不难?
    可以,且难度等同跑一个普通 web 服务。如果你用过 docker compose,三步即可拥有自己的实例:克隆仓库、复制 .env、docker compose up。API、前端、数据库、向量索引全部跑在你自己的机器上。
  • 自部署隐界需要什么配置?需要 GPU 吗?
    不一定需要 GPU。如果你用云端模型 API(OpenAI、Anthropic 等),一台能跑 Docker 的普通服务器或家用主机就够了——推理在云端完成,本机只跑应用与数据库。只有当你想用本地模型(Ollama / vLLM)离线推理时,才需要相应的显存与算力。
  • 隐界用什么数据库?需要我自己搭建吗?
    不需要你额外搭建。隐界自带数据库与向量索引,docker compose 起来时一并跑在你本地。文档、对话、记忆都结构化存储其中;自部署模式下这些数据只在你自己的机器上。

相关内容

返回自部署文档
分享XTelegramLINE微博
裸机 / VPS 部署(不用 Docker) · 隐界 Enclave