要点速览
- 用过 docker compose 的话,难度等同跑一个普通 web 服务。
- 三步:克隆仓库 → 配置 .env → docker compose up。
- API、前端、数据库、向量索引全在你本地,数据不出机器。
第一步:准备能跑 Docker 的机器
你需要一台装好 Docker 与 docker compose 的机器——一台普通的云服务器或家用主机即可。如果只用云端模型 API,无需 GPU;只有想跑本地模型时才需要相应算力。先确认 Docker 能正常运行。
第二步:克隆仓库并配置 .env
从 GitHub 克隆隐界仓库,复制 .env 模板为 .env,按说明填入必要配置(例如要接入的模型 API key)。整套配置都在这一个文件里,照着仓库 README 与部署文档填即可。
第三步:一行 docker compose 启动
运行 docker compose up,隐界的 API、前端、数据库与向量索引会一并在本地起来。启动完成后用浏览器访问对应地址,就能进入完全属于你、数据只存本机的私人助手世界。日后用 git pull + docker compose up -d 即可升级。
常见问题
隐界可以自部署吗?难不难?
可以,且难度等同跑一个普通 web 服务。如果你用过 docker compose,三步即可拥有自己的实例:克隆仓库、复制 .env、docker compose up。API、前端、数据库、向量索引全部跑在你自己的机器上。自部署隐界需要什么配置?需要 GPU 吗?
不一定需要 GPU。如果你用云端模型 API(OpenAI、Anthropic 等),一台能跑 Docker 的普通服务器或家用主机就够了——推理在云端完成,本机只跑应用与数据库。只有当你想用本地模型(Ollama / vLLM)离线推理时,才需要相应的显存与算力。自部署的隐界怎么更新到新版本?
用 git pull 拉取最新代码,再 docker compose up -d 重启即可滚动到新版本。CHANGELOG 会标注每个版本的破坏性变更,升级前看一眼即可。
准备好试一下?
浏览器即开即用,不需要注册任何信用卡。