开源知识管理系统Outline的快速部署
Outline 是一款优秀的开源 Wiki 和知识管理系统,支持 Markdown 编辑和团队协作。Outline 支持部署到自己服务器,但自部署的体验并不好,主要有以下几个问题:
- 默认使用 AWS 的 S3 服务,国内用户使用体验较差。
- 不提供用户管理模块,需通过 Slack、Google 或自建 OIDC 服务进行登录。
网上已用基于 Docker Compose 的部署方案主要有两个:
- outline-wiki-docker-compose:提供交互式脚本,生成 Docker Compose 配置文件。但使用 Slack 进行登录,国内使用体验不好,且脚本太老,存在 Bug,图片上传后显示不了。
- docker-outline:国内用户写的部署脚本。但脚本不够智能,配置参数较多,且内置的 OIDC 服务不支持用户管理,只能创建一个用户。
为简化部署,网友vicalloy开发了 Outline 一键部署脚本: https://github.com/vicalloy/outline-docker-compose
该脚本具有以下优点:
- 一键自动生成 Outline 和服务依赖的 Docker Compose 配置文件,无需手动配置
- 内置 OIDC 登录认证服务,支持通过 Web 界面管理用户
- 简化存储配置,默认使用 MinIO 提供对象存储服务
- 提供交互式设置向导,自定义 Outline 域名、数据目录等参数
- 基于 Docker Compose 部署,简单快速,本地调试和生产环境通用
- 组件版本可控,可随时更新为最新版本
- 脚本开源,代码透明可审查
相比现有方案,该脚本进一步降低了自部署 Outline 的门槛,使得任何人都可以在几分钟内搭建起生产可用的 Outline 服务。非常适合个人或团队快速创建 Wiki 系统。
内置的 OIDC 登录认证服务也省去了单独部署 Identity Provider 的麻烦。但目前仍存在以下问题:
- https无法登录,只能通过http访问
- 直接用ip部署,nginx段要修改为0.0.0.0:8888
- 登录成功后,图片无法上传,需加入user: 0:0