简介
Docmost 是一套面向团队知识库、项目文档和内部操作手册的开源协作平台,采用空间与页面树组织内容,并提供实时编辑、评论、搜索、模板及公开分享。它更适合希望掌握数据位置、域名和升级节奏,同时具备服务器维护能力的技术团队与中小组织。

杂货喵小编结合 Docmost 官网、GitHub 仓库、安装文档、版本说明与 WarpNav 原文重新核对,重点梳理社区版能解决什么问题、Docker 上线前要准备哪些服务,以及它与 Notion、Confluence 的替代边界。截至 2026 年 7 月 15 日核对时,项目最新正式版为 v0.95.0,核心代码采用 AGPL-3.0,企业功能使用单独许可。
本文要点
- 空间、页面树、模板与全文搜索适合建立结构化内部知识库。
- 多人实时编辑依赖 WebSocket,反向代理必须正确转发连接。
- 官方推荐 Docker Compose,并依赖 PostgreSQL、Redis 与持久化存储。
- SSO、审计、细粒度权限和部分 AI 能力属于商业版本边界。
- 项目仍处于 1.0 之前,升级前应阅读 Release 并验证备份恢复。
先判断 Docmost 是否适合团队
| 需求 | Docmost 的匹配点 | 选择前要确认 |
|---|---|---|
| 内部 Wiki | 空间、页面树、模板、搜索 | 目录与权限模型是否符合现有组织 |
| 多人写文档 | 实时协作、评论、页面历史 | WebSocket、邮件与通知配置 |
| 数据自主管理 | 数据库和附件由团队控制 | 备份、监控、升级与故障恢复责任 |
| 企业身份治理 | 商业版提供更多身份与审计能力 | 许可费用、SSO、SCIM 和合规需求 |
若团队主要需要产品需求、技术说明、会议记录和操作手册,社区版的文档协作能力通常更值得先行评估。若必须具备严格审计、细粒度权限、统一身份管理或厂商 SLA,则应从商业版本和其他企业知识库方案一起比较,不能只看编辑器界面。
核心功能与使用场景
空间和页面树让知识结构更稳定
空间可以按部门、项目或客户隔离内容,页面树负责建立层级。团队还可使用模板统一会议纪要、需求文档和操作手册格式。迁移旧资料前,建议先设计空间边界与命名规范,再导入小批量内容,避免把原平台中混乱的目录原样复制过来。
实时协作适合共同维护文档
成员可以共同编辑页面、发表评论,并利用页面历史处理修改与恢复。实时能力依赖 WebSocket;使用 Nginx、Caddy 或其他代理时,应同时验证普通 HTTP 请求和长连接,不能只以首页能够打开作为部署成功标准。
搜索、公开分享和附件需要治理
全文搜索、标签和公开链接能提高资料查找与外部分享效率,但公开链接不应代替访问控制。涉及客户资料、内部账号、合同或敏感附件时,应建立定期检查机制;本地卷、S3 或 Azure Blob Storage 也要纳入同一套备份与权限方案。
Docker 部署前的准备
- 准备支持 Docker Compose 的服务器、域名、HTTPS 证书与稳定存储。
- 把
APP_URL设置为实际访问地址,并生成至少 32 字符的随机APP_SECRET。 - 为 PostgreSQL 设置独立强密码,为数据库、Redis 和附件配置持久化。
- 在反向代理中正确配置 HTTPS 与 WebSocket 转发,再测试多人同时编辑。
- 接入邮件、监控和备份,完成一次数据库与附件恢复演练后再正式迁移。
升级时通常需要拉取新镜像并重建服务。由于当前版本仍在 1.0 之前,建议固定镜像版本,先在测试实例确认数据库迁移和关键页面可用,再升级生产环境,并保留可执行的回滚副本。
社区版与商业版边界
Docmost 核心采用 AGPL-3.0,覆盖常见的页面、空间、协作、评论、搜索和分享能力;仓库中的企业版目录以及 SSO、MFA、SCIM、审计、细粒度权限、部分 AI 与高级导入能力使用单独许可。开源并不等于所有功能均可免费商用,二次开发、对外提供网络服务或采用企业模块前,应分别阅读对应许可证和当前版本对比页。
适用人群
Docmost 适合已有 Docker、数据库、反向代理和备份经验,希望自建团队 Wiki、产品文档或技术知识库的组织。它也适合先用社区版验证文档流程,再根据身份治理与合规要求评估商业版的团队。
完全没有服务器维护能力、要求开箱即用的企业支持,或必须立即获得成熟迁移服务和严格 SLA 的团队,不宜只因“可自托管”而选择。此时托管知识库或带正式支持的商业方案通常更省心。
编辑整理体验
Docmost 的优势在于把现代协作文档体验与自托管控制结合起来,空间、页面树和模板也比单纯堆积 Markdown 文件更适合多人长期维护。真正的选型分界并非功能数量,而是团队是否愿意承担数据库、附件、邮件、权限、升级和恢复责任。
从迁移角度看,先小范围建立一套真实文档流程,比一次导入全部历史资料更容易发现权限、目录和搜索问题。确认成员能够编辑、查找、评论和恢复页面后,再逐步扩大范围。
常见问题(FAQ)
Docmost 可以免费使用吗?
社区版可以自托管,核心采用 AGPL-3.0。企业功能使用单独许可,服务器、存储、邮件和运维也会产生实际成本。
能完全替代 Notion 或 Confluence 吗?
它适合团队 Wiki、层级文档和实时协作,但数据库视图、复杂自动化、企业身份治理与第三方集成存在差异,应按实际工作流逐项核对。
为什么协作编辑连接异常?
常见原因是反向代理没有正确转发 WebSocket。应检查代理头、超时设置、HTTPS 域名与 Docmost 的访问地址配置。
升级前最重要的准备是什么?
保存数据库和附件的可恢复备份,阅读目标版本 Release,并先在测试实例验证迁移;只有容器镜像不等于完整备份。
部署建议
准备正式使用时,先用测试域名完成 Docker Compose、HTTPS、WebSocket、邮件、备份和恢复验证,再迁移真实知识库。权限、公开分享和附件存储应在上线前形成明确规则,而不是等资料泄露或误删后再补。
项目版本和商业功能划分会继续变化,下载、升级与授权判断应以 Docmost GitHub、官方文档、Release 和许可证原文为准。














暂无评论内容