快速开始

Notarium 是一个自托管的知识库，以纯 Markdown 文件的形式存放在你自己的磁盘上——让人和 AI 智能体平等地在其上协作。没有云端，没有私有格式：笔记就存在文件夹里，git 可以作为唯一可信来源。

本章是从零到运行实例的最短路径：用单个容器部署 Notarium，在网页编辑器里创建第一篇笔记，再通过 MCP 接入你的智能体。整个过程大约五分钟。

你需要准备什么

只要 Docker（或 Docker Desktop）和一个空闲端口。其余的一切——网页编辑器、引擎，以及给智能体用的 MCP 端点——都已经内置在镜像里。无需另行安装 Node、数据库或向量索引。

工作原理

同一个知识库同时向两位读者开放。人通过网页编辑器工作，智能体通过 MCP 端点工作；两者看到的是同一张笔记图谱，而在磁盘上它只是一棵 .md 文件的目录树。

flowchart LR
  human([人]) -->|网页编辑器| core
  agent([AI 智能体]) -->|MCP · start_session| core
  core[Notarium 引擎] --> files[(磁盘上的<br/>Markdown 文件)]
  files -.->|git = 唯一可信来源| git[(仓库)]

核心原则是 file-first：笔记是一个文件，而不是别人数据库里的一行记录。无需导出，因为你从来都不真正"身处其中"——数据始终属于你，也始终在磁盘上。

启动实例

最快的方式是运行预构建镜像。它自成一体：一次性拉起引擎、网页界面和 MCP 端点。

# 拉取镜像并启动容器
docker run -d --name notarium \
  -p 3000:3000 \
  -v notarium-data:/data \
  docouno/notarium:latest

单个 /data 数据卷承载了全部状态：元数据库、各类索引、你的笔记，以及导出产物。此外无需再配置任何东西——端口 3000 和数据路径 /data 已经固化在镜像里。3000 左边的端口可以改成任意空闲端口。

打开 http://localhost:3000——迎接你的是首次运行的初始化界面。它会创建实例所有者（第一个账户）和一个起步用的（个人）空间。之后你就进入编辑器了。

端口与数据

你可以通过修改 -p <yours>:3000 左边的数字来更改端口 3000。docouno/notarium 镜像是公开的——这是主要的安装路径（更多细节以及从源码构建见安装页面）。/data 数据卷在你重建容器时依然保留——但要守护好数据卷本身：数据会随它一同消失。

首次启动时幕后发生了什么：

引擎启动，并在你指定的端口上提供网页界面；
在 /data 数据卷内部初始化你的空间目录树；
初始化界面创建所有者——这个账户拥有该实例。

下一步

实例已经跑起来了——接下来是三个简短的步骤。每一步都有专门的页面讲解：

步骤	页面	你将获得
1	安装与启动	`docker` / `make up`、数据卷与初始化界面的讲解
2	你的第一篇笔记	文件树、网页编辑器、保存为 `.md`
3	接入智能体	一个令牌、`POST /mcp` 端点、调用 `start_session`

想先把整个模型弄明白？去看看概念章节：空间与项目、笔记类型、知识图谱，以及面向人和智能体的访问模型。