一、Hexo Boot

Hexo Boot 是基于 Spring Boot + MySQL 开发的一套开源的博客系统。前身是 ml-blog 博客系统,在此基础上演变和扩展而来。

二、扩展功能

Hexo Boot 博客系统除了继承 ml-blog 博客系统的文章管理、分类管理、系统参数设置等功能外,还扩展了以下功能。

2.1 评论、留言功能

1
轻松查看网友的评论与留言,及时互动

2.2 友链功能

1
与网友互换主页,友好分享

2.3 主题功能

1
支持前端页面主题动态变换以及在线编辑源码,让页面色彩丰富起来,同时支持自定义主题

2.4 黑名单功能

1
设置 ip 黑名单,防御网络小人恶意攻击系统

2.5 附件功能

1
支持本地、七牛云、OSS 3种附件管理

2.6 备份功能

1
支持自动和手动备份SQL数据,防患数据丢失

2.7 音乐播放

1
支持音乐配置管理以及在线播放,切换页面不中断

2.8 默认主题特色

1
2
3
4
5
6
7
8
9
10
支持 CDN 配置
图片延迟加载
图片灯箱
夜间模式
音乐播放
打赏功能
点赞功能
评论功能(支持两种:默认和Twikoo)
文章布局(支持两种:卡片和列表)
实现 pjax

更多详情请访问下边提供的网址进行浏览。

三、预览效果

网站演示1(默认主题)

网站演示2(默认主题)

网站演示3(私人订制)

3.1 后台管理预览图

3.2 前端预览图(默认主题)

四、启动与部署

4.1 启动

下载源码,通过 Idea 工具打开项目,修改 resources 目录下的 application.yml 中的数据库配置(用户名和密码),运行项目即可。

前端主页访问地址:

1
http://127.0.0.1:8080

后端管理访问地址

1
http://127.0.0.1:8080/admin/login.html

首次打开登录界面,会出现系统安装页面,用户名和密码由使用者填写控制

4.2 部署

该项目支持 war 包和 jar 包两种方式运行

4.2.1 war 包形式

1.修改 pom.xml 文件的 2 处地方:

1
2
3
将 <packaging>war</packaging> 注释放开

排除 spring-boot-starter-web 的内置 tomcat

2.mvn clean package,打出名为 ROOT.war 文件,将其上传至 tomcat 的 webapps 目录下(如已有 ROOT 文件,将其删掉),启动 tomcat 即可

4.2.2 jar 包形式

1.创建博客配置文件夹 mkdir ~/.hexo-boot

2.mvn clean package,打出 jar 包后上传至 ~/.hexo-boot

3.将 application.yml 文件上传至 ~/.hexo-boot 目录中,根据自己的情况修改application.yml的数据库信息

4.创建 Service 服务

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
vim /etc/systemd/system/hexo-boot.service

# 编辑内容如下:

[Unit]
Description=hexo-boot
After=syslog.target

[Service]
User=root
ExecStart=/usr/java/jdk8/bin/java -server -Xms512m -Xmx1024m -jar /root/.hexo-boot/hexo-boot.jar --spring.config.additional-location=/root/.hexo-boot/
Restart=always

[Install]
WantedBy=multi-user.target

注意:内存分配和路径根据自己的情况进行修改,且路径必须是绝对路径!

注意:内存分配和路径根据自己的情况进行修改,且路径必须是绝对路径!

注意:内存分配和路径根据自己的情况进行修改,且路径必须是绝对路径!

5.服务命令

1
2
3
4
5
6
# 启动
systemctl start hexo-boot
# 重启
systemctl restart hexo-boot
# 关闭
systemctl stop hexo-boot

6.补充

步骤1 和 步骤2 可以使用如下命令代替

注意 jar 版本号,请使用最新版本

注意 jar 版本号,请使用最新版本

注意 jar 版本号,请使用最新版本

【GitHub】资源

1
2
3
4
5
# 下载安装包
curl -L https://github.com/moonlightL/hexo-boot/releases/download/1.4.0/hexo-boot-1.4.0.jar --output ~/.hexo-boot/hexo-boot.jar

# 下载 spring boot 配置文件,记得要修改数据库配置
curl -L -o ~/.hexo-boot/application.yml --create-dirs https://github.com/moonlightL/hexo-boot/releases/download/1.4.0/application.yml

【码云】资源

1
2
3
4
5
# 下载安装包
curl -L https://gitee.com/moonlightL/hexo-boot/attach_files/537531/download/hexo-boot-1.4.0.jar --output ~/.hexo-boot/hexo-boot.jar

# 下载 spring boot 配置文件,记得要修改数据库配置
curl -L -o ~/.hexo-boot/application.yml --create-dirs https://gitee.com/moonlightL/hexo-boot/attach_files/537532/download/application.yml

五、添加主题

5.1 方式一

下载主题源码,修改名称(比如 hexo-boot-theme-abc 改成 abc),然后将整个文件夹复制到项目的 resources/templates/theme 下(与 default 目录同级),启动项目即可。

如若项目已经启动运行,也可复制到 classes/templates/theme 下即可。

5.2 方式二

进入博客后端管理界面 -> 更换主题 -> 拉取安装,出现地址拉取框

输入主题的 git 地址,点击“拉取”按钮,即可等待下载安装

5.3 方式三

将主题文件(.zip)下载到本地,然后进入博客后端管理界面 -> 更换主题 -> 上传安装,出现上传文件框

选择需要上传的主题文件,点击“解压安装”按钮即可

目前已开源的主题:

hexo-boot-theme-vCard

hexo-boot-theme-breezyCV

hexo-boot-theme-next

hexo-boot-theme-wuxia

如果网络不佳,无法访问 GitHub,也可以访问 码云 ,找到主题进行下载。

也可自定义主题,参考 GitHub Wiki码云 Wiki

六、问题反馈

1.) 专辑列表中,手动录入方式保存视频时,点击“生成封面”没反应

1
出现跨域问题,需要再对应的图床中配置跨域来源。

2.)专辑列表中,保存视频时提示操作超时/报错

1
如果使用的是博客是3.4版本以及之前的版本,需要手动创建cover目录,即 mkdir -p ~/.hexo-boot/attachments/cover 。

七、更新日志

2022-04-04 整合 COS(腾讯云)对象存储,优化文件上传代码

2022-02-18 统一评论功能接口,重写评论区插件

2021-12-23 新增发布专辑功能(图片、视频)

2021-07-08 新增日志记录功能

2021-06-29 文章添加访问密码

2021-06-24 新增动态功能

2021-06-22 新增自定义文章链接,支持上传zip包安装博客主题

2021-04-28 新增富文本编辑器(已支持 editor.md 和 summernote 两套编辑器)

2021-03-24 实现 html 内容压缩渲染

2021-03-03 调整管理后台主题源码修改编辑区,新增代码高亮、关键字查询和行数定位功能

2021-02-03 默认主题支持 pjax 请求,同时新增音乐播放功能

2020-12-16 调整默认主题,新增自定义页面功能

2020-12-02 支持 jar 方式部署运行

2020-11-12 新增在线下载拉取主题功能

2020-10-30 扩展主题配置,在线编辑主题文件,调整评论区插件的展示列表

2020-10-22 上传开源

八、Hexo-Boot 4.0 版本调整

  • 代码结构分层
  • 新增插件功能
  • 将 Druid 数据源替换为 HikariCP
  • 抽离系统信息代码,以插件形式封装
  • 抽离第三方对象存储代码,以插件形式封装
  • 修改部分页面 UI 交互