文章目录

前言
安装要求
- 服务器
- - CPU
  - 内存
  - 存储
  - 网络
- 域名
- 数据库
- Node.js
- 浏览器
环境准备
- Docker
- PostgreSQL部署
- Node.js安装
Wiki.js
- 部署
总结
- COMING SOON
- 文档搜索不支持中文
- 不支持匿名用户访问
- 开发人员数量可怜

前言

习惯的力量是很强大的。记得刚开始那会儿使用Markdown的时候各种变扭，可是输出的文档格式真心很整洁啊！时间一长，看着自己精心编写的文档复制粘贴到公司Wiki变成“扭曲”的形态，内心真是一忍再忍。最近几天一直在研究提升工作效率的事情，技术文档是其中很重要的一项，琢磨着自己动手吧，毕竟开源的力量也是很强大的。

通过Baidu、Google在各种项目之间徘徊，有的很长时间没有更新，有的功能太过简陋，纠结了很长时间，感兴趣的同学可以使用关键字“Wiki Markdown”自行搜索了解一下。无意间浏览到Wiki.js，打开官网的那一刻，瞬间被Wiki.js那华丽的页面吸引，如下图：

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-UFXnfSy0-1582188106366)(https://wiki.js.org/img/wiki-screenshot.3d2d7f34.png)]

详细阅读文档后，觉得基本可以满足需求，应该可以部署实际感受一下。考虑到依赖组件过多，特别是涉及Node.js、PostgreSQL的部分自己并不熟悉，决定详细记录一下“踩坑”的过程，供大家参考。

安装要求

服务器

CPU

2核或以上。

内存

1 GB或以上。

存储

1 GB或以上。

网络

自动更新需要公网权限，也可以使用离线更新。

域名

专用域名。

数据库

PostgreSQL 9.5或以上（推荐）。

Node.js

Node.js 10.12或者以上。

浏览器

支持多数浏览器，如：Google Chrome、Mozilla Firefox、Microsoft Edge、Apple Safari；IE11会有兼容性问题，可正常查看内容，编辑等交互性操作会受限。

环境准备

Docker

拉取CentOS 7基础镜像

docker pull centos:7.6.1810

启动容器实例

docker run -dit --net=host centos:7.6.1810 /bin/bash

注意： 网络模式选取为“host”，后文叙述时空口实例ID为cf3f3c09a488。

进入容器实例

docker exec -it cf3f3c09a488 /bin/bash

安装命令行工具

yum install wget sudo which rsync vim

PostgreSQL部署

安装

安装过程分为3步：安装Yum源、安装客户端，以及安装服务端。

yum install https://download.postgresql.org/pub/repos/yum/reporpms/EL-7-x86_64/pgdg-redhat-repo-latest.noarch.rpmyum install postgresql12yum install postgresql12-serveryum install postgresql12-contrib

初始化

mkdir -p /data0/pgsql
chown -R postgres:postgres /data0/pgsqlsudo -u postgres /usr/pgsql-12/bin/initdb -D /data0/pgsql

mkdir -p /var/log/pgsql
chown -R postgres:postgres /var/log/pgsql

启动/查看/停止

# 启动
sudo -u postgres /usr/pgsql-12/bin/pg_ctl -D /data0/pgsql -l /var/log/pgsql/server.log start# 查看
sudo -u postgres /usr/pgsql-12/bin/pg_ctl -D /data0/pgsql status# 停止
sudo -u postgres /usr/pgsql-12/bin/pg_ctl -D /data0/pgsql -m smart stop

创建用户/数据库/授权

sudo -u postgres psql# 创建用户
CREATE USER wikijs WITH PASSWORD 'wikijsrocks';# 创建数据库
CREATE DATABASE wiki OWNER wikijs;# 授权
GRANT ALL PRIVILEGES ON DATABASE wiki TO wikijs;

Node.js安装

下载安装包

cd /tmpwget https://nodejs.org/dist/v12.16.1/node-v12.16.1-linux-x64.tar.xz

解压安装包

tar xvf node-v12.16.1-linux-x64.tar.xz

安装

安装过程分为3步：移动安装包解压目录至/user/local、为node、npm建立软链接，以及删除安装包。

mv node-v12.16.1-linux-x64 /usr/local/ln -s /usr/local/node-v12.16.1-linux-x64/bin/node /usr/bin/node
ln -s /usr/local/node-v12.16.1-linux-x64/bin/npm /usr/bin/npmrm -rf rm -rf node-v12.16.1-linux-x64.tar.xz

Wiki.js

部署

下载安装包

cd /tmpwget https://github.com/Requarks/wiki/releases/download/2.1.113/wiki-js.tar.gz

解压/移动/删除安装包

# 解压
mkdir wikitar xzf wiki-js.tar.gz -C ./wiki# 移动
mv wiki /usr/local/# 删除
rm -rf wiki-js.tar.gz

配置

cd /usr/local/wiki# 重命名配置文件
mv config.sample.yml config.yml# 配置HTTP端口port: 3000# 配置数据库db:type: postgreshost: localhostport: 5432user: wikijspass: wikijsrocksdb: wiki# 配置存储目录dataPath: /data0/wiki

启动

cd /usr/local/wikinode server

等待，直至看到如下信息：

    Browse to http://localhost:3000/ to complete setup!

通过浏览器打开上述地址，按照提示输入以下信息：

    Administrator Email: ***Password: ***Confirm Passowrd: ***Site URL: ***

点击“INSTALL”，等待安装完成即可。

总结

Wiki.js整体功能还是很不错的，可定制的地方很多，除支持Markdow的在线编辑器之外，还提供丰富的后台管理功能，详细的内容可以参考官方文件，描述的还是比较清楚的。这里仅罗列几项我自己觉得不是很好的地方：

COMING SOON

“COMING SOON”，中文意思：“很快到来”。整体系统很多地方都有这个字眼，标识即将开放的功能，看着不是很舒服。

文档搜索不支持中文

即使使用官方推荐的数据库“PostgreSQL”，中文也是无法被支持的。这对于国内的用户来说几乎是灾难性的。Wiki.js本身还支持扩展连接多种搜索引擎，如：ElasticSearch，具体效果没有验证。

不支持匿名用户访问

用户必须登录系统才可以访问文档。

开发人员数量可怜

看Github项目统计，目前应该只有一人提供代码。

Wiki.js安装部署实操手册相关推荐

GBase 8c V5 主备式部署实操
GBase 8c V5 主备式部署实操一.前言二.环境准备三.集群安装四.数据库启停五.卸载六.连接和 SQL 测试一.前言 GBase 8c 是 GBASE公司(天津南大通用数据技术股 ...
【报告分享】见实私域流量白皮书：私域流量案例实操手册.pdf
大家好,我是文文(微信:sscbg2020),今天给大家分享见实科技于2020年10月份发布的报告<见实私域流量白皮书:私域流量案例实操手册.pdf>. 本报告共73页,包含如下鞋服.餐饮 ...
PCDN服务接入实操手册
摘要: 本文为阿里云P2P内容分发网络(PCDN)实操手册,可根据本文内容接入与操作.参考来源官网文档. 一. PCDN是定义? P2P 内容分发网络(英文名:P2P CDN,以下简称PCDN)是以P ...
重磅发布：《AI产品经理的实操手册（2023版）》
今天是咱们社群"AI产品经理大本营"六周年活动的最后一天,正式发布这份大家和我都非常期待的重磅干货--<AI产品经理的实操手册(2023版)> 上周发布的"A ...
Centos8安装mindoc实操
Centos8安装mindoc实操 Centos8环境准备 centos 安装说明 centos8系统安装: 配置yum 仓安装 vim.unzip 安装数据库安装步骤: mindoc 安装启动 ...
tengine简单安装_实操丨如何在EAIDK上部署Tengine开发AI应用之物体检测应用入门（C++）...
前言:近期推出的嵌入式AI系列直播公开课受到广大开发者的喜爱,并收到非常多的反馈信息,其中对如何在EAIDK上面部署Tengine开发AI应用感兴趣的开发者不在少数,我们将分2期以案例实操的形式详细介 ...
实操手册：如何在GKE上部署HTTP(S) Load Balancer及容器应用程式
Kubernetes(下文简称 k8s) 代表了 Google 的第三代容器管理系统,仅次于 Borg 和 Omega ,现在已经成为主要的容器平台.GKE 提供了了全套的 k8s 托管服务,将 Au ...
FISCO BCOS上使用第三方CA证书底层节点部署实操
CA证书怎么生成?节点相互验证证书时会交叉验证吗?对于社区常遇到的此类问题,分享一些个人使用第三方CA证书部署底层节点的经验,希望可以给大家一些借鉴与参考. 为什么要对第三方CA证书进行改造? 首先, ...
DolphinScheduler理论知识以及手机、邮箱、钉钉、电话等多种告警部署实操
1.DolphinScheduler简介 1.1.DolphinScheduler概述 Apache DolphinScheduler是一个新一代分布式.易扩展的可视化大数据工作流任务调度平台,致力于 ...

Wiki.js安装部署实操手册