动手部署前先花两分钟看懂拓扑:你要跑起来的东西比想象中少。所有桌面端与移动端都只是远程客户端,不需要在每台设备上各跑一套后端。
两个服务,一个数据文件
主 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 协议开源,允许自由使用、修改、分发,包括商业用途,唯一要求是保留版权与许可声明。你可以基于它二次开发、内部部署或对外提供服务,无需额外授权费。