一个及其简洁的个人博客系统、即插即用，如果你想使用这个博客、动动手改改配置即可使用！！
- 前后台分离式开发（项目中也包含博客的后台管理系统），为了方便记录后端开发过程，笔者将后端也一起放在同个项目文件夹中。
- 博客样式几乎借助于
antd这个优秀的 UI 框架，主打简约风格，是笔者借鉴了antd官方的风格所设计。 - 具备了代码高亮、权限管理、第三方
github登录、评论与通知、以及邮件通知功能的个人博客...
- 我的博客地址: 郭大大的博客
- 测试博客地址: 测试使用的郭大大的博客
admin/admin为博主账号 小伙伴可以使用看看博客的完整功能！
- 前台：主页 + 列表页 + 搜索页 + 分类页 + 标签页
- 后台：文章管理 + 用户管理
- 响应式、文章锚点导航、回到顶部、
markdown代码高亮 - 用户：站内用户、
github第三方授权登录的用户 - 用户可以评论与回复、以及邮件通知回复的状态
-
前端 （基于
create-react-app eject后的配置）- react v16.9.0
hooks+redux+react-router4 marked highlight.jswebpack打包优化axios封装
- react v16.9.0
-
后端 （自构建后台项目）
koa2+koa-routersequelize+mysqljwt+bcryptnodemailer
.
│
├─config // 构建配置
├─public // html 入口
├─scripts // 项目脚本
└─server // 后端
├─config // 项目配置 github、email、database、token-secret 等等
├─controllers // 业务控制层
├─middlewares // 中间件
├─models // 数据库模型
├─router // 路由
├─utils // 工具包
├─ app.js // 后端主入口文件
├─ initData.js // 初始化基础数据脚本
└─...
│
└─src // 前端项目源码
├─assets // 静态文件
├─components // 公用组件
├─layout // 布局组件
├─redux // redux 目录
├─routes // 路由
├─styles // 样式
├─utils // 工具包
├─views // 视图层
├─ App.jsx // 后端主入口文件
├─ config.js // 项目配置 github 个人主页、个人介绍等等
├─ index.js // 主入口文件
└─...role === 1: 博主用户 role === 2: 普通用户
权限管理 server/middlewares/authHandler.js
const { checkToken } = require('../utils/token')
/**
* role === 1 需要权限的路由
* @required 'all': get post put delete 均需要权限。
*/
const verifyList1 = [
{ regexp: /\/article/, required: 'post, put, delete' }, // 普通用户 禁止修改或者删除、添加文章
{ regexp: /\/discuss/, required: 'delete, post' }, // 普通用户 禁止删除评论
{ regexp: /\/user/, required: 'get, put, delete' } // 普通用户 禁止获取用户、修改用户、以及删除用户
]
// role === 2 需要权限的路由
const verifyList2 = [
{ regexp: /\/discuss/, required: 'post' } // 未登录用户 禁止评论
]
/**
* 检查路由是否需要权限，返回一个权限列表
*
* @return {Array} 返回 roleList
*/
function checkAuth(method, url) {
function _verify(list, role) {
const target = list.find(v => {
if (v.regexp.test(url)) {
return v.required === 'all' || v.required.toUpperCase().includes(method)
}
})
return !!target
}
const roleList = []
_verify(verifyList1, 1) && roleList.push(1)
_verify(verifyList2, 2) && roleList.push(2)
return roleList
}
module.exports = async (ctx, next) => {
const roleList = checkAuth(ctx.method, ctx.url)
// 该路由需要验证
if (roleList.length > 0) {
if (checkToken(ctx, roleList)) {
await next()
} else {
ctx.status = 401
ctx.client(401)
}
} else {
await next()
}
}import React from 'react'
import MyInfo from '@/views/web/about/MyInfo'
// API_BASE_URL
export const API_BASE_URL = 'http://127.0.0.1:6060'
// project config
export const HEADER_BLOG_NAME = '郭大大的博客' // header title 显示的名字
// === sidebar
export const SIDEBAR = {
avatar: require('@/assets/images/avatar.jpeg'), // 侧边栏头像
title: '郭大大', // 标题
subTitle: '前端打杂人员，略微代码洁癖', // 子标题
// 个人主页
homepages: {
github: 'https://github.com/gershonv',
juejin: 'https://juejin.im/user/5acac6c4f265da2378408f92'
}
}
// === discuss avatar
export const DISCUSS_AVATAR = SIDEBAR.avatar // 评论框博主头像
// github
export const GITHUB = {
enable: true, // github 第三方授权开关
client_id: '', // Setting > Developer setting > OAuth applications => client_id
url: 'https://github.com/login/oauth/authorize', // 跳转的登录的地址
loadingType: 1
}
export const ABOUT = {
avatar: SIDEBAR.avatar,
describe: SIDEBAR.subTitle,
discuss: true, // 关于页面是否开启讨论
renderMyInfo: <MyInfo /> // 我的介绍 自定义组件 => src/views/web/about/MyInfo.jsx
}const devMode = process.env.NODE_ENV === 'development'
const config = {
PORT: 6060, // 启动端口
ADMIN_GITHUB_LOGIN_NAME: 'gershonv', // 博主的 github 登录的账户名 user
GITHUB: {
client_id: 'c6a96a84105bb0be1fe5',
client_secret: '',
access_token_url: 'https://github.com/login/oauth/access_token',
fetch_user_url: 'https://api.github.com/user', // 用于 oauth2
fetch_user: 'https://api.github.com/users/' // fetch user url https://api.github.com/users/gershonv
},
EMAIL_NOTICE: {
// 邮件通知服务
// detail: https://nodemailer.com/
enable: true, // 开关
transporterConfig: {
host: 'smtp.163.com',
port: 465,
secure: true, // true for 465, false for other ports
auth: {
user: 'guodadablog@163.com', // generated ethereal user
pass: '123456' // generated ethereal password 授权码 而非 密码
}
},
subject: '郭大大的博客 - 您的评论获得新的回复！', // 主题
text: '您的评论获得新的回复！',
WEB_HOST: 'http://127.0.0.1:3000' // email callback url
},
TOKEN: {
secret: 'guo-test', // secret is very important!
expiresIn: '720h' // token 有效期
},
DATABASE: {
database: 'test',
user: 'root',
password: '123456',
options: {
host: 'localhost', // 连接的 host 地址
dialect: 'mysql', // 连接到 mysql
pool: {
max: 5,
min: 0,
acquire: 30000,
idle: 10000
},
define: {
timestamps: false, // 默认不加时间戳
freezeTableName: true // 表名默认不加 s
},
timezone: '+08:00'
}
}
}
// 部署的环境变量设置
if (!devMode) {
console.log('env production....')
// ==== 配置数据库
config.DATABASE = {
...config.DATABASE,
database: '', // 数据库名
user: '', // 账号
password: '' // 密码
}
// 配置 github 授权
config.GITHUB.client_id = ''
config.GITHUB.client_secret = ''
// ==== 配置 token 密钥
config.TOKEN.secret = ''
// ==== 配置邮箱
// config.EMAIL_NOTICE.enable = true
config.EMAIL_NOTICE.transporterConfig.auth = {
user: 'guodadablog@163.com', // generated ethereal user
pass: '123456XXX' // generated ethereal password 授权码 而非 密码
}
config.EMAIL_NOTICE.WEB_HOST = 'https://guodada.fun'
}
module.exports = config关于 github 第三方授权和 email 授权，可以参考
git clone https://github.com/gershonv/react-blog.git
## 安装依赖以及开启开发模式
cd react-blog
yarn
yarn dev
## 安装依赖以及开启开发模式 注意必须先配置好数据库、个人github账户登录名，配置文件在 server/config/index.js
## 笔者采用的数据库字符集为 utf8mb4 排序规则 utf8mb4_general_ci
cd server
yarn
yarn dev
## 打包前端
cd react-blog
yarn build
## 后端笔者则是采用pm2
cd server
pm2 start app.jsPS : 觉得不错的伙伴可以给个 star ~~~ 或者 fork 下来看看哦。如果有什么建议，也可以提 issue 哦