一、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 | 支持 CDN 配置 |
更多详情请访问下边提供的网址进行浏览。
三、预览效果
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 | 将 <packaging>war</packaging> 注释放开 |
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 | vim /etc/systemd/system/hexo-boot.service |
注意:内存分配和路径根据自己的情况进行修改,且路径必须是绝对路径!
注意:内存分配和路径根据自己的情况进行修改,且路径必须是绝对路径!
注意:内存分配和路径根据自己的情况进行修改,且路径必须是绝对路径!
5.服务命令
1 | # 启动 |
6.补充
步骤1 和 步骤2 可以使用如下命令代替
注意 jar 版本号,请使用最新版本
注意 jar 版本号,请使用最新版本
注意 jar 版本号,请使用最新版本
【GitHub】资源
1 | # 下载安装包 |
【码云】资源
1 | # 下载安装包 |
五、添加主题
5.1 方式一
下载主题源码,修改名称(比如 hexo-boot-theme-abc 改成 abc),然后将整个文件夹复制到项目的 resources/templates/theme 下(与 default 目录同级),启动项目即可。
如若项目已经启动运行,也可复制到 classes/templates/theme 下即可。
5.2 方式二
进入博客后端管理界面 -> 更换主题 -> 拉取安装,出现地址拉取框
输入主题的 git 地址,点击“拉取”按钮,即可等待下载安装
5.3 方式三
将主题文件(.zip)下载到本地,然后进入博客后端管理界面 -> 更换主题 -> 上传安装,出现上传文件框
选择需要上传的主题文件,点击“解压安装”按钮即可
目前已开源的主题:
如果网络不佳,无法访问 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 交互