什么是nestjs-starter-rest-api一文读懂这个生产级NestJS 11单体REST API启动模板的全部功能【免费下载链接】nestjs-starter-rest-apiNestJS Starter Kit. Monolithic Backend. REST API.项目地址: https://gitcode.com/gh_mirrors/ne/nestjs-starter-rest-apinestjs-starter-rest-api是一个生产级的NestJS 11 单体Monolithic后端启动模板开箱即用地提供REST API项目骨架内置 JWT 认证、RBAC 角色权限控制、TypeORM 数据库迁移、winston 日志、请求参数校验、分页、Docker 一键部署与自动生成的 Swagger 接口文档。克隆下来即可完成一个可上线的后端项目雏形让你把精力全部放在业务代码上 功能总览这套启动模板到底强在哪项目设计原则是尽量轻量只保留生产环境真正需要的能力功能实现方案状态 认证JWTRS256 非对称加密 刷新令牌✅ 完成️ 授权RBAC 基于角色的访问控制✅ 完成️ ORM 集成TypeORM PostgreSQL✅ 完成 数据库迁移TypeORM Migrations✅ 完成 日志winston✅ 完成✅ 请求校验class-validator✅ 完成 接口文档自动生成 OpenAPI / Swagger UI✅ 完成 部署Dockerfile docker-compose Devcontainer✅ 完成 自动 Changelog基于 commitlint 进行中 核心价值这些特性大多已经在 MonstarLab 的生产应用中经过验证而不是玩具级示例。 项目结构一眼看懂的单体分层架构仓库采用按领域模块划分的组织方式根入口见 src/app.module.tssrc/ ├── auth/ # 认证模块JWT 策略、登录/注册/刷新接口、角色守卫 ├── user/ # 用户模块用户 CRUD ACL 权限服务 ├── article/ # 文章模块完整示例业务controller/service/repository/entity/dto └── shared/ # 共享模块ACL 基础服务、配置、全局异常过滤器、日志、中间件 migrations/ # TypeORM 数据库迁移文件 test/ # E2E 端到端测试src/auth/包含本地登录、JWT 访问令牌、刷新令牌三套策略src/auth/auth.module.ts以及RolesGuard角色守卫src/article/一个标准业务模块范本新建模块照抄这个结构即可src/shared/全局异常过滤器统一响应格式、Request-ID 中间件src/shared/middlewares/request-id/request-id.middleware.ts、日志服务等migrations/如CreateUsers.ts、CreateArticles.ts等数据库结构变更脚本。详细的目录说明可参考项目内置文档 docs/project-structure.md。 核心功能 1JWT 认证 RBAC 角色授权认证流程登录 → 签发访问令牌 刷新令牌RS256 算法公钥/私钥以 Base64 形式配置在.env中→ 请求携带Bearer令牌 → JWT 守卫校验。相关实现位于 src/auth/guards/ 与 src/auth/strategies/。授权RBAC模板内置一套 ACL访问控制列表机制文档见 docs/acl.md每个领域模块继承BaseAclService例如文章模块的 src/article/services/article-acl.service.ts用一行canDo(ROLE.ADMIN, [Action.Manage])声明管理员可管理所有文章支持自定义回调规则例如只有作者本人能修改自己的文章动作分为Create / Read / Update / Delete / List / Manage其中Manage是超级权限。 附赠npm run cli:dev会在首次启动时自动创建默认管理员账号src/cli.ts省去手工造号。 核心功能 2TypeORM 数据库迁移数据库操作全部通过 TypeORM 完成连接配置见 ormconfig.ts并提供完整的迁移命令npm run migration:generate --nameCreateUsers # 生成迁移文件 npm run migration:run # 执行迁移 npm run migration:revert # 回滚迁移迁移文件存放于migrations/目录团队多人协作改表结构时不再各改各的这是生产项目的硬性要求。 核心功能 3Swagger 接口文档零成本生成启动入口 src/main.ts 中已配置好 OpenAPI 生成服务启动后访问/swagger即可在浏览器中获得可交互的接口文档并统一挂载在/api/v1全局前缀下。全局还开启了 CORS、统一请求参数校验管道class-validator所有入参自动做类型与格式校验脏数据进不了业务层。 一键启动步骤最快配置方法Docker无需在本地安装 Node 环境三个命令跑起应用 PostgreSQL 16 Adminer 数据库管理页# 1. 克隆仓库 git clone https://gitcode.com/gh_mirrors/ne/nestjs-starter-rest-api # 2. 准备环境变量 生成 JWT 密钥 cp .env.template .env ./scripts/generate-jwt-keys # 按输出把两行 Base64 密钥填入 .env # 3. 一键启动 docker compose up启动后入口地址 Swagger 接口文档http://localhost:3000/swagger Adminer 数据库面板http://localhost:8080不想用 Docker 也可以本地准备一个 PostgreSQL 服务后直接npm install npm run start:dev。环境差异说明见 .env.template。⚙️ 工程质量这些看不见的功能同样值钱工程能力实现说明代码风格Prettier ESLint提交前lint-staged自动格式化提交规范husky commitlint强制 Conventional Commits单元测试Jestnpm run test含覆盖率报告端到端测试Jest Supertesttest/ 下 auth/user/article 全覆盖代码质量SonarCloud配置见 sonar-project.propertiesAPI 文档生成Compodocnpm run doc:serve容器开发Devcontainer Dockerfile团队环境完全一致 适用场景与上手建议✅ 适合用 NestJS 11 启动新后端项目、需要快速搭建带认证/权限/文档/容器化能力的 REST API✅ 学习价值高article模块是标准业务模块的教科书式示范照葫芦画瓢即可扩展新业务⚠️ 注意这是单体架构模板如果目标是微服务架构请在业务早期就评估是否需要不同的脚手架。一句话总结nestjs-starter-rest-api NestJS 11 JWT/RBAC TypeORM 迁移 Swagger Docker 全套工程化是从空仓库到可上线 REST API的最短路径。【免费下载链接】nestjs-starter-rest-apiNestJS Starter Kit. Monolithic Backend. REST API.项目地址: https://gitcode.com/gh_mirrors/ne/nestjs-starter-rest-api创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考