hartl3y94 / nblog

🍓 Spring Boot + Vue 前后端分离博客系统 https://naccl.top

简介

本着『前后端分离，人不分离』的要领，开发了此基于 Spring Boot + Vue 前后端分离博客系统

预览地址：

前台：https://naccl.top

后台：https://admin.naccl.top 账号Visitor密码123456

后端

1. 核心框架：Spring Boot
2. 安全框架：Spring Security
3. Token 认证：jjwt
4. 持久层框架：MyBatis
5. 分页插件：PageHelper
6. NoSQL缓存：Redis
7. Markdown 转 HTML：commonmark-java
8. 离线 IP 地址库：ip2region
9. 定时任务：quartz
10. UserAgent 解析：yauaa

邮件模板参考自Typecho-CommentToMail-Template

基于 JDK8 开发，8以上要添加依赖：

<dependency>
    <groupId>javax.xml.bind</groupId>
    <artifactId>jaxb-api</artifactId>
    <version>2.3.0</version>
</dependency>

前端

核心框架：Vue2.x、Vue Router、Vuex

Vue 项目基于 @vue/cli4.x 构建

JS 依赖及参考的 css：axios、moment、nprogress、v-viewer、prismjs、APlayer、MetingJS、lodash、mavonEditor、echarts、tocbot、iCSS

后台 UI

后台 CMS 部分基于 vue-admin-template 二次修改后的 my-vue-admin-template 模板进行开发（于2021年11月1日重构）

UI 框架为 Element UI

前台 UI

Semantic UI：主要使用，页面布局样式，个人感觉挺好看的 UI 框架，比较适合前台界面的开发，语义化的 css，前一版博客系统使用过，可惜该框架 Vue 版的开发完成度不高，见 Semantic UI Vue

Element UI：部分使用，一些小组件，弥补了 Semantic UI 的不足，便于快速实现效果

文章排版：基于 typo.css 修改

最近更新

支持 Telegram Bot 快捷操作

桌面	Phone	Phone

若要启用该功能，参考以下步骤：

1. 向 @BotFather 申请一个 Bot，得到该 Bot 的token，格式如1234567890:qwertyuiopasdfghjklzxcvbnm
2. 与该 Bot 私聊，随便发个消息，然后打开此链接https://api.telegram.org/bot<botToken>/getUpdates（替换链接中的 token），在result -> message -> chat -> id得到chatId
3. 将获取的token和chatId填入application-dev.properties，并启用comment.notify.channel=tg
4. 由于目前仅提供 webhook 的方式获取消息更新，所以application-dev.properties中的blog.api需要填写后端 API 的地址，并且必须是https(Telegram 的要求)，也就是说如果你没有公网 IP 或内网穿透或反向代理，那么在本地环境是无法测试的，建议直接扔服务器上
5. 因为 GFW 的存在，正常无法访问 TG 的 API，因此提供了两种方式
   1. 代理：配置http.proxy.server，通过你的代理发送请求
   2. 反向代理：可以直接使用我跑在 Cloudflare Workers 上的反代，默认配置即可，但建议自行搭建，示例反代随时可能关闭🙃。示例代码已放在blog-api/cfworker-tg-api-open.js，CV 即可 run

快速开始

1. 创建 MySQL 数据库nblog，并执行/blog-api/nblog.sql初始化表数据
2. 修改配置信息blog-api/src/main/resources/application-dev.properties
3. 安装 Redis 并启动
4. 启动后端服务
5. 分别在blog-cms和blog-view目录下执行npm install安装依赖
6. 分别在blog-cms和blog-view目录下执行npm run serve启动前后台页面

注意事项

一些常见问题：

• MySQL 确保数据库字符集为utf8mb4的情况下通常没有问题（”站点设置“及”文章详情“等许多表字段需要utf8mb4格式字符集来支持 emoji 表情，否则在导入 sql 文件时，即使成功导入，也会有部分字段内容不完整，导致前端页面渲染数据时报错）
• 确保 Maven 能够成功导入现版本依赖，请勿升级或降低依赖版本
• 数据库中默认用户名密码为Admin，123456，因为是个人博客，没打算做修改密码的页面，可在top.naccl.util.HashUtils下的main方法手动生成密码存入数据库
• 注意修改application-dev.properties的配置信息
  • Redis 若没有密码，留空即可
  • 注意修改token.secretKey，否则无法保证 token 安全性
  • spring.mail.host及spring.mail.port的默认配置为阿里云邮箱，其它邮箱服务商参考关键字spring mail 服务器（邮箱配置用于接收评论提醒）

隐藏功能

• 在前台访问/login路径登录后，可以以博主身份（带有博主标识）回复评论，且不需要填写昵称和邮箱即可提交
• 在 Markdown 中加入<meting-js server="netease" type="song" id="歌曲id" theme="#25CCF7"></meting-js> （注意以正文形式添加，而不是代码片段）可以在文章中添加 APlayer 音乐播放器，netease为网易云音乐，其它配置及具体用法参考 MetingJS
• 提供了两种隐藏文字效果：在 Markdown 中使用@@包住文字，文字会被渲染成“黑幕”效果，鼠标悬浮在上面时才会显示；使用%%包住文字，文字会被“蓝色覆盖层”遮盖，只有鼠标选中状态才会反色显示。例如：@@隐藏文字@@，%%隐藏文字%%
• 大部分个性化配置可以在后台“站点设置”中修改，小部分由于考虑到首屏加载速度（如首页大图）需要修改前端源码

And...

自用博客，长期维护，欢迎勘误

Thanks

感谢 JetBrains 提供的非商业开源软件 License

感谢上面提到的每个开源项目