outline outline Self Hosting · Discussions · GitHub

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