大众点评做团购网站,解析软件的网站,宁波高端品牌网站建设,优秀的营销案例前不久#xff0c;我写了一篇文章#xff0c;介绍《如何在本地部署安装 Outline》#xff0c;我之所以写这篇文章#xff0c;主要原因是我最近需要做一个项目#xff0c;使用 Outline 来构建一个公司级知识库。所以我需要在本地先搭建一个#xff0c;来撰写一些前期的文档… 前不久我写了一篇文章介绍《如何在本地部署安装 Outline》我之所以写这篇文章主要原因是我最近需要做一个项目使用 Outline 来构建一个公司级知识库。所以我需要在本地先搭建一个来撰写一些前期的文档并体验试用系统。
现在我部署了一个线上的系统来正式实现公司级的知识库结果踩了不少坑特撰写文章来与大家分享希望大家引以为戒。 一、企业级部署
前文已经介绍而本地部署的方法其实企业级部署也差不多的方式我就不想多介绍细节了主要介绍一下坑。
企业级的部署采用的主要方法还是使用 Docker 或者 K8S 这样的系统来部署是最简单的。坑主要在几个地方
1. 登录方式
你首先要想好的事部署好了 Outline 的话怎么登录呢可以使用帐号登录那样的话会在企业原有很多业务系统的前提下又多了一个帐号系统员工入职申请和离职吊销引发的一致性问题都是需要解决的。很不方便。
使用 OAuth 登录这个是需要专门修改代码来开发的不是很直观。原生提供的方式还有使用 Google 邮箱登录或者使用 OIDC 登录还有就是集成 Slack不过中国公司没几个使用 Slack 的就有点尴尬。
我们公司是使用 Google 邮箱的但是 Outline 部署在中国服务器是无法联通 Google 服务器的还需要给服务器科学才能正式完成 Google 登录。而 Outline 本身不支持配置代理在里面所以整个配置过程有点麻烦我不想赘述。
2. 附件存储
企业级使用你不可能不考虑附件存储的问题。而且 Docker 部署则约束了你不能使用简单的本地存储方式。比如最起码你需要挂载网络卷然后让本地文档存储在网络硬盘上这个还比较好部署一点。
另一种方式就是使用网络存储但是 Outline 原生只支持 AWS 的 S3好在中国的阿里云和腾讯云都是支持 S3 的 API 的。但是我们实际配置了才知道这也是一个大坑。比如腾讯云的 COS我们配置了发现腾讯实现的 HTTP 协议竟然是区分 Header 大小写的这明显与协议不符。不知道写这个 HTTP 服务的 老哥是怎么混进去的。
如果访问腾讯的 COS使用 S3 的协议必须将所有的鉴权 Header 全部小写才可以被腾讯验证。哔了狗的体验难怪做不过阿里云不过我并不知道阿里云实现的对不对反正腾讯云糟糕。
如何才能让 Outline 支持腾讯云的 COS 呢非修改代码不可。真是无语凝咽。
二、兼容性问题
解决了部署终于可以愉快的使用了你发现噩梦才开始。系统有一些很神奇的设定让你惊讶。
1. 导入导出
我的设想是我弄一个测试环境在上面编辑好文档然后导出导入到线上环境。想法很美妙现实很残酷
我发现我导出后再导入我设置的文档集前面的小图标没了而且文档集的顺序全乱掉了。
而且文档集内的文档的顺序也没了只能按照字典序排列而且不能手动脱拽调整顺序了功能根本不一致。
2. 格式兼容
我编辑的一些加黑 高亮的格式在导入再导出后加黑突然失效了。所以这个系统对 Markdown 的支持是有缺陷的。
3. 图片链接
我发现另一问题就是我导出的文档里面包含的系统内部的链接在导入后全部失效了 都变成了 url encode 后的乱码了。这个太糟心了点击也没法跳转了。所以整套导入导出机制就彻底无意义了。
另一个致命问题是图片。这个系统是有 BS 架构的。所以是 server 的结果你上传了任何图片它保留在文档里的图片链接竟然是指向了自己的 server所以更加枪毙了导入导出的方案糟糕至极。
4. 不合常理的设计
我导入完毕后看到有个导入的历史记录就很洁癖的随手删掉了弹出的二次提醒完全没看。后来我才知道那个提醒上写着如果删除您此次导入的所有文档都将删除气死我也等我回过神来发现怎么所有文档都不见了还在那里调查出了啥 bug。
所有的文档都进入了回收站我心暗叫还好然后就发现另一个更惊讶的事情回收站的文档竟然只能看不能恢复还是免不了 30 天被删除的命运能活活气死你。
5. 中文搜索
我发现对中文的搜索支持极其不足比如我的一篇文档是“客户端证书安装指南”结果搜“证书” 是完全搜不到的只能搜“客户端”这…… 后来我手动加了空格“客户端 证书 安装指南”才能让“证书” 两个字可以搜索出来简直了
三、结论
所以你想搞个免费的企业级知识库的话Outline 未必是比较好的选择。上面的问题你都能接受即可。除了上述的各种缺点外其编辑器算是比较好用的了另外允许对图片加工对齐格式和大小也比较友好。协同编辑的功能和性能也还可以。还是有一些优点的。当然界面也很美观。
只是远远称不上完美。对于负责安装部署和维护的人来说堪称糟糕。
顺便提一嘴我用的版本是 0.75.2 2024-03如果您从遥远的未来看到此文注意时效性。
