启动

安装 NodeJS

首先安装 NodeJS，安装很简单无脑下一步就可以。本人使用的版本为Node 12.16.1(其他版本请自行尝试)。

NodeJS官网 (opens new window)

拉取项目

# 克隆代码
git clone https://github.com/KiteWorld/KiteBlog.git

# 进入项目根目录
cd KiteBlog

# 安装依赖
npm i

#启动项目
npm run start-dev-win

导入数据库

1. 找到项目根目录下的kiteblog.sql文件

2. 本人使用的是MySQL 5.7版本,假设你已经安装。（其他版本的请自行尝试）

3. 创建数据库表并导入数据:

   • 使用 Navcat (方式一) 如果你安装了 Navcat之类的可视化管理数据库软件，直接新建一个命名为kite_blog的数据库，字符集为utf8mb4，校对规则为utf8mb4_general_ci。然后导入kite_blog.sql。导入的数据库表里面包含一些初始数据。

   • 命令行的方式 (方式二)

   # 连接数据库 mysql -u用户名 -p密码
   mysql -uroot -p123456
   
   # 创建数据库,直接复制三行指令，运行就好
   CREATE DATABASE IF NOT EXISTS kite_blog
   DEFAULT CHARACTER SET utf8mb4 
   DEFAULT COLLATE utf8mb4_general_ci;
   
   # 选择创建的数据库
   use kite_blog
   
   # 导入数据（会覆盖数据库数据） soucre 加sql文件存放路径
   source G:/KiteBlog/kite_blog.sql
   

拉取前端代码进行调试、验证（推荐）

没有意外的话，后端项目已经是可以正常使用的了。但由于后端项目存在 Token 验证，你需要调用登录接口获取到 Token 之后，并携带 Token ，才能请求其他接口。

具体操作参考：后台管理 CMS

使用 PostMan 调试

如果你对前端代码不感兴趣，可以 PostMan 进行调试验证

登录接口（POST请求）：http://localhost:1874/auth/adminLogin

Body携带的JSON :{ "jobNo": "100000001", "password": "123123" }

导入数据库的时候，已经添加了这个账号密码。参考下方图片

请求之后，获取 Token ，具体怎么携带 Token请求，可以对照下面的图片

项目特点

Token 生成验证、手写SQL、文件上传、跨域配置、https配置、websocket(配合数据可视化界面，开发中)、生成/开发环境配置...

技术栈

项目是通过 express-generator (opens new window) 快速生成的，express-generator与Express的关系，类似于 vue-cli 和vue ，也就是脚手架。

{
  "dependencies": {
    "cookie-parser": "~1.4.4",  // 解析Cookie
    "debug": "~2.6.9",  // express-generator生成时自带
    "ejs": "~2.6.1",  // 模板引擎，express-generator生成时自带
    "express": "~4.16.1",  //express框架 express-generator生成时自带
    "express-jwt": "^6.0.0",  // 解析验证请求携带的 Token
    "http-errors": "~1.6.3",  // 处理 http错误的
    "jsonwebtoken": "^8.5.1",  // 生成Token。也可以用于验证Token，不给验证没有`express-jwt`简便
    "morgan": "~1.9.1",  // 记录请求日志
    "multer": "^1.4.2",  // 文件上传 只支持表单MIME编码为multipart/form-data类型的数据请求
    "mysql": "^2.18.1"  // mysql相关操作
  },
  "devDependencies": {
    "nodemon": "^2.0.6"  // 热更新，修改了代码不用重新启动项目
  }
}