Docmost 是可自托管的团队 Wiki 与协作文档平台,通过空间和页面树组织资料,支持实时编辑、评论、页面历史、搜索与附件。产品需求、技术说明、会议记录和操作手册需要多人长期维护时,它提供了比零散文件夹更统一的写作与查找入口。

选型要同时考虑文档怎么组织、服务由谁维护:Docmost 可以让团队控制域名、数据库和附件位置,也需要团队维护这些服务。核心使用 AGPL-3.0 许可;开源版与商业版本的能力不同,不能把官网所有功能都当成免费自托管功能。
先规划空间,再导入旧文档
空间负责把不同团队或项目的资料放在各自范围里,页面树负责空间内的层级。以技术团队为例,可以在同一空间下区分“服务说明、操作手册、会议记录”;另一个客户项目如果成员与访问范围不同,可以单独建空间。这里的目录只是组织示例,实际应按团队查找资料的方式决定。
- 先定空间的成员范围,再邀请成员或群组。空间角色区分完整访问、可编辑和只读,便于把维护者与读者分开。
- 页面名称直接对应主题,父页面提供导航;不要为了目录整齐把一段短说明拆成多层空页面。
- 在试点空间中放入有正文、图片和子页面的代表性资料,确认成员能够查找和编辑,再逐步扩大迁移。
多人实时编辑与评论适合共同补齐一份说明,页面历史也提供了回看修改的入口。它们能帮助维护内容,但仍需要明确谁负责更新:文档平台不会自动知道一份操作手册是否已经过时。
迁移时同时检查正文、链接和附件
基础 Markdown、HTML 和 ZIP 批量导入适合已有文本资料。若从 Notion 或 Confluence 迁移,应先核对所选版本提供的导入能力,再拿小批资料试迁移;源平台的数据库视图、自动化或特殊组件,不能因为页面能够导入就认定一并等价迁移。
- 从旧系统导出一个完整小目录,包含正文、子页和附件,并保留原始导出包。
- 导入目标空间,检查层级、内部链接、图片与附件,再用普通成员身份确认访问范围。
- 完成一次 Markdown 或 HTML 导出。需要附件时启用 Include attachments,确认导出包能在平台外打开,便于后续迁移或离线保存。
页面导出适合保留可读的内容副本,不能代替整个实例的数据库和附件备份。成员、权限与系统配置是否可恢复,仍要按自托管架构处理。对外分享资料也应有单独的确认流程,内部文档和客户附件不要默认公开。
部署的三个服务与几个必改参数
官方推荐 Docker Compose,仓库模板包括 Docmost、PostgreSQL 和 Redis。应用附件默认保存在挂载的 /app/data/storage;也可以按配置使用 S3 或 Azure Blob Storage。备份设计应覆盖数据库、实际附件存储和必要配置,保留容器镜像本身并不足以恢复知识库。
APP_URL:填写团队真正访问的地址,与域名及 HTTPS 配置一致。APP_SECRET:替换成至少 32 字符的随机值,不能保留模板占位符。POSTGRES_PASSWORD与DATABASE_URL:数据库密码及连接字符串中的密码必须对应,避免只改一处。REDIS_URL、邮件和存储参数:按部署环境设置;邀请邮件与附件应在试点阶段确认可用。
取得并修改仓库的 docker-compose.yml 后,在该文件所在目录运行 docker compose up -d,首次打开实例完成工作区与账号设置。正式使用前配置 HTTPS 反向代理,并验证两个成员同时编辑。
实时编辑依赖 WebSocket;代理需要支持连接升级。首页能打开而编辑器只读或协作异常时,应检查 WebSocket 转发,不能只用普通 HTTP 页面作为上线判断。升级时按目标 Release 检查数据库与依赖变化,先验证备份,再更新实际运行版本。
开源版、Business 与 Enterprise 怎么判断
当前版本说明将自托管分为 Open Source、Business 和 Enterprise。开源版提供核心文档协作能力;Business 与 Enterprise 采用商业许可,启用对应功能需要有效许可 Key,Enterprise 在前者基础上增加审计日志、SIEM 集成和页面验证等治理能力。
如果团队主要维护层级文档与协作说明,可以从开源版试点;统一身份、高级导入、AI 或审计属于必需需求时,按当前功能对比页核对具体版本和费用。仓库 apps/server/src/ee、apps/client/src/ee 与 packages/ee 采用企业许可,看到源码不等于这些模块适用核心的 AGPL 许可。
二次开发从业务模块与配置分开入手
项目主要使用 TypeScript。页面业务可从 apps/server/src/core/page 阅读,空间业务在 apps/server/src/core/space,实时协作在 apps/server/src/collaboration;部署参数则从根目录 .env.example 与 docker-compose.yml 入手。先判断要改文档行为还是部署环境,有助于避免把代理连接问题当成编辑器问题。
试点之后,应能回答这些问题:成员是否找得到资料,修改是否能同步,导出是否带上需要的附件,服务故障以后是否能恢复。得到这些答案后,再决定迁移范围,比把所有旧文档一次性搬过来更容易控制成本。
- 项目仓库:
https://github.com/docmost/docmost - 安装文档:
https://docmost.com/docs/installation - 空间使用说明:
https://docmost.com/docs/user-guide/spaces - 版本与功能边界:
https://docmost.com/docs/editions - 导入导出说明:
https://docmost.com/docs/user-guide/import-export












暂无评论内容