mstoews/gloss-api-backend_nest-api

镜像概述

本镜像为基于NestJS和Prisma的GraphQL API后端解决方案，集成Postgres数据库支持、JWT安全认证及Swagger REST文档，提供完整的开发与部署流程，适用于各类需要GraphQL接口的应用场景。

核心功能

• GraphQL支持：内置Playground界面，采用Code-First方式（通过装饰器定义 schema）
• Prisma集成：实现数据库建模、迁移及类型安全访问（支持Postgres、MySQL、MongoDB）
• 安全认证：基于passport-jwt的JWT认证机制
• REST文档：自动生成Swagger API文档
• 容器化：提供Dockerfile及部署示例，支持快速容器化部署

使用场景

• 快速开发GraphQL后端API
• 构建企业级应用的后端服务
• 需要关系型数据库与GraphQL结合的项目
• 学习NestJS与Prisma集成的实践案例

配置说明

Prisma设置步骤

1. 安装依赖
   安装Nest服务器依赖：

   bash
   npm install
   

2. 数据库迁移
   保存迁移方案：

   bash
   npx prisma migrate save --experimental
   # 或 npm run prisma:save
   

   执行迁移：

   bash
   npx prisma migrate up --experimental
   # 或 npm run prisma:up
   

3. 生成客户端
   生成类型安全的Prisma客户端：

   bash
   npx prisma generate
   # 或 npm run prisma:generate
   

4. 填充种子数据
   执行种子脚本：

   bash
   npm run seed
   

5. 安装Nest CLI
   安装命令行工具：

   bash
   npm i -g @nestjs/cli
   

启动服务

• 开发模式（热重载）：

  bash
  npm run start:dev
  

• 生产模式：

  bash
  npm run start:prod
  

  GraphQL Playground地址：http://localhost:3000/graphql

Docker部署示例

1. 构建镜像

   bash
   docker build -t nest-prisma-server .
   

2. 运行容器

   bash
   docker run -d -t -p 3000:3000 --env-file .env docker.xuanyuan.run/nest-prisma-server
   

   验证：访问http://localhost:3000

认证说明

部分接口需JWT令牌，通过signup/login获取后，在Playground头中添加：

json
{
  "Authorization": "Bearer YOUR_TOKEN"
}

REST文档访问

Swagger文档地址：http://localhost:3000/api