docker-compose安装outline并构建自己的文档管理系统

NO.1
outline简介

outline一个使用 React 和 Node.js 为您的团队构建的快速、协作的知识库,开源的wiki。

github地址:https://github.com/outline/outline

NO.2
outline特点

outline的优点

  1. 支持三级目录甚至多级无限目录
  2. 支持docker部署(但是官方部署有难度)
  3. 支持web访问,带有管理界面
  4. 有用户管理,可多人协作(尚未实际测试)
  5. 支持暗黑模式
  6. 支持版本记录

outline的缺点

  1. 官方私有化部署登录强依赖Slack 、GitHub,Google等第三方账号体系,不提供邮箱+密码登录方法(实际上还是需要联网)
  2. 使用S3存储,本地并不是完全在本地,且对非程序员不友好
  3. 截止到目前为止release有100多个版本,但是最新的额版本号也才v0.65.2,还没到v1.0.0

NO.3
outline安装

本文不推荐官方的安装文档,推荐另一个安装方式

github地址:https://github.com/vicalloy/outline-docker-compose

安装步骤

git clone https://github.com/vicalloy/outline-docker-compose.git
cd outline-docker-compose
cp scripts/config.sh.sample scripts/config.sh
# update config file: vim scripts/config.sh
make install  # create docker-compose config file and start it. Initializing the oidc-server(add oidc client for outline and create a superuser).

注意事项,上述安装后访问为http://127.0.0.1:8888
由于本文的8888端口已被占用,且为树莓派安装,所以ip内网地址也需要修改

修改文件为script/config.sh

全局替换

127.0.0.0->你的服务器的内网地址ip(192.168.1.236)

8888->你的服务器开放的端口号(本文分配为7023)

tips

  1. 先cp scripts/config.sh.sample scripts/config.sh(设置配置文件)
  2. 然后修改配置文件ip和端口
  3. 然后启动服务make install

这样是才会是自定义的ip和端口

NO.4
outline使用

目前使用为markdown编辑,可输入待办事项,在线编辑模式

可提供对外访问地址

NO.5
tips

outline相对于vuepress,Docsify,Docusaurus,gitbook的区别主要为

  1. 可以在线编辑,而不是本地文档编辑后再生成
  2. 带有管理后台,可视化配置主题和成员权限以及其他配置,而不是使用代码配置(对非程序员不友好)
  3. 不强依赖频繁升级的各类编程框架和语言,如vue,react

END.