# vueBlog1

**Repository Path**: zg_m/vue-blog1

## Basic Information

- **Project Name**: vueBlog1
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-12-02
- **Last Updated**: 2023-12-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

### 环境准备

- Node.js v14.15.5
- MongoDB v4.2.17

### 安装MongoDB数据库

进入[官网](https://www.mongodb.com/try/download/community)下载，版本是4.2.17，平台是Windows，安装包为msi格式

### 项目开发

#### 1. 克隆项目至本地：

```sh
$ git clone git@github.com:miqilin21/vue-blog.git
$ cd vue-blog
$ pnpm i
```

#### 2. 安装前后台(admin、web)及后端(server)项目依赖：

```sh
$ pnpm install-all
```

#### 3. 运行前后台(admin、web)及后端(server)项目：

```sh
$ pnpm serve-all
```

#### 4. 打开浏览器预览：

http://localhost:8080 打开前台本地页面；http://localhost:8088 打开后台本地页面。

第一次后台admin登陆时请先注册用户，登录后可以将注册按钮隐藏以防登录账户泄露。

### 后台管理系统

- 新增分类
- 分类列表(增删改查)

- 新增文章
- 文章列表(增删改查)

- 文章评论列表

- 新增友链
- 友链列表(增删改查)

- 留言列表

- 留言用户列表

- Markdown 编辑器集成
- 图片上传功能

- 新增用户
- 用户列表(增删改查)

- 通用增删改查接口实现(中间件 resourceMiddleware)

- 登录注册功能
- 登出功能
- 添加 jwt 校验（1. 用户名查找 2. 密码校验 3. 返回 token）
- 添加 http 拦截器（request、response)

### 博客系统

- 博客首页 UI
- 博客首页接口实现
- 博客归档页面 UI
- 博客归档页面接口实现
- 博客标签页面 UI
- 博客标签页面接口实现
- 博客文章页面 UI
- 博客文章页面接口实现
- 博客友链页面 UI
- 博客友链页面接口实现
- 博客留言页面 UI
- 博客留言页面接口实现

### 配置注意点

1. 评论页面回复他人评论采用的是你的QQ邮箱进行同步通知，需要在 `server/plugins/sendEmail.js` 中进行邮箱配置，如何获取QQ邮箱授权码见下图（在QQ邮箱的设置-账户页面）。

![](https://miqilin-blog.oss-cn-shenzhen.aliyuncs.com/qq-shouquanma.png)

2. 评论主账户的配置（主账户用于邮箱回复，所以评论建立的账户邮箱要和上一步QQ邮箱授权码的邮箱为同一个），同时需要在 `web/src/commentConfig.js` 中进行评论账户的设置（注意`topNickName`需要和评论建立的主账号昵称一致，`topParentId`可从后台页面获取），主账户被清除的话要重新进行配置。
3. 关于后台的图片上传：默认是上传到本地，这种方式的话对于服务器要求比较高，自然前端的加载速度会受影响，可以选择用阿里云的oss进行上传及储存，需要将 `server/routes/admin/index.js` 中关于阿里云oss图片上传的代码注释解除，同时将本地图片上传的代码注释掉，最后将你的阿里云oss配置填入即可。

### 项目打包部署

- web、admin 项目打包(根目录下运行 `pnpm build-all` 命令)
- 域名购买
- 域名解析
- linux 云服务器购买
- git 安装, ssh key 添加
- pm2 进程管理
- ngnix 配置
- mongodb 配置
- mongodb 数据从本地迁移至服务器
- 七牛云 cdn 全站免费加速

线上服务器部署可参考这份[指南](https://www.yuque.com/lingqian-ceavu/gxhqpr)。

### 博客后台管理系统

![](https://miqilin-blog.oss-cn-shenzhen.aliyuncs.com/admin.gif)

### 博客系统

![](https://miqilin-blog.oss-cn-shenzhen.aliyuncs.com/web.gif)

### 欢迎 Star，Issues

- 您的 Star，是我不断更新维护的动力！！！
- 若在使用过程中，存在某些问题，欢迎 Issues

### To Do List

- 性能优化，图片需要压缩处理，预加载处理
- 给博文页面加上搜索功能
- 浏览器兼容问题，移动端适配。只用了自己电脑的谷歌 chrome 浏览器开发和手机适配效果，其他种种都没试，不过不建议移动端使用，电脑登陆效果更佳
- 解决 vue 的 seo 问题及刷新渲染页面抖动问题。先暂时做 vue 预渲染，不排除以后会做 vue 服务端渲染或 nuxt.js 服务端渲染
- 整理代码，拆分出组件。让结构更清晰，代码量更少
- 利用 typescript 重构整个项目
- 想到有意思的功能也会慢慢加上，持续开发中...