本安装教程基于 Ubuntu 系统,但适用于其它绝大部分 Linux 发行版。
系统要求
- 操作系统:Linux
- 内存大小:2G+(建议 4G)
- 磁盘容量:无要求(根据你的存储需求来选择)
- 控制面板:宝塔 Linux 面板
实验环境
- 操作系统:Ubuntu 22.04 LTS x86_64
- 内存大小:4G
- 磁盘容量:10G
- 宝塔面板:免费版 7.9.2
安装文件下载
在novel-plus
的发行页面https://github.com/201206030/novel-plus/releases
(包含 novel-plus 所有版本的安装文件),找到你想要安装的版本(例如 3.6.1),下载sql.zip
、novel-crawl.zip
、novel-front.zip
和novel-admin.zip
文件到本地机器上:
有些版本只有部分文件,例如 3.6.2 版本只有 novel-crawl.zip ,这是由于相较于上个版本(3.6.1)只有爬虫程序更新过,去上个版本下载其他 zip 文件即可。
MySQL 安装
MySQL 5.7 或以上版本均可,建议安装 8.0。
- 进入宝塔面板的软件商店搜索 MySQL 安装(如已安装 MySQL,可省略此步骤),如下所示:
根据你的服务器环境,安装 MySQL 大约在几分钟到几十分钟不等。
- MySQL 安装成功后,进入宝塔面板的数据库菜单添加
novel_plus
数据库,选择编码utf8mb4
,如下所示:
添加完成后的效果如下所示:
- 解压缩本地机器上下载的
sql.zip
,导入里面的novel_plus.sql
文件到我们创建的novel_plus
数据库中,如下所示:
Redis 安装
仅在 4.0.0 版本后需要安装 Redis。
JDK 安装
之前在 CentOS 系统中可以通过安装 Tomcat8 的方式来安装 JDK8,如下所示:
在 Ubuntu 22.04 系统中通过以上方法安装 JDK8 失败。我们可以打开终端,通过执行命令java -version
来验证,如下所示:
上图要求输入的账号密码是服务器 SSH 登录的账号密码,而不是宝塔面板的账号密码。
从上图可以看出执行命令java -version
后提示java 命令不存在
,说明 JDK 安装失败。
如果通过安装 Tomcat8 的方式安装 JDK 失败,我们可以打开终端,通过执行如下命令来安装 JDK8:
基于 RHEL 的 Linux 系统(例如 CentOS):sudo yum install java-1.8.0-openjdk -y
Debian 或 Ubuntu 系统:sudo apt-get install openjdk-8-jdk -y
其它 Linux 系统:自行百度或谷歌XX 系统安装 JDK8
即可,例如:Ubuntu 安装 JDK8
上图要求输入的密码是服务器的登录密码不要输成宝塔面板的登录密码了。
安装完成后通过执行验证命令java -version
,可以看到 JDK 的信息:
创建 novel-plus 安装目录
- 点击宝塔面板的文件菜单(默认进入
/www/wwwroot
目录下),新建子目录novel-plus
(也可以是其它命名),如下所示:
- 进入
novel-plus
目录,创建novel-crawl
、novel-front
和novel-admin
子目录(也可以是其它命名),如下所示:
爬虫程序安装
- 进入
novel-crawl
子目录下,上传本地机器上下载的novel-crawl.zip
文件到服务器,并解压,如下所示:
解压后的目录结构如下:
- 进入数据库菜单,点击复制按钮复制刚刚创建的数据库密码,如下所示:
- 进入
config
子目录,修改application-commom-prod.yml
文件中的数据库配置和登录账号配置,如下所示:
修改完配置后,一定要点击左上角的保存按钮保存,如下所示:
- 根据需要设置爬虫的代理IP
👉 查看如何设置
- 返回
novel-crawl
目录,打开novel-crawl
目录下的终端,执行sudo bin/novel-crawl.sh start
命令启动爬虫程序:
- 进入安全菜单,放行
8083
端口,如下所示:
- 浏览器输入
服务器IP:8083
后回车访问爬虫系统,如下所示:
打开
novel-crawl
目录下的终端,执行sudo bin/novel-crawl.sh stop
命令停止爬虫程序打开
novel-crawl
目录下的终端,执行sudo bin/novel-crawl.sh restart
命令重启爬虫程序打开
novel-crawl
目录下的终端,执行sudo bin/novel-crawl.sh status
命令查看爬虫程序运行状态
前台程序安装
- 进入
novel-front
子目录下,上传本地机器上下载的novel-front.zip
文件到服务器并解压,参考爬虫程序的上传和解压,解压后的目录结构如下:
- 进入
config
子目录,修改application-commom-prod.yml
文件中的数据库配置(与爬虫程序的数据库配置修改相同),如下所示:
修改完配置后,一定要记得点击左上角的保存按钮保存。
- 返回
novel-front
目录,打开novel-front
目录下的终端,执行sudo bin/novel-front.sh start
命令启动前台程序:
- 进入安全菜单,放行
8085
端口,如下所示:
浏览器
8085
端口访问小说前台打开
novel-front
目录下的终端,执行sudo bin/novel-front.sh stop
命令停止前台程序打开
novel-front
目录下的终端,执行sudo bin/novel-front.sh restart
命令重启前台程序打开
novel-front
目录下的终端,执行sudo bin/novel-front.sh status
命令查看前台运行状态
后台程序安装
进入
novel-admin
子目录下,上传本地机器上下载的novel-admin.zip
文件到服务器并解压,参考爬虫程序的上传和解压进入
config
子目录,修改application-prod.yml
文件中的数据库配置(与爬虫程序的数据库配置修改相同),如下所示:
修改完配置后,一定要记得点击左上角的保存按钮保存。
- 返回
novel-admin
目录,打开novel-admin
目录下的终端,执行sudo bin/novel-admin.sh start
命令启动后台程序:
进入安全菜单,放行
8088
端口浏览器
8088
端口访问小说后台打开
novel-admin
目录下的终端,执行sudo bin/novel-admin.sh stop
命令停止后台程序打开
novel-admin
目录下的终端,执行sudo bin/novel-admin.sh restart
命令重启后台程序打开
novel-admin
目录下的终端,执行sudo bin/novel-admin.sh status
命令查看后台运行状态
部分环境(如新版 macOS 系统)获取不到主机 IP,需要手动修改 hosts 文件,增加 IP-主机名(通过 hostname 命令查看主机名)的映射。
1 | [root@iZwz9e2l6djkn7vw4xvic9Z ~]# hostname |
正确配置:
1 | 172.18.5.192 iZwz9e2l6djkn7vw4xvic9Z iZwz9e2l6djkn7vw4xvic9Z |
错误配置:
1 | 127.0.0.1 iZwz9e2l6djkn7vw4xvic9Z iZwz9e2l6djkn7vw4xvic9Z |
4.0.0 版本后需要安装和配置 Redis。