本地接口文档管理工具（轻量级Wiki文档管理系统部署）

准备工作：

1台虚拟机（我的是 Centos 7.7.1908）

如果数据库和wiki系统分开部署需要准备多台，我这全部部署在1台机器上。

软件版本要求：

数据库：mysql 8.0.28

MySQL 8.0 或更高版本（部分支持MySQL 5.7.8） MariaDB 10.2.7 或更高版本 MS SQL Server 2012 或更高版本 SQLite 3.9 或更高版本

Node.js：v16.14.2

Node.js 10：版本10.12或更高版本。 Node.js 12：版本12.0或更高版本。 Node.js 14：版本14.0或更高版本。 Node.js 16：版本16.0或更高版本。

Wiki.js：2.5.277

数据库安装

[root@wiki_js ~]# wget https://dev.mysql.com/get/mysql80-community-release-el7-5.noarch.rpm [root@wiki_js ~]# rpm -ivh mysql80-community-release-el7-5.noarch.rpm [root@wiki_js ~]# yum install mysql -y [root@wiki_js ~]# yum -y install mysql-community-server [root@wiki_js ~]# mysql --version //查看数据库版本

如果mysql密码忘记了，进入my.cnf 文件将 skip-Grant-tables 插入到最后，保存重启服务。

[root@wiki_js ~]# vim /etc/my.cnf [root@wiki_js ~]# systemctl restart mysqld

本地接口文档管理工具（轻量级Wiki文档管理系统部署）(1)

////将密码先置空 [root@wiki_js ~]# mysql -u root -p mysql> use mysql; mysql> UPDATE user SET authentication_string='' WHERE user='root'; //将密码置空 ////再修改数据库密码 [root@wiki_js ~]# mysql -u root -p mysql> ALTER USER 'root'@'localhost' IDENTIFIED BY 'ZAQ!xsw2CDE#'; Query OK, 0 rows affected (0.00 sec) ////此时已经重置了mysql密码

Node.js安装

● 下载安装包

[root@wiki_js ~]# https://nodejs.org/dist/v16.14.2/node-v16.14.2-linux-x64.tar.xz

● 解压安装包

[root@wiki_js ~]# xz -d -k node-v16.14.2-linux-x64.tar.xz //解压xz格式压缩包，-k表示不删除原始压缩包 [root@wiki_js ~]# tar -xvf node-v16.14.2-linux-x64.tar //解压tar格式压缩包 [root@wiki_js bin]# cd node-v16.14.2-linux-x64/bin //进入解压的路径

做软链使命令全局可用 node 目录写自己对应的目录

[root@wiki_js bin]# ln -s /root/node-v16.14.2-linux-x64/bin/node /usr/bin/node [root@wiki_js bin]# ln -s /root/node-v16.14.2-linux-x64/bin/npm /usr/bin/npm [root@wiki_js bin]# ln -s /root/node-v16.14.2-linux-x64/bin/npx /usr/bin/npx

做完软链后随便哪个目录使用 node -v 查看当前的版本

[root@wiki_js bin]# node -v v16.14.2

Wiki.js下载

[root@wiki_js opt]# wget https://github.com/Requarks/wiki/releases/latest/download/wiki-js.tar.gz [root@wiki_js opt]# mkdir wiki //创建wiki目录 [root@wiki_js opt]# tar zxf wiki-js.tar.gz -C ./wiki // 解压 [root@wiki_js opt]# cd ./wiki [root@wiki_js opt]# mv config.sample.yml config.yml // 将示例配置文件重命名为config.yml [root@wiki_js opt]# vim config.yml // 修改配置文件

默认使用postgre数据库。我这里使用的是mysql，所以改成mysql数据库

type：数据库

host：数据库IP，我这里全部安装在同一台机器，所以使用localhost

user：数据库账号

pass：数据库密码

db：数据库名称

本地接口文档管理工具（轻量级Wiki文档管理系统部署）(2)

报错问题

报错1：如果数据库出现以下错误，请参考解决mysql8报错：ERROR 1410 (42000): You are not allowed to create a user with GRANT_很迷眼的博客-CSDN博客

本地接口文档管理工具（轻量级Wiki文档管理系统部署）(3)

mysql> update user set host='%' where user='root'; Query OK, 1 row affected (0.01 sec) Rows matched: 1 Changed: 1 Warnings: 0

////连续敲2次这个命令，第1次会报错 mysql> Grant all privileges on *.* to 'root'@'%'; ERROR 1410 (42000): You are not allowed to create a user with GRANT mysql> Grant all privileges on *.* to 'root'@'%'; Query OK, 0 rows affected (0.01 sec)

报错2：出现这个报错是因为没有数据库，手动添加一个数据库即可正常运行。

本地接口文档管理工具（轻量级Wiki文档管理系统部署）(4)