Docmost 0.96.0 介绍与选型指南

全面介绍开源自托管协作 wiki 平台 Docmost v0.96.0 的定位、技术架构（NestJS+React+Yjs 实时协作）、功能特性与适用场景，并与 Outline、Wiki.js、BookStack 进行社区活跃度、版本节奏、功能兼容矩阵的量化选型对比，全部数据标注查询日期。

DocmostDocmost2026/10/18

Docmost 0.96.0 介绍与选型指南

目标：全面介绍开源自托管协作 wiki 与文档平台 Docmost 的最新稳定版 v0.96.0——定位、技术架构、功能特性、适用场景，并以量化维度与 Wiki.js、BookStack、Outline 做同类选型对比。本篇为认知篇，全部论断以官方文档、GitHub 仓库与 Release Notes 为依据并标注查询日期（2026-10-18），不做本地安装实测；安装与部署实测见《Docmost Docker Compose 部署指南》。

一、环境信息

本篇为信息基准说明，列出编写本篇时依据的版本与官方来源，便于读者复核时效性。

💡 说明：Docmost 处于 0.x 快速演进阶段，小版本迭代较快，本文所有版本号、数据均标注查询日期；选型时请以官方 Release 页实时数据复核最新版本。

二、软件概述

Docmost 是一款开源自托管的协作 wiki 与文档平台，定位类似 Notion / Confluence 的自托管替代，主打「团队知识库 + 实时协作编辑」。核心采用 TypeScript 全栈（服务端 NestJS + 前端 React），以 PostgreSQL 为唯一数据库、Redis 为队列与缓存中间件，通过 Docker 即可完成整套部署，运维面较小。

  • 当前最新稳定版：v0.96.0（2026-09-08 发布；本文撰写时的最新 Release，查询日期 2026-10-18）
  • 开源许可：核心 AGPL-3.0；企业版特性（SSO/SAML、SCIM、审计日志、AI、Bases 等）位于独立许可的企业版目录（仓库内 apps/server/src/ee、apps/client/src/ee、packages/ee），README 明确说明双许可结构
  • 维护方：Docmost（创始人 Philipinho 主导维护），同时提供官方云服务（docmost.com）与商业企业版，属于「开源核心 + 商业增值」的可持续模式
  • 技术栈（官方仓库与 Release Notes 交叉印证）：服务端 NestJS（Node.js 26，v0.96.0 起）+ pnpm 11 工作区；前端 React 19 + Mantine 9（v0.95.0 迁移完成）；编辑器 TipTap（基于 ProseMirror）；实时协作基于 Yjs 协议栈（v0.96.0 升级 Hocuspocus v4）；数据层 PostgreSQL + Redis（BullMQ 队列）

💡 技术拓展：实时协作编辑的底层方案目前业界主流有三种——OT（Operational Transformation，如 Google Docs 早期方案）、CRDT（如 Yjs，无中心服务器仲裁、支持离线合并）、以及简单的锁/版本比对。Docmost 采用 Yjs 系（Hocuspocus 服务端），优势是多人同时编辑冲突自动合并、延迟低；代价是文档内容以 Yjs 增量结构存储，需要服务端做序列化导出（Markdown/HTML/DOCX）。同类中 Outline 同样走 Yjs 路线，Wiki.js/BookStack 则是「单编辑者 + 版本历史」的传统模式，不支持多人同时同页编辑。

版本演进节奏（官方 Releases 汇总，2026-10-18 查询）：2026 年从 v0.70.0（3 月）到 v0.96.0（9 月）共发布 14 个稳定版本，约 1.52 个月一个 minor 版本，期间穿插数个 patch；2025 年为 v0.20v0.24 系列。当前尚处 0.x，API 与数据结构可能随大版本调整，升级前建议先做数据备份。

三、核心架构

Docmost 是一个「三件套」结构：Web 应用（API + 前端静态资源 + WebSocket 协作服务）+ PostgreSQL + Redis，全部能力打包在官方镜像 docmost/docmost 中，一个 compose 文件即可拉起完整服务。以下结构依据官方安装文档（https://docmost.com/docs/installation ）与源码仓库组织方式（2026-10-18 查阅）。

3.1 组件分工

组件技术实现职责
Web/API 服务NestJS（Node.js 26）REST API、认证会话（JWT Cookie）、权限（CASL）、页面与空间管理、附件上传
实时协作服务Hocuspocus（Yjs 服务端实现）+ WebSocket多人同页实时编辑、增量同步、冲突合并
前端React 19 + Mantine 9 + TipTap 编辑器页面渲染、编辑器、空间/设置界面
数据库PostgreSQL 18（官方 compose 推荐）唯一持久化存储：用户、空间、页面（含 Yjs 快照与历史版本）、附件元数据、审计
Redis 8BullMQ 队列 + 协作会话邮件发送、文件处理等异步任务队列；协作与节流状态

关键差异解读：与 BookStack（PHP + MySQL，单体）或 Wiki.js（Node + 支持多种数据库）相比，Docmost 明确绑定 PostgreSQL（页面内容依赖 PG 的 tsvector 全文检索与 pgvector 向量扩展），不支持 MySQL；Redis 为必配组件而非可选缓存。

3.2 数据与存储流

  • 页面正文以富文本结构（TipTap/ProseMirror JSON，底层 Yjs 协作文档）存入 PostgreSQL，另存 Markdown/HTML 导出转换层；页面历史版本、评论、权限、标签同库管理。
  • 附件存储驱动可插拔（环境变量 STORAGE_DRIVER）：本地磁盘（默认，落盘 /app/data/storage）、S3 兼容对象存储（AWS S3/MinIO 等）、Azure Blob。
  • 异步任务（外发邮件、文件导入导出）经 Redis BullMQ 队列处理，Web 进程与队列解耦，邮件发送失败不影响主服务（实测失败仅记录告警日志，见《Docmost 0.96.0 配置参数详解》）。

3.3 扩展与集成面

  • 认证集成：企业版支持 SAML/OIDC SSO、SCIM 用户同步；v0.96.0 新增 MCP OAuth（可作为 MCP 服务被 AI 客户端接入）。
  • 内容嵌入：Draw.io / Excalidraw / Mermaid 图表内嵌（Draw.io 服务地址可用 DRAWIO_URL 指向自托管实例）。
  • 导入导出：支持 Markdown 压缩包导入、PDF 导出；企业版支持 DOCX 导出与 AI 问答（OpenAI/Gemini/Ollama 驱动，AI_DRIVER 配置）。

四、功能特性

以下特性清单以官方 README 与 Release Notes 为准（查询日期 2026-10-18），分社区版（免费）与企业版（需许可证）两类。

4.1 社区版功能

  • 实时协作编辑（多人同页，Yjs CRDT）
  • 富文本编辑器：斜杠命令、脚注（v0.96.0 新增）、表格、代码块、数学公式、媒体 lightbox（v0.96.0）
  • 图表：Draw.io、Excalidraw、Mermaid
  • 空间（Spaces）与页面树、收藏、模板、回收站
  • 权限与组织：用户组、按空间/页面的权限管理、页面限制（page restrictions）
  • 页面历史与版本对比（v0.96.0 新增两版本 diff 对比）
  • 全文搜索（默认 PostgreSQL 数据库检索）、搜索过滤器与标签过滤（v0.96.0 增强）
  • 评论（含页面内评论与行内评论）、附件管理与画廊（v0.96.0 新增附件 gallery）
  • 文件附件上传（本地/S3/Azure 三种存储驱动）
  • 公开分享链接（share）、RTL 文字方向支持（v0.96.0）
  • 10+ 语言翻译界面、MFA 多因素认证
  • 超链接嵌入（Airtable、Loom、Miro 等第三方内容 embed）

4.2 企业版功能（需许可证）

  • SSO：SAML / OIDC 单点登录、SCIM 用户开通
  • 审计日志（Audit Logs）、SIEM 集成（Splunk / Datadog / Generic HTTP，v0.96.0 新增）
  • Bases：Kanban 与表格视图（v0.95.0）、个人空间（Personal Spaces，v0.95.0）、DOCX 导出
  • AI：AI 问答与 AI 搜索（pgvector / Turbopuffer 驱动）、AI Chat 控制策略（v0.96.0）
  • Typesense 企业级搜索引擎驱动（SEARCH_DRIVER=typesense）
  • REST API 与 API Keys（企业特性，官方 API 文档明确标注需企业许可）

4.3 v0.96.0 版本要点（Release Notes，2026-09-08）

  • 新特性：MCP OAuth、脚注、页面版本对比、页面附件画廊、增强搜索过滤、媒体 lightbox、RTL 支持
  • 平台升级：Node.js 26 + pnpm 11、Hocuspocus v4、全局数据加密模块（AES-256-GCM）
  • 企业版新增：AI Chat controls、SIEM 集成、Turbopuffer AI 向量搜索驱动
  • 官方明确说明本版包含安全修复，建议所有用户升级

五、快速上手（官方安装路径摘录）

本节摘录官方安装文档（https://docmost.com/docs/installation ，查询日期 2026-10-18）的最小可运行路径，属官方文档转述、未做本地实测；完整逐步实测（含国内镜像加速、离线安装、排障）见《Docmost Docker Compose 部署指南》。

官方推荐安装方式即 Docker Compose，三步：

  1. 新建目录并下载官方 compose 文件：
mkdir docmost && cd docmost
curl -O https://raw.githubusercontent.com/docmost/docmost/main/docker-compose.yml
  1. 编辑 docker-compose.yml，修改四处默认值：APP_URL（对外访问地址）、APP_SECRET（≥32 位随机串，可用 openssl rand -hex 32 生成）、DATABASE_URL 与 POSTGRES_PASSWORD（数据库口令，两处需一致）。
  2. 启动并访问：
docker compose up -d

首次访问 http://<服务器地址>:3000 会进入初始化向导，设置工作区名称与管理员账号（邮箱 + 密码）后即可使用。硬件方面官方未给出硬性最低配置，社区实践 2 vCPU / 2GB 内存即可流畅支撑中小团队。

六、适用场景与限制

6.1 适用场景

  • 团队/部门知识库：空间 + 页面树 + 权限组，替代 Confluence 的核心协作场景
  • 实时协作密集型文档：方案评审、会议纪要、多人同页共创（Yjs 实时合并是相对 Wiki.js/BookStack 的代差能力）
  • 技术文档站：Markdown/代码块友好、Draw.io/Excalidraw/Mermaid 图表内嵌、公开分享链接可对外发布
  • 中小规模自托管：单机 Docker 部署、运维面小（仅 PostgreSQL + Redis 两个依赖）

6.2 当前限制（截至 v0.96.0，查询日期 2026-10-18）

  • 数据库仅支持 PostgreSQL，不支持 MySQL/SQLite（与 BookStack、Wiki.js 的多数据库兼容策略不同）
  • REST API 与 API Keys 属企业版特性，社区版只能走界面或会话内操作
  • 部分 0.x 阶段特性仍在快速变动：升级可能伴随数据库迁移，官方每个安全版本都建议及时跟进
  • 邮件为必配能力（邀请用户依赖邮件）：社区版生产使用需自备 SMTP；未配置时邮件静默不入队发送
  • 企业版核心能力（SSO/SCIM/审计/AI/Typesense 搜索）需要商业许可，预算受限团队需评估替代方案

七、同类选型对比

本节从社区活跃度、版本节奏、功能与兼容矩阵三个维度，对四款主流开源自托管 wiki/文档平台量化对比。所有数据实查于 GitHub API 与各官方发布页，查询日期均为 2026-10-18。

7.1 社区活跃度与版本节奏（量化）

指标DocmostOutlineWiki.jsBookStack
GitHub Stars22,01840,94529,04819,086
GitHub Forks1,7553,6213,3252,429
仓库创建时间2023-082016-052016-082015-08
最新稳定版v0.96.0（2026-09-08）v1.11.0（2026-10-12）v2.5.315（3.0 线尚在 beta）v26.09.1（2026-09-29）
开源许可AGPL-3.0 + 企业版BSL 1.1（源可用）AGPL-3.0MIT
主技术栈TypeScript（NestJS+React）TypeScript（Node）TypeScript（Node/Vue）PHP（Laravel）
2026 年发布节奏14 个稳定版（0.70→0.96），约 1.5~2 月一个 minor常规迭代，10 月仍发新版2.5 稳定线维护 + 3.0 高频 beta（10 月连发 5 个 beta）版本号=年.月，约每月一个稳定版

解读：Outline 社区规模最大但许可已转为 BSL 1.1（限定「不得作为 Document Service 对外提供」，自用仍免费，商业化需向 Licensor 授权）；Wiki.js 存量用户多但新功能集中在尚未稳定的 3.0 beta；BookStack 是四者中唯一 MIT 宽松许可、发布纪律最稳的；Docmost 是最年轻的一个（3 年），但增速与发版密度最高（Stars 已接近 BookStack），属于上升期项目。

7.2 功能与部署兼容矩阵

维度DocmostOutlineWiki.jsBookStack
多人实时同页编辑✅（Yjs/Hocuspocus）✅（Yjs）❌（单编辑者+历史版本）❌
数据库支持仅 PostgreSQL仅 PostgreSQLPG/MySQL/MariaDB/SQLite/SQL Server 等MySQL/MariaDB/PostgreSQL
必需中间件PostgreSQL + RedisPostgreSQL + Redis + 对象存储（S3/MinIO）+ 可选 Slack无（可内嵌数据库），可选 Redis无（单库即可）
附件存储本地 / S3 / Azure BlobS3 兼容（必配）本地 / S3本地 / S3
SSO（SAML/OIDC）企业版内置（含 Slack/GitLab/Google 等）企业版内置（OIDC/SAML2）
全文搜索PG 内置；Typesense（企业）PG 内置内置（可选 Algolia 等）内置（MySQL/PG 全文索引）
权限粒度空间/页面级 + 用户组集合级 + 共享链接空间/页面级 + 群组书/章/页级 + 角色较细
界面语言10+ 语言多语言多语言（翻译体系成熟）多语言
AI 能力企业版（OpenAI/Gemini/Ollama）内置 AI 助手无内置无内置
典型部署体量单机 compose（3 个服务）组件多（对象存储/Slack 集成可选）单机即可，最轻单机即可，最轻

关键差异解读：

  • 若「多人同时编辑同一页」是硬需求 → Docmost 与 Outline 二选一；其中 Outline 许可为 BSL 1.1 且强依赖对象存储，Docmost AGPL + 本地存储即可起步，自托管门槛更低。
  • 若要宽松许可（MIT）与最稳发布纪律、传统 wiki 型协作（单编辑者）→ BookStack。
  • 若要支持多种数据库、或已有 SQLite/SQL Server 环境想低依赖部署 → Wiki.js（2.5 稳定线）。
  • 若看重文档「数据库化」能力（Kanban/Base 视图、AI 问答）且能接受 AGPL + 企业版付费 → Docmost 的功能演进速度三者中最快。
  • 三款同类平台的部署与配置实测记录可参阅《Wiki.js Docker Compose 部署指南》《BookStack Docker Compose 部署指南》。

八、参考链接

  1. Docmost 官网：https://docmost.com
  2. 官方文档：https://docmost.com/docs
  3. GitHub 仓库：https://github.com/docmost/docmost
  4. Release v0.96.0：https://github.com/docmost/docmost/releases/tag/v0.96.0
  5. 全部 Releases（版本节奏依据）：https://github.com/docmost/docmost/releases
  6. 官方安装文档：https://docmost.com/docs/installation
  7. 环境变量文档：https://docmost.com/docs/self-hosting/environment-variables
  8. Docker Hub 发布页：https://hub.docker.com/r/docmost/docmost
  9. Wiki.js 仓库：https://github.com/requarks/wiki
  10. BookStack 仓库：https://github.com/BookStackApp/BookStack
  11. Outline 仓库与许可：https://github.com/outline/outline 、https://github.com/outline/outline/blob/main/LICENSE