1 需求
- 搭建一个共享的私有Wiki
2 现状
- Ubuntu22实体服务器
- Mysql5.7
3 解决方案
采用开源的Wiki系统进行搭建，比较出名的是Wikijs，它支持多种数据库PostgreSQL / MySQL / MariaDB / MS SQL Server / SQLite，经过考虑用Mysql。
优点：维护的活跃程度高，功能强大
缺点：需要Mysql8+
4 实施方案
Mysql8x和Mysql5的共存安装没经验，可能会出现配置冲突问题。解决方案是通过Docker安装Mysql8，实现共存。
4.1 Ubuntu22的中安装Mysql Docker
（1）查看ubuntu 版本信息更新系统
更新系统
sudo apt update
sudo apt list --upgradeable
sudo apt upgrade -y
查看最新系统信息
cat /etc/os-release
lsb_release -a
（2）安装Docker
curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun
查看Docker运行状态
sudo systemctl status docker
看到如下状态则证明安装成功
（3）配置Docker
Docker 镜像加速
国内从 DockerHub 拉取镜像有时会遇到困难，此时可以配置镜像加速器。Docker 官方和国内很多云服务商都提供了国内加速器服务，例如：
科大镜像：https://docker.mirrors.ustc.edu.cn/
网易：https://hub-mirror.c.163.com/
阿里云：https://<你的ID>.mirror.aliyuncs.com
七牛云加速器：https://reg-mirror.qiniu.com
Docker中国区官方镜像：https://registry.docker-cn.com
网易：http://hub-mirror.c.163.com
USTC 中国科技大学：https://docker.mirrors.ustc.edu.cn
sudo vim /etc/docker/daemon.json
加入如下信息
{
"registry-mirrors": [
"https://registry.docker-cn.com",
"http://hub-mirror.c.163.com",
"https://docker.mirrors.ustc.edu.cn"
]
}
查看是否生效
docker info
看到如下消息则生效
（4）安装Mysql8x
docker pull mysql
查看镜像文件的相关信息
docker inspect mysql
（5）启动Mysql实例
Mysql实例重启后数据和配置文件都会丢失，所以需要通过虚拟目录的方式进行保存，在启动的时候进行参数配置。首先启动一个简单的实例，看看配置文件具体在哪，每个系统的配置文件位置可能不一样。
docker run -itd -P -e MYSQL_ROOT_PASSWORD=root mysql
查看实例启动情况
docker ps
如果出错则先查看错误日志
docker logs 1b78ca228ac3
进入Mysql8实例查看
docker exec -it 1b78ca228ac3 /bin/bash
cd /etc
ls
同理也能找到数据文件所在的地方
cd /var/lib/mysql
本文有一个需求，就是Wiki上传的数据文件比较大，超过了Mysql8默认的大小，需求进行配置，我们在系统中先构造出my.cnf，将max_allowed_packet上限设置为1Gb。我们创建数据文件和配置文件目录
mkdir /home/dev/wiki-data/docker-mysql
mkdir /home/dev/wiki-data/docker-mysqld-cnf
cd /home/dev/wiki-data/docker-mysqld-cnf
vim my.cnf
输入Docker实例中/etc/my.cnf内容，并在[mysqld]下新增字段max_allowed_packet
# For advice on how to change settings please see
# http://dev.mysql.com/doc/refman/8.0/en/server-configuration-defaults.html
[mysqld]
#
# Remove leading # and set to the amount of RAM for the most important data
# cache in MySQL. Start at 70% of total RAM for dedicated server, else 10%.
# innodb_buffer_pool_size = 128M
#
# Remove leading # to turn on a very important data integrity option: logging
# changes to the binary log between backups.
# log_bin
#
# Remove leading # to set options mainly useful for reporting servers.
# The server defaults are faster for transactions and fast SELECTs.
# Adjust sizes as needed, experiment to find the optimal values.
# join_buffer_size = 128M
# sort_buffer_size = 2M
# read_rnd_buffer_size = 2M
max_allowed_packet=1024M
# Remove leading # to revert to previous value for default_authentication_plugin,
# this will increase compatibility with older clients. For background, see:
# https://dev.mysql.com/doc/refman/8.0/en/server-system-variables.html#sysvar_default_authentication_plugin
# default-authentication-plugin=mysql_native_password
skip-host-cache
skip-name-resolve
datadir=/var/lib/mysql
socket=/var/run/mysqld/mysqld.sock
secure-file-priv=/var/lib/mysql-files
user=mysql
pid-file=/var/run/mysqld/mysqld.pid
[client]
socket=/var/run/mysqld/mysqld.sock
!includedir /etc/mysql/conf.d/
关闭上次启动的实例
docker stop 1b78ca228ac3
再次创建新实例
docker run -itd -p 26666:3306 -P -v /home/dev/wiki-data/docker-mysql:/var/lib/mysql -v /home/dev/wiki-data/docker-mysqld-cnf/my.cnf:/etc/my.cnf -e MYSQL_ROOT_PASSWORD=root mysql
访问Mysql实例
mysql -h172.17.0.1 -uroot -p -P26666
看到如下内容则成功进入实例
创建数据库、账户和授权
create database wiki character SET utf8 COLLATE utf8_bin; //创建Wiki对应数据库并授权
SET GLOBAL transaction_isolation='READ-COMMITTED'; //设置mysql隔离级别
create user 'wikijs'@'%' identified by 'wikijsrocks';
GRANT ALL PRIVILEGES ON wiki.* TO 'wikijs'@'%' WITH GRANT OPTION;
FLUSH PRIVILEGES;
重启Mysql8实例，检查数据是和否持久化
（6）实例自动重启
为应对系统重启和其他灾害导致的实例挂了的情况，可以做一个简单的脚本做重启任务
#!/bin/bash
sm=`ps -fe |grep "-host-port 26666" |grep -v "grep" |wc -l`
if [ $sm -eq 0 ]; then
echo "start to run mysql8."
docker run -itd -p 26666:3306 -P -v /home/dev/wiki-data/docker-mysql:/var/lib/mysql -v /home/dev/wiki-data/docker-mysqld-cnf/my.cnf:/etc/my.cnf -e MYSQL_ROOT_PASSWORD=root mysql
else
echo "mysql8 is already running!"
fi
（7）数据备份
为防止数据丢失，可以做一个简单的数据备份，定时备份
login_user="root" #数据库登录账户
login_passwd="root" #数据库登录密码
vDate=`date +%Y%m%d` #当前日期，用作目录名
backup_dir="/home/dev/wiki-data/"$vDate"/" #配置备份文件保存的目录
echo $backup_dir
if [ ! -d $backup_dir ];then
mkdir -p $backup_dir
fi
# 将需要备份的数据放入
mysqldump -h172.17.0.1 -P26666 -u$login_user -p$login_passwd wiki > $backup_dir$vDate.sql
# 删除7天前备份的文件
find backup_dir -atime +7 -name "*.sql" -exec rm -rf {} \
echo "备份结束"
# 如果遇到unexpected end of file，使用vim打开文件后，输入“:set ff”，如果看到结果为dos，则文件编码不正确
# 需要输入“:set ff=unix”进行修复
至此，数据库创建完成。
4.2 安装Wikijs
（1）下载Wikijs
Wikijs为开源项目，在定制化要求不高的情况下，可以考虑直接用它的release版本：
下载release包
wget https://github.com/requarks/wiki/releases/download/v2.5.291/wiki-js.tar.gz
tar -zxvf wiki-js.tar.gz
这里要进行数据库和存储文件配置，这里只需要修改根目录下的config.yml就行了
配置Mysql参数
type: mysql
host: localhost #Mysql所在服务器地址
port: 3306 #Mysql所在服务器地址
user: wikijs #在Mysql中创建的wiki的登陆用户名
pass: wikijsrocks #在Mysql中创建的wiki的登陆用户名密码
db: wiki #在Mysql中创建的wiki的数据库名称
配置文件保存地址，默认放到安装包的根目录data文件夹内
dataPath: ./data
（2）配置Nginx
Nginx的配置这里不具体展开，具体安装过程参考基于CentOS 8搭建Nginx服务器(https://blog.csdn.net/huiskai/article/details/111302936)，这里需要重点注意的是，对于有大文件上传下载需求的，需要修改nginx的最大数据包限制。
在http下面加上如下参数，从而将最大数据包限制提高到1Gb
client_max_body_size 1024m;
为了防止超时，需要加一下超时参数，这里配置server的超时参数
proxy_send_timeout 300;
proxy_read_timeout 300;
proxy_connect_timeout 300;
如下
（3）安装Nodejs
Wikijs为node作为后端，需要安装nodejs，这里不展开详细介绍怎么安装nodejs，具体可以参考这篇文章Ubuntu20安装最新nodejs(https://blog.csdn.net/huiskai/article/details/116109255)。
（4）启动服务
根据项目说明文档提示，进入根目录后直接运行命令
npm run start
打开http://localhost:3000
进入配置页面，Enjoy！
Wikijs文档齐全，功能强大，涉及到用户管理、权限管理、文档管理等，各位大佬可以根据需要进行配置。
参考资料
- ubuntu 安装docker mysql 8.0.28
- 虚拟机中docker安装mysql远程无法访问解决方法
- 怎么在Docker中部署MySQL并实现数据持久化
- 在UBUNTU上自动备份MYSQL
- 在Ubuntu/Linux中自动备份MySQL数据库
- Nginx 配置之解决 413 错误（Request Entity Too Large）
- NGINX 报错 413 Request Entity Too Large 解决方案
- Nginx 出现504 Gateway Time-out的解决方法
- Ubuntu 22.04安装、配置和删除MySQL 8
- Got a packet bigger than ‘max_allowed_packet’ bytes？问题解决
5774
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
