跳到主要内容
隐界

自部署架构与服务拓扑

自部署的隐界只有两个服务:静态前端(主 App)+ Core API(NestJS),数据存一个 SQLite 文件——没有 Postgres、Redis 或消息队列等外部依赖。本文讲清每个部分是什么、数据在哪、运维入口在哪。

动手部署前先花两分钟看懂拓扑:你要跑起来的东西比想象中少。所有桌面端与移动端都只是远程客户端,不需要在每台设备上各跑一套后端。

两个服务,一个数据文件

主 App(apps/app)是纯静态前端,默认端口 5180(Docker 模式为 80),由 nginx 托管并把 /api、/socket.io、/health 反代给后端;Core API(api/)是 NestJS 后端,默认端口 3000,数据全部落在一个 SQLite 文件(默认 ./data/database.sqlite)。就这两件,没有第三个常驻服务。

没有外部依赖

后端通过 better-sqlite3 使用 SQLite 单文件数据库,不需要 Postgres / MySQL / Redis / MongoDB(当前也不支持切换到 Postgres/MySQL——这是诚实的边界,社区贡献欢迎)。这意味着备份与迁移就是复制文件,也意味着一台最低配 VPS 就能跑。

所有客户端都是远程接入

iOS、Android、Windows、macOS、Web 全部作为远程客户端接入:客户端里只填服务端地址,不在本地启动 Core API。桌面壳(Tauri)也是同样的远程模式——壳本身不带后端,所以部署一套服务端,全家设备都能连。

运维入口:/admin/* 接口

独立的运维后台前端已退役,运维能力以后端 /admin/* 接口形式内置:任何 HTTP 客户端带上 X-Admin-Secret 请求头即可调用(密钥在 env 的 ADMIN_SECRET 配置)。例如用 curl 查实例统计:curl -H "X-Admin-Secret: 你的密钥" http://127.0.0.1:3000/api/admin/stats。

开源边界

官方多租户云的运维控制台(cloud-api / cloud-console)与 Wiki 角色平台不在开源范围内——自部署完全用不到它们,单实例的一切能力都在上面两个服务里。开源部分为 MIT 协议,可审计、可修改、可商用。

相关问题

  • 隐界可以自部署吗?难不难?
    可以,且难度等同跑一个普通 web 服务。如果你用过 docker compose,三步即可拥有自己的实例:克隆仓库、复制 .env、docker compose up。API、前端、数据库、向量索引全部跑在你自己的机器上。
  • 隐界用什么数据库?需要我自己搭建吗?
    不需要你额外搭建。隐界自带数据库与向量索引,docker compose 起来时一并跑在你本地。文档、对话、记忆都结构化存储其中;自部署模式下这些数据只在你自己的机器上。
  • 隐界是开源的吗?用什么协议?
    是。隐界整个 monorepo 以 MIT 协议在 GitHub 开源,可自由审计、修改、商用。任何「我们不会滥用你的数据」的承诺,你都可以亲自看代码验证,而不是只能选择相信。
  • 隐界可以商用吗?MIT 协议有什么限制?
    可以商用。隐界以 MIT 协议开源,允许自由使用、修改、分发,包括商业用途,唯一要求是保留版权与许可声明。你可以基于它二次开发、内部部署或对外提供服务,无需额外授权费。

相关内容

返回自部署文档
分享XTelegramLINE微博
自部署架构与服务拓扑 · 隐界 Enclave