安装&升级

鉴于用户频繁咨询“安装失败报错“、”版本更新”等问题，本指南特提供详细的“安装、更新步骤”及“常见问题”解决教程。

Windows一键安装

提示信息

新手推荐一键安装，快速体验系统功能，查看是否满足当前你的业务场景
账号密码：admin/111111

下载

一键安装

启动

一键安装

1、加入qq群：811189776
2、下载一键安装包：群文件/v4.6.0.zip
3、解压到d盘
4、启动图形化界面：小猫考试.exe
5、配置对外访问地址：192.168.0.86
5.1、如果是局域网，ip为本机局域网的ip，如：192.168.110.99
5.2、如果是互联网，ip为互联网ip或域名，如：47.92.221.134、www.myexam.com
6、服务端口允许对外：允许外网访问服务
7、数据库：启动
8、考试服务：启动
9、浏览器打开 http://192.168.0.86:8000
10、验证成功：输入账号密码登录（admin/111111）

Windows安装

注意事项

操作系统要求：win7、win10，win11、win2016
软件版本要求：jdk8、mysql5.7、maven3.8、node18

基础配置

1、选择：控制面板/Windows 防火墙/打开或关闭windows防火墙
2、选择：关闭Windows 防火墙(不推荐)
3、确定
4、配置ip地址：192.168.0.86
5、确定

jdk下载

1、浏览器打开 https://www.oracle.com/java/technologies/downloads/#java8
2、选择 Windows/jdk-8u431-windows-x64.zip/I reviewed.../Download jdk-8u431-windows-x64.zip
3、输入账号密码，点击下一步
4、下载完成

jdk安装

1、解压jdk到D:\soft\
2、打开 计算机/属性/高级系统设置/高级/环境变量/新建
3、配置JAVA_HOME=D:\soft\jdk1.8.0_431
4、追加PATH=%JAVA_HOME%/bin;
5、打开dos窗口，执行java -version
6、校验完成：显示jdk版本

mysql下载

1、浏览器打开 https://dev.mysql.com/downloads/mysql/
2、选择 Archives
3、选择 5.7.44/Microsoft Windows/Windows (x86, 64-bit)/Download
4、下载完成

mysql安装

1、解压mysql到D:\soft\
2、打开 计算机/属性/高级系统设置/高级/环境变量/新建
3、配置MYSQL_HOME=D:\soft\mysql-5.7.44-winx64
4、追加PATH=%MYSQL_HOME%/bin;
5、打开dos窗口
6、初始化data目录：mysqld --initialize
7、安装服务：mysqld -install MYSQL_EXAM
8、启动服务：net start MYSQL EXAM
9、打开文件：mysql-5.7.44-winx64/data/Win7-2021XTAINP.err
10、找到密码：[Note] A temporary password is generated for root@localhost: EUW:atN9sgLR
11、打开dos窗口
12、输入账号：mysql -uroot -p
13、输入密码：EUW:atN9sgLR
14、重置密码：alter user 'root'@'localhost' identified by 'root';
15、安装完成

maven下载

1、浏览器打开 https://maven.apache.org/download.cgi
2、点击 apache-maven-3.8.8-bin.zip
3、下载完成

maven安装

1、解压maven到D:\soft\
2、打开 计算机/属性/高级系统设置/高级/环境变量/新建
3、配置MVN_HOME=D:\soft\apache-maven-3.8.8
4、追加PATH=%MVN_HOME%/bin;
5、打开dos窗口，执行mvn -v
6、校验成功：显示mvn版本

node下载

1、浏览器打开 https://nodejs.org/zh-cn/download/prebuilt-binaries
2、选择 windows/x64/v18.20.4(LTS)/下载Node.js v18.20.4
3、下载完成

node安装

1、解压node到D:\soft\
2、打开 计算机/属性/高级系统设置/高级/环境变量/新建
3、配置NODE_HOME=D:\soft\node-v18.20.4-win-x64
4、追加PATH=%NODE_HOME;
5、配置NODE_SKIP_PLATFORM_CHECK=1
6、打开dos窗口，执行node -v
7、校验成功：显示node版本

HBuilderX下载

1、浏览器打开 https://www.dcloud.io/hbuilderx.html
2、点击 Download for Windows
3、下载完成

HBuilderX安装

1、解压HBuilderX到D:\soft\，并打开
2、浏览器打开 https://ext.dcloud.net.cn/plugin?id=5701
3、选择 下载插件并导入HBuilderX/是
4、校验成功：插件【dart-sass编译】安装成功！

wkhtmltopdf 下载

V5.1.0新增，支持试卷导出，可选

wkhtmltopdf下载

1、浏览器打开 https://wkhtmltopdf.org/downloads.html
2、点击 7z Archive (XP/2003 or later) 64-bit
3、下载完成

wkhtmltopdf安装

1、解压 wkhtmltox 到 D:\soft\
2、打开 计算机/属性/高级系统设置/高级/环境变量/新建
3、配置WK_HOME=D:\soft\wkhtmltox
4、追加PATH=%WK_HOME%/bin;
5、打开dos窗口，执行 wkhtmltopdf -V
6、校验完成：显示wkhtmltopdf版本

源码下载

1、浏览器打开 https://gitee.com/zhanghucheng/exam
2、选择 克隆/下载/下载ZIP
3、下载完成

后端程序启动

1、解压源码到D:\soft\
2、打开dos窗口
3、连接到mysql服务器：mysql -uroot -proot
4、创建exam库，指定编码为utf-8：create database exam default character set utf8 collate utf8_general_ci;
5、和服务端通信使用utf-8编码：set names utf8;
6、进入exam库：use exam;
7、导入初始脚本：source D:\soft\exam-master\db\mysql\4.6.0.sql
8、打开dos窗口
9、切换到后端目录：cd ./src
10、打包（使用国内镜像）：mvn clean package
11、切换到打包文件目录：cd ./sys-web/target/
12、启动程序：java -jar exam-4.6.0.jar
13、校验成功：启动端口8000，启动时间：12.526秒

PC端程序启动

1、打开dos窗口
2、切换到h5目录：cd h5
3、npm使用国内镜像源：npm config set registry https://registry.npmmirror.com/
4、npm安装：npm install
5、pc端打包：npm run build
6、复制h5/dist到src/sys-web/target/下，并重命名为h5（后端集成了PC端无须nginx）
7、编辑src/sys-web/target/h5/config.js，修改ip为对外ip
8、保存配置
9、浏览器打开 http://192.168.0.86:8000
10、校验成功：输入账号密码登录（admin/111111）

移动端程序启动

1、拖拽m文件夹到HBuilderX
2、HBuilderX菜单栏选择 发行(U)/网站-PC Web或手机H5(仅适用于uni-app)(H)/发行(P)
3、输入账号密码，点击登录
4、复制 m\unpackage\dist\build\web到src/sys-web/target/下，并重命名为m（后端集成了移动端无须nginx）
5、编辑src/sys-web/target/m/static/config.js，修改ip为对外ip
6、保存配置
7、浏览器打开，按F12打开调试模式，选择响应式设计模式（移动端模式）
8、浏览器输入 http://192.168.0.86:8000
9、校验成功：考试用户账号密码登录，暂不支持管理员登录。

Linux安装

注意事项

操作系统要求：CentOS7.9
软件版本要求：jdk8、mysql5.7、maven3.8、node18
源码编译打包参考windows安装，这里不在赘述

基础配置

1、登录账号：root
2、输入密码：root
3、进入ip配置目录：cd /etc/sysconfig/network-scripts/
4、查看哪个是网卡：ls
5、编辑网卡：vi ifcfg-ens33
6、进入编辑模式：i
7、使用静态分配ip方式：BO0TPROT0=static
8、开机激活网卡：ONBOOT=yes
9、添加ip地址：IPADDR=192.168.0.84
10、添加子网掩码：NETMASK=255.255.255.0
11、添加网关：GETEHAY=192.168.0.1
12、添加dns服务器：DNS1=192.168.0.1
13、退出编辑模式：Esc
14、保存并退出：:wq
15、网卡配置即时生效：service network restart
16、添加普通用户：adduser xiaomao
17、设置密码：passwd xiaomao
18、输入密码：kaoshi
19、再次输入密码：kaoshi

jdk下载

参考jdk下载

1、浏览器打开 https://www.oracle.com/java/technologies/downloads/#java8
2、选择 Linux/jdk-8u431-linux-x64.tar.gz/I reviewed.../Download jdk-8u431-linux-x64.tar.gz
3、输入账号密码
4、下载完成
5、拷贝到/home/xiaomao

jdk安装

1、连接服务器：ssh 192.168.0.84
2、输入账号：xiaomao
3、输入密码：kaoshi
4、登录成功
5、创建soft目录：mkdir soft
6、解压jdk到soft下：tar -zxf ./jdk-8u431-linux-x64.tar.gz -C ./soft/
7、编辑环境变量：vi ./.bashrc
8、进入编辑模式：i
9、配置环境变量：JAVA_HOME=/home/xiaomao/soft/jdk1.8.0_431
10、配置环境变量：PATH=$JAVA_HOME/bin:$PATH
11、退出编辑模式：Esc
12、保存并退出：:wq
13、配置即时生效：source ./.bashrc
14、查看版本：java -version
14、验证成功：显示版本

mysql下载

参考mysql下载

1、浏览器打开 https://dev.mysql.com/downloads/mysql/
2、选择 Archives
3、选择 5.7.44/Linux - Generic/Linux - Generic (glibc 2.12) (x86, 64-bit)/Download
4、下载完成

mysql安装

1、检查是否已安装mysql（分支mariadb）：rpm -qa|grep mariadb
2、切换root账号：su root
3、输入密码：root
4、移除依赖：yum -y remove mariadb*
5、检查是否已安装mysql：rpm -qa|grep -i mysql
6、如果有则删除
7、全局查找mysql遗留文件：find / -name mysql
8、如果有则删除：rm -rf /usr/lib64/mysql/
9、全局查找配置文件：find / -name my.cnf
10、如果有则删除
11、解压mysql到/usr/local：tar -zxf mysql-5.7.44-linux-glibc2.12-x86_64.tar.gz -C /usr/local/
12、进入/usr/local目录下：cd /usr/local/
13、重命名为mysql：mv mysql-5.7.44-linux-glibc2.12-x86_64/ mysql
14、进入mysql目录：cd mysql/
15、新建data文件夹：mkdir data
16、添加mysql用户组：groupadd mysql
17、添加mysql用户：useradd -r -s /sbin/nologin -g mysql mysql -d /usr/local/mysql/
18、改变文件所有者为mysql：chown -R mysql:mysql /usr/local/mysql/
19、初始化库：./bin/mysqld --user=mysql --basedir=/usr/local/mysql/ --datadir=/usr/local/mysql/data/ --initialize
20、复制mysql.server到系统服务目录，并重命名：cp -a ./support-files/mysql.server /etc/init.d/mysqld
21、启动服务：service mysqld start
22、连接mysql：./bin/mysql -uroot -p
23、输入密码（从日志找[Note] A temporary password is generated for root@localhost: aiK*oTeB-3;=）：aiK*oTeB-3;=
24、重置密码为root：set password for 'root'@localhost=password('root');
25、退出mysql：quit
26、编辑全局环境变量：vi /etc/profile
27、进入编辑模式：i
28、最下一行添加环境变量：export PATH=$PATH:/usr/local/mysql/bin
29、退出编辑模式：Esc
30、保存并退出：:wq
31、配置即时生效：source /etc/profile
32、拥有执行权限：chmod +x /etc/init.d/mysqld
33、加入开机启动项：chkconfig --add mysqld
34、退出root账号：exit

wkhtmltopdf下载

V5.1.0新增，支持试卷导出，可选

参考wkhtmltopdf下载

1、浏览器打开 https://wkhtmltopdf.org/downloads.html
2、点击 CentOS 	7 	x86_64
3、下载完成

wkhtmltopdf安装

1、切换root账号：su root
2、输入密码：root
3、安装依赖：yum install -y fontconfig libX11 libXext libXrender xorg-x11-fonts-75dpi xorg-x11-fonts-Type1 libjpeg
4、安装wkhtmltox：rpm -ivh /home/xiaomao/wkhtmltox-0.12.6-1.centos7.x86_64.rpm
5、复制win电脑"C:\Windows\Fonts\黑体 常规"，拷贝到 "/home/xiaomao"
6、添加字体：mv /home/xiaomao/simhei.ttf /usr/share/fonts/dejavu
7、退出root账号：exit

程序启动

1、上传src/sys-web/target/config到/home/xiaomao/exam-server/下
2、上传src/sys-web/target/h5到/home/xiaomao/exam-server/下
3、上传src/sys-web/target/m到/home/xiaomao/exam-server/下
4、上传db/mysql/4.6.0到/home/xiaomao/exam-server/下
5、重新加载系统配置文件：source /etc/profile
6、连接mysql服务端：mysql -uroot -p
7、输入密码：root
8、创建库exam，缺省字符集utf-8：create database exam default character set utf8 collate utf8_general_ci;
9、设置客户端和服务端通信使用utf-8编码：set names utf8;
10、进入exam库：use exam;
11、导入初始脚本：source /home/xiaomao/exam-master/db/mysql/4.6.0.sql
12、退出mysql：exit
13、切换root账号：su root
14、输入密码：root
15、防火墙允许8000端口对外：firewall-cmd --permanent --zone=public --add-port=8000/tcp
16、立即生效：firewall-cmd --reload
17、退出root账号：exit
18、进入程序目录：cd ./exam-server/
19、编辑pc端配置文件：vi ./h5/config.js
20、配置url指向后端地址：url: 'http://192.168.0.84:8000/api/'
21、保存并退出
22、编辑移动端配置文件：vi ./m/static/config.js
23、配置url指向后端地址：BASE_URL: 'http://192.168.0.84:8000/api/'
24、保存并退出
25、启动程序：java -jar exam-4.6.0.jar
26、浏览器打开 http://192.168.0.84:8000
27、校验成功：输入账号密码登录（admin/111111）
28、按F12打开调试模式，选择响应式设计模式（移动端模式）
29、浏览器输入 http://192.168.0.84:8000 回车
30、校验成功：考试用户账号密码登录，暂不支持管理员登录。

版本升级

提示信息

最新版本程序在：https://gitee.com/zhanghucheng/exam

数据库脚本在db/mysql/下，命名规则：
a.b.c.sql
a：大版本，不同的a之间不兼容。如3.9.3不兼容4.0.0。
b：a的小版本，升级下一版需b+1。如4.5.0.sql - 4.6.0.sql，表示4.5.0版本升到4.6.0版本。
c：b的bug修复版本，不做字段变更，一般只是添加版本信息。如4.4.1 - 4.4.2.sql，可以不用。

版本升级

1、停止后端服务
2、后端、pc端、移动端编译打包后替换旧文件。配置文件不要替换，否则需要重配，如ip。
3、按需使用升级脚本，不要跨版本更新。
如：当前版本为4.4.0，需要升级到4.6.0，需要4.4.0.sql - 4.5.0.sql，4.5.0.sql - 4.6.0.sql。
4、启动后端服务
5、完成

示例：win系统5.2.0版升级到5.4.0

cmd

[程序根目录]
├── xmky-exam-5.2.0.jar
├── config/
    ├── application.yml
    ├── logo.png
├── h5/                 
    ├── assets
    ├── img
    ├── config.js       
    ├── index.html      
└── m/                  
    ├── assets   
    └── static/
        └── config.js   
    ├── uni_modules   
    ├── index.html      

1、关闭java后台服务
2、打开dos窗口
3、备份考试库5.2.0：mysqldump -uroot -proot xmky_exam > D:\xmky_exam-5.2.0-bak.sql
4、升级考试库到5.3.0：mysql -uroot -proot xmky_exam < D:\soft\exam-master\db\mysql\5.2.0 - 5.3.0.sql
5、升级考试库到5.4.0：mysql -uroot -proot xmky_exam < D:\soft\exam-master\db\mysql\5.3.0 - 5.4.0.sql
6、前后端编译打包替换旧文件
7、后台更新配置文件：./config/application.yml （最好重新配置，因为新增的属性在旧版本不存在，会导致报错）
8、PC端更新配置文件：./h5/config.js （或者直接使用5.2.0版本的./h5/config.js覆盖）
9、移动端更新配置文件：./m/static/config.js （或者直接使用5.2.0版本的./m/static/config.js覆盖）
10、启动java后台服务：java -jar xmky-exam-5.4.0.jar

常见问题

请点这里

安装&升级 ​

Windows一键安装 ​

下载 ​

启动 ​

Windows安装 ​

基础配置 ​

jdk下载 ​

jdk安装 ​

mysql下载 ​

mysql安装 ​

maven下载 ​

maven安装 ​

node下载 ​

node安装 ​

HBuilderX下载 ​

HBuilderX安装 ​

wkhtmltopdf 下载 ​

wkhtmltopdf安装 ​

源码下载 ​

后端程序启动 ​

PC端程序启动 ​

移动端程序启动 ​

Linux安装 ​

基础配置 ​

jdk下载 ​

jdk安装 ​

mysql下载 ​

mysql安装 ​

wkhtmltopdf下载 ​

wkhtmltopdf安装 ​

程序启动 ​

版本升级 ​

常见问题 ​

安装&升级

Windows一键安装

下载

启动

Windows安装

基础配置

jdk下载

jdk安装

mysql下载

mysql安装

maven下载

maven安装

node下载

node安装

HBuilderX下载

HBuilderX安装

wkhtmltopdf 下载

wkhtmltopdf安装

源码下载

后端程序启动

PC端程序启动

移动端程序启动

Linux安装

基础配置

jdk下载

jdk安装

mysql下载

mysql安装

wkhtmltopdf下载

wkhtmltopdf安装

程序启动

版本升级

常见问题