团队写方案、记会议纪要，最怕版本满天飞：微信群里一个 .docx、邮箱里又一个「最终版2」，改着改着谁也说不清哪份是新的。HedgeDoc 是开源的实时协作 Markdown 编辑器（原 CodiMD 分支），多人同时编辑同一篇、光标互相可见、改动即时同步，所有内容存你自己的服务器。本文记录在雨云 VPS 上用 Docker 部署 HedgeDoc 的过程。
一、HedgeDoc 解决什么
核心能力：
- 实时协作：多人开同一篇文档，输入即时同步，适合共同写稿、头脑风暴；
- Markdown 原生：左边写 MD、右边实时预览，程序员友好；
- 版本历史：可回滚到之前的快照，误删能找回来；
- 权限粒度：单篇可设公开/私有/登录可见，链接分享方便。
和前面写过的 Wiki.js（见 12255）、Outline（见 12267）、BookStack（见 12274）不同，这三者偏「结构化知识库」，HedgeDoc 偏「多人临时共创一篇」，定位更接近在线协作文档而非文档系统。
二、环境准备
HedgeDoc 本体不重，1 核 1G 就能跑，但生产建议配一个数据库（Postgres 或 MySQL）和 Redis（协同编辑依赖）。系统 Ubuntu 22.04，装好 Docker（入门见 12235）。雨云入门版即可起步，后续按需升配。
新用户用优惠码 admin01 可享 五折优惠，雨云支持 7 天无理由退款。入口：雨云官网。
三、部署要点与坑
官方提供 docker-compose.yml，关键环境变量：
CMD_DB_URL：数据库连接串，生产务必用外部库而非默认 SQLite；CMD_DOMAIN：对外访问域名，必须填正式域名；CMD_ALLOW_ANONYMOUS：是否允许匿名编辑，对外服务建议关掉；- 协同编辑走 WebSocket，反代需放行
Upgrade头。
踩坑提醒：
- 别用 SQLite 跑生产：高并发协作下锁表严重，切到 Postgres 更稳；
- WebSocket 要配：用 Nginx 反代时，
Connection和Upgrade头不加会导致实时同步失效，退化为手动刷新； - 匿名编辑要关：公开实例开着匿名编辑容易被灌垃圾内容，建议至少要求登录。
如果担心后台暴露，可用 Authelia（见 12340）给编辑入口加一层登录保护。
四、备份与协作流
文档存数据库，定期用 BorgBackup（见 12306）备份数据库卷即可。典型用法是把 HedgeDoc 作为「会议现场共创板」，会前建好模板，会上多人同时填，散会直接导出 MD/PDF 归档到 Wiki.js 或 BookStack。
五、典型场景
- 远程团队写稿：多人同时改一篇文案，告别来回传文件；
- 会议纪要：会上实时记录，散会即定稿；
- 技术评审：贴代码块、画流程图，边看边改。
合规提醒
多人协作文档的内容由参与者共同产生，运营方需履行《网络安全法》规定的信息内容管理责任，发现违法不良信息应及时处置；同时应在页面明示使用规范，提示用户不得上传侵权或违规内容。
