帮助你快速初始化基于Nest.js的node后端服务
本项目适用:
- node简易应用初始化
- node项目初学试验
- 有兴趣的童鞋亦可作为项目脚手架(项目内都是基础功能与结构,是可以作为简单的脚手架的)
- 希望使用者有JavaScript基础,熟悉typescript更佳。
- 希望有简单node应用开发基础(可选)
- 希望能先了解Nest.js框架(传送门)
git clone https://github.com/mykurisu/fast-nest.git
cd fase-nest
npm install
npm start
如代码所示,将本项目克隆至本地,安装好依赖即可启动服务,默认端口为8000,若需要调整请在根目录的config.ts中进行调整。
项目启动后,如果没有启动本地的MongoDB会出现超时的报错,这时有三种方案:
① 将common.module中的mongo公共服务挂载删除
② 本地启动MongoDB,连接数据库的配置亦在config.ts内
③ 连接远端的MongoDB,配置也在config.ts内填写
温馨提示:数据库地址不宜暴露在GIT项目中,建议数据库配置写在settings.json中,部署时再自行创建配置文件。
- 小而全的Node项目目录结构
- 按照核心、功能以及公共三个维度进行模块划分
- 内置格式化返回数据的拦截器
- 内置格式化返回错误信息的过滤器
- 内置符合容器规范的日志中间件
- 内置MongoDB初始化服务
- 内置服务接口文档生成功能
- 内置模块创建脚本
- 内置文件上传模块
- 内置缓存模块
- 打包发布,兼容node容器发布模式
npm start
启动项目
npm run build
打包项目输出js到build文件夹
npm run deploy
打包项目输出js并直接运行
npm run deploy:pm2
通过pm2将项目运行,具体配置可以在 pm2.json 中进行更改
npm run doc
一键输出服务内的所有模块与接口信息
npm run create ${ModuleName}
一键新建模块
如果对大家有帮助,不妨为我点个star。该项目会长期维护,争取成为真正的应用脚手架。