---
title: "快速开始"
description: "五分钟从零到第一篇笔记：用单个容器启动实例，创建第一篇笔记，再接入 AI 智能体。"
---

# 快速开始

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

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

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

## 工作原理

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

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

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

## 启动实例

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

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

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

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

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

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

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

## 下一步

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

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

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