cjavat/the-recipes-backend

食谱管理后端（The Recipes Backend）

镜像概述

本镜像提供食谱管理系统的后端服务，包含用户认证、食谱创建与管理等核心功能，依赖PostgreSQL数据库存储数据，并支持通过邮件服务发送验证通知等消息。

核心功能

1. 用户认证与授权（基于密钥验证）
2. 食谱的创建、查询与管理
3. 邮件通知服务（如用户验证、密码重置等）
4. 与前端系统的交互支持

使用场景

• 个人或家庭搭建私有的食谱管理平台
• 小型团队开发食谱分享类应用的后端支撑
• 学习基于Node.js和PostgreSQL的后端服务开发

配置说明

以下为镜像运行所需的环境变量配置：

部署步骤

1. 创建容器通信网络

bash
docker network create recipes-network

2. 启动PostgreSQL容器

bash
docker run -p 5432:5432 \
--name recipes-db \
--network recipes-network \
-e POSTGRES_USER=postgres \
-e POSTGRES_PASSWORD=postgres \
-e POSTGRES_DB=recipes_db \
-v /你的本地路径/postgres:/var/lib/postgresql/data \
docker.xuanyuan.run/postgres:16.2

3. 启动后端服务容器

bash
docker run -p 3000:3000 \
--name the-recipes-backend \
--network recipes-network \
-e PORT=3000 \
-e HOST_API=你的后端地址 \
-e FRONTEND_URL=你的前端地址 \
-e SECRET_KEY=你的认证密钥 \
-e DATABASE_URL=postgresql://postgres:postgres@recipes-db:5432/recipes_db \
-e MAILER_SERVICE=你的邮件服务提供商 \
-e MAILER_EMAIL=你的邮箱地址 \
-e MAILER_PASSWORD=你的邮箱密码 \
-e MAILER_NAME_EMAIL=发件人名称 \
docker.xuanyuan.run/cjavat/the-recipes-backend:castor

注意：数据库容器名称必须为recipes-db，否则后端服务无法完成Prisma的迁移和客户端生成操作。

Docker-Compose部署

创建docker-compose.yml文件简化部署流程：

yaml
version: '3'

services:
  recipes-db:
    container_name: recipes_database
    image: docker.xuanyuan.run/postgres:16.2
    environment:
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: postgres
      POSTGRES_DB: recipes_db
    ports:
      - 5432:5432
    volumes:
      - ./postgres:/var/lib/postgresql/data
    restart: always

  recipes-backend:
    image: docker.xuanyuan.run/cjavat/the-recipes-backend:castor
    container_name: recipes_backend
    ports:
      - 3000:3000
    depends_on:
      - recipes-db
    environment:
      PORT: 3000
      HOST_API: http://localhost:3000
      FRONTEND_URL: http://localhost:4200
      SECRET_KEY: 
      DATABASE_URL: postgresql://postgres:postgres@recipes-db:5432/recipes_db
      MAILER_SERVICE: 
      MAILER_EMAIL: 
      MAILER_PASSWORD: 
      MAILER_NAME_EMAIL: 'The Recipes'
      NODE_ENV: development
    restart: always

提示：请填写上述配置中缺失的环境变量值（如SECRET_KEY、邮件服务信息等）后再运行。