51工具盒子一、Hexo Boot {#一、Hexo-Boot}
Hexo Boot 是基于 Spring Boot + MySQL 开发的一套开源的博客系统。前身是 ml-blog 博客系统，在此基础上演变和扩展而来。
二、扩展功能 {#二、扩展功能}
Hexo Boot 博客系统除了继承 ml-blog 博客系统的文章管理、分类管理、系统参数设置等功能外，还扩展了以下功能。
2.1 评论、留言功能 {#2.1-评论、留言功能}
|-----------|---------------------------|
| 1 | 轻松查看网友的评论与留言，及时互动 |
2.2 友链功能 {#2.2-友链功能}
|-----------|----------------------|
| 1 | 与网友互换主页，友好分享 |
2.3 主题功能 {#2.3-主题功能}
|-----------|--------------------------------------------------|
| 1 | 支持前端页面主题动态变换以及在线编辑源码，让页面色彩丰富起来，同时支持自定义主题 |
2.4 黑名单功能 {#2.4-黑名单功能}
|-----------|--------------------------------|
| 1 | 设置 ip 黑名单，防御网络小人恶意攻击系统 |
2.5 附件功能 {#2.5-附件功能}
|-----------|-----------------------------|
| 1 | 支持本地、七牛云、OSS 3种附件管理 |
2.6 备份功能 {#2.6-备份功能}
|-----------|-------------------------------|
| 1 | 支持自动和手动备份SQL数据，防患数据丢失 |
2.7 音乐播放 {#2.7-音乐播放}
|-----------|--------------------------------|
| 1 | 支持音乐配置管理以及在线播放，切换页面不中断 |
2.8 默认主题特色 {#2.8-默认主题特色}
|------------------------------|-------------------------------------------------------------------------------------------------|
| 1 2 3 4 5 6 7 8 9 10 | 支持 CDN 配置 图片延迟加载 图片灯箱 夜间模式 音乐播放 打赏功能 点赞功能 评论功能（支持两种：默认和Twikoo） 文章布局（支持两种：卡片和列表） 实现 pjax |
更多详情请访问下边提供的网址进行浏览。
三、预览效果 {#三、预览效果}
3.1 后台管理预览图 {#3.1-后台管理预览图}
3.2 前端预览图(默认主题) {#3.2-前端预览图-默认主题-}
四、启动与部署 {#四、启动与部署}
4.1 启动 {#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 部署 {#4.2-部署}
该项目支持 war 包和 jar 包两种方式运行
4.2.1 war 包形式 {#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 包形式 {#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 方式一 {#5.1-方式一}
下载主题源码，修改名称（比如 hexo-boot-theme-abc 改成 abc），然后将整个文件夹复制到项目的 resources/templates/theme 下（与 default 目录同级），启动项目即可。
如若项目已经启动运行，也可复制到 classes/templates/theme 下即可。
5.2 方式二 {#5.2-方式二}
进入博客后端管理界面 -> 更换主题 -> 拉取安装，出现地址拉取框
输入主题的 git 地址，点击"拉取"按钮，即可等待下载安装
5.3 方式三 {#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 版本调整 {#八、Hexo-Boot-4.0-版本调整}
- 代码结构分层
- 新增插件功能
- 将 Druid 数据源替换为 HikariCP
- 抽离系统信息代码，以插件形式封装
- 抽离第三方对象存储代码，以插件形式封装
- 修改部分页面 UI 交互
