docker|支持中文!秒建 wiki 知识库的开源项目,构建私人知识网络

docker|支持中文!秒建 wiki 知识库的开源项目,构建私人知识网络

文章图片

docker|支持中文!秒建 wiki 知识库的开源项目,构建私人知识网络

文章图片

【docker|支持中文!秒建 wiki 知识库的开源项目,构建私人知识网络】docker|支持中文!秒建 wiki 知识库的开源项目,构建私人知识网络

文章图片

docker|支持中文!秒建 wiki 知识库的开源项目,构建私人知识网络

文章图片

docker|支持中文!秒建 wiki 知识库的开源项目,构建私人知识网络

文章图片


不知道有没有人和我一样 , 觉得自建的东西是互联网上的“自留地”、私人空间 , 有一种自己的一亩三分地随心所欲的痛快 。
比如自建的博客想写什么随笔就写什么 , 不用取悦读者可以自娱自乐;再比如自建的 wiki 有不会的知识点就可以直接记录 , 不用担心被嘲笑低级 。 抛开共建这块不聊 , Wiki 不同于博客的随性 , 记录的内容更注重知识点和分类 , 可以用来构建自己的知识网络 。
如果把博客比作“日记本” , 那 wiki 就是“笔记本”它用来记录知识点 , 方便用时查阅和更新 , 有清晰的目录而且一个知识点还可以关联到其它知识点 , 逐步拓展成“百科全书” 。
一、介绍知识在于积累 , 还不能忘记梳理 。
今天 , 我们要介绍的开源项目是专门用来构建 wiki 平台 , 助你梳理知识点的 wiki.js

地址:github.com/requarks/wiki
它是一款轻量级、功能强大的 wiki 开源项目 , 拥有评论、Markdown 编辑器、图片上传、标签、全局搜索、协同编辑、编辑历史、用户管理、谷歌分析等功能 , 而且支持高度自定义 。
用到的技术栈也不同于老旧的 wiki 系统 , 它采用了 Node.js、PostgreSQL、Vue.js、Docker 等技术 。 基于 Docker 实现的一键部署 , 颇有 WordPress 之风 , 不要太爽!
重点是支持中文 , 而且界面简洁还不失美感 , 这点足以让它在众多同类项目中脱颖而出 。
看到这儿 , 你是不是手痒了呢?下面就和我一起来让它跑起来吧!
二、安装开源项目成功的必要因素之一就是有详细易懂的文档 , 而安装说明又是重中之重 。
Wiki.js 官方文档提供了多种部署方法 , 包括:Linux、macOS、Windows、Docker、k8s 等 , 涵盖了几乎所有可能性 , 十分全面 。
下面我就介绍其中最快捷和通用的一种 , 即基于 Docker 的 Docker Compose 部署 。
Tips:如果你不懂 Docker 建议跟着 docs.requarks.io/install/ubuntu 逐步执行
下面我将主要介绍 Linux 下的安装步骤 , 其它系统有桌面版不再赘述 。
如果你机器上有 Docker 仅需两步即可完成安装 。
第一步 , 安装 docker-compose:
1、下载
curl -L https://get.daocloud.io/docker/compose/releases/download/v2.4.1/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose2、加执行权限
$ sudo chmod +x /usr/local/bin/docker-compose3、创建快捷方式
$ sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose至此 , 你就可以在任何地方使用docker-compose 命令了 。
第二步 , 运行 docker-compose:
1、创建配置文件docker-compose.yml 内容如下:
整个项目分为数据库和项目代码两部分 , 与之对应的是pg 容器 和 wiki 容器 。

2、在配置所在的目录下 , 执行命令:
  • 运行:docker-compose up -d
  • 查看容器:docker ps
  • 停止:docker-compose down
最后 , 如果你想开启 HTTPS 的话 , 我这里推荐用 Caddy 服务器 。 没用过没关系 , 我们写过介绍使用 Caddy 的文章特别简单 。
Caddyfile 的配置内容如下:
8001 端口对应的是上面 wiki 容器的 ports 端口映射
域名 {reverse_proxy 127.0.0.1:8001执行caddy start 启动 Caddy 服务器 , 浏览器中访问对应的域名 , 网站初始化的引导界面 , 就会出现在你的面前了 。
至此 , 以上就是 wiki.js 安装的全过程 , 你跑起来了吗?
三、瑕不掩瑜Wiki.js 并不是十全十美的 , 虽然我也是刚上手 , 但还是发现了一些美中不足: