5分钟部署Utopia：一条Docker命令搭建企业知识库的速成教程-平芜编程栈

5分钟部署Utopia：一条Docker命令搭建企业知识库的速成教程

【免费下载链接】utopia首个开源企业世界模型项目地址: https://gitcode.com/deeplethe/utopia

Utopia是首个开源企业世界模型，由 DeepLethe 构建。它把时间感知与本体论融入底层，能自动把文档变成带时间、带出处的知识图谱，并支持混合检索问答、MCP 智能体接入与合规审计。本文是一份面向新手的速成教程：只需一条 Docker 命令，5 分钟即可在本地跑起一套完整的企业知识库。

为什么选择 Utopia：不只是又一个知识库

大多数向量库和知识图谱只关心"当下知识对不对"，Utopia 关心的是"认知的完整变化历程"：

🕰️双时态知识图谱：每条事实都带着"何时成立"和"系统何时得知"两根时间轴，修订关闭旧版本而不是覆盖，决策复盘有据可查；
📥文档全接入：PDF、Word、PPT、Excel、Markdown、HTML 直接上传，网页、RSS、GitHub、Jira、Notion 定时同步；
💬混合检索 + 引用问答：全文与向量融合检索，回答流式返回并内联标注原文出处；
🤖Agent 与 MCP：内置智能体可对话驱动整个系统，也可通过 MCP 把知识库开放给外部智能体；
🛡️合规审计：每次确认、合并、撤销都留痕，可离线私有化部署。

架构上极其轻：一个 Rust 二进制 + 一个 Postgres，全文索引内嵌、向量走 pgvector、任务队列就是一张表，没有额外组件要维护。

部署前准备：只需要一个 Docker

Utopia 部署的唯一依赖是 Docker（含 compose 命令），无需手动安装数据库或编译工具链：

项目	要求	说明
Docker + Compose	必装	一条命令拉起数据库和应用
平台	x86-64 / Apple Silicon 均可	预构建镜像同时发布 amd64 与 arm64
端口	1516	应用服务地址

💡 镜像由官方预构建并托管前端产物，详见 docker/Dockerfile 的三阶段构建。

一键部署 Utopia 企业知识库（仅 3 步）

克隆仓库：

git clone https://gitcode.com/deeplethe/utopia cd utopia

启动完整应用（数据库 + 应用，后台运行）：

docker compose --profile app up -d

查看状态，确认两个服务都在运行：

docker compose ps docker compose logs -f app

命令会拉起两个容器：db（带 pgvector 的 Postgres 16）和app（Utopia 应用）。首次启动会自动执行全部数据库迁移，之后打开浏览器即可使用。

打开控制台并完成初始化

访问http://localhost:1516并注册账号——第一个注册的账户自动成为系统管理员，同时会创建一个人人可读的公共知识库；
进入「管理 → 模型」，配置对话（chat）与向量（embedding）模型端点：任何 OpenAI 兼容接口都可用（DeepSeek、Qwen、GLM、Ollama、vLLM），因此整个系统可以完全离线运行；
上传第一份文档（PDF 或 Word 皆可），即可体验自动实体抽取与带引用的问答。

想跳过界面快速自检？仓库内置了端到端冒烟脚本 scripts/smoke.sh，一条命令验证「健康检查 → 注册 → 工作区 → 知识库 → 权限」全链路。

常用配置速查表：改这几个变量就够了

所有配置都走UTOPIA_前缀的环境变量，默认配置对本地开发直接可用（示例见 .env.example）：

变量	默认值	用途
`UTOPIA_DB_PASSWORD`	`utopia`	数据库口令，只在数据卷首次初始化时写入
`UTOPIA_DB_BIND`	`127.0.0.1:1517`	宿主机数据库端口，被占用时改这里
`UTOPIA_DB_IMAGE`	`pgvector/pgvector:pg16`	拉不动官方库时，换成任何带 pgvector 的 PG16+ 镜像
`UTOPIA_IMAGE`	预构建 rc 版本	生产环境建议锁定具体版本，升级前先备份