
团队的文档最终都会走向两个结局:要么散在十几个飞书群、微信群里搜不到,要么塞进一个没人维护的 Confluence,翻三层目录才能找到一篇过期的规范。
Outline 想解决的是同一件事 —— 41,321 颗星,TypeScript 写的,能自己部署。
它长什么样
左侧是树状目录,右侧是文档正文,顶部一个全局搜索框。看起来像 Notion,但定位完全不同:它只做「文档」,不做数据库、不做看板。
功能清单
- Markdown 编辑:所见即所得,支持斜杠命令、代码块、表格
- 实时协作:多人同时编辑,光标可见
- 全文搜索:跨所有文档,支持中文分词
- 权限体系:团队 / 群组 / 单篇文档三级控制
- 版本历史:每次修改都有记录,可回滚
- 公开分享:单篇文档生成外链,可设为只读
- Slack / 飞书集成:搜索结果能直接在聊天工具里调出来
- 导入导出:支持导入 Notion、Confluence、Markdown
部署(docker compose)
git clone https://github.com/outline/outline.git
cd outline
cp .env.sample .env
# 编辑 .env,填数据库、Redis、S3 存储信息
docker compose up -d
官方要求 PostgreSQL + Redis,附件存储建议接 S3 / OSS,本地磁盘只适合测试。
四个实战坑
- 许可不是标准开源。Outline 用的是 BSL 1.1(Business Source License),自己内部用没问题,但不能拿它做成 SaaS 卖给别人,也有到期转 Apache 的条款,商用前务必读一遍。
- 必须配 S3。不配对象存储,图片和附件会写本地磁盘,容器一重建就全丢。
- 中文搜索要额外配。默认分词对中文支持一般,需要在配置里指定 PostgreSQL 的中文分词插件(如 zhparser)。
- 升级跨度不能太大。跨多个 minor 版本升级容易卡在数据库迁移,建议逐版本升。
适合谁
10~200 人的团队,需要一套「写下来、找得到、权限可控」的文档系统,又不放心把内容放在第三方 SaaS 上。个人用户的话,Notion 或 Obsidian 更轻。
© 版权声明
文章版权归作者所有,未经允许请勿转载。
THE END




















暂无评论内容