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

发布时间：2026-07-25阅读(1)

导读准备工作：1台虚拟机（我的是Centos7.7.1908）如果数据库和wiki系统分开部署需要准备多台，我这全部部署在1台机器上。软件版本要求：数据库：my....

准备工作：

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

////将密码先置空[root@wiki_js ~]# mysql -u root -pmysql> use mysql;mysql> UPDATE user SET authentication_string= WHERE user=root; //将密码置空////再修改数据库密码[root@wiki_js ~]# mysql -u root -pmysql> 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 -vv16.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：数据库名称

报错问题

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

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 GRANTmysql> Grant all privileges on *.* to root@%;Query OK, 0 rows affected (0.01 sec)

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