Outline 是什么
一句话总结
一个开源的知识库/wiki 系统，长得像 Notion，但你可以自己部署、对接自己公司的 SSO，数据完全归你管。
🤔 为什么会有它 / 解决了什么问题
公司内部的知识沉淀需要个地方——Confluence 太贵太臃肿，Notion 不能自部署，Google Docs 不适合结构化知识。Outline 用”API 优先 + OIDC 认证”的方式，既好用又能私有化，正好适合”开源+可控”的组织。
🔍 具体运作原理 / 运作逻辑
基于 Node.js + React，数据存 PostgreSQL。内容是 Markdown 格式，支持实时协作编辑。文档按”收藏集（Collection）“组织树状层级。认证对接 OIDC（支持几乎所有 SSO 提供商），不需要自己管用户注册。搜索靠 PostgreSQL 全文检索，响应快。
更硬核的技术细节（点击展开）
WebSocket 做实时协作（Yjs CRDT 算法，多人同时编辑不冲突）。API 完全开放，可用 API Token 做自动化（批量导入、导出、集成到 CI-CD）。Markdown 导出原汁原味，不会锁格式。Slack 集成深度好：可以用 Slack 命令搜索文档、创建文档。支持嵌套收藏集（Nested Collections），文件夹层级不限。
🧭 什么情况下会用到 / 什么场景会遇到它
- 团队需要一个私有部署的内部知识库，不信任 SaaS 供应商的数据托管
- 需要对接公司现有 SSO（OIDC/SAML），不想多维护一套账号
- 和 Frappe 生态搭配：Frappe 做数据底座，Outline 做团队文档协作层
🛠️ 怎么上手 / 在哪操作
docker compose 部署（官方有完整 docker-compose.yml），配 OIDC Provider（如 Frappe OIDC），设 SECRET_KEY 和 DATABASE_URL 环境变量。
⚖️ 副作用 / 代价 / 取舍
- 没有 Notion 的数据库（Database）功能和复杂表格，适合纯文本场景
- 自部署需要维护 PostgreSQL + 升级，多了运维工作
- 实时协作体验不如 Notion 流畅（CRDT 同步偶尔有延迟）
🕰️ 来历
- 谁提出/创造的：Joachim Verbist（前苹果设计师）和几位工程师创立，公司名 Outline Inc.
- 什么时候出现的：2019 年首次发布，2020 年开源（BSL 许可证）
🔗 关联 / 经常一起出现的概念
- n8n：同属本项目的 0-VPS 验证应用。Outline 做 wiki，n8n 做自动化，形成协作闭环
- PostgreSQL：Outline 的唯一数据存储后端，用其全文检索做搜索
- OIDC：Outline 的身份认证方式，可对接 Frappe OIDC 实现统一 SSO
⚠️ 注意事项 / 常见误区
- Outline 不是 Notion 的开源替代——它是”团队 wiki”，不是”全能协作平台”
- BSL 许可证：免费自部署无限制，但提供 SaaS 服务有额外约束
- 搜索依赖 PostgreSQL 全文检索，大量文档时性能会下降，需要优化索引
📎 记忆锚点
“开源版 Notion，去掉数据库功能但换来自部署自由。”
📝 更新日志
| 日期 | 改动 | 原因 |
|---|---|---|
| 2026-07-13 | 首次创建 | - |