我终于会用 Docker 了(nest+prisma+psotgresql+nginx+https)

✨文章摘要（AI生成）

笔者在这篇文章中分享了自己使用 Docker 进行 NestJS 后端服务部署的实践经历。文章首先介绍了 Docker 的基本概念和优势，比如简化应用部署和跨平台的可移植性。随后，笔者列出了常用的 Docker 命令并详细解释了 Dockerfile 和 docker-compose.yml 的编写过程，以实现 NestJS、PostgreSQL 和 Nginx 的整合部署。

在实战部分，笔者提供了项目目录结构、Dockerfile 示例以及 docker-compose 配置，强调了持久化存储和环境变量的使用。此外，笔者还分享了在使用 Prisma 时遇到的一个小问题，提醒读者注意容器间的连接配置。

整体而言，本文不仅是对 Docker 基础知识的回顾，也展示了实际操作中的一些细节与坑点，旨在帮助读者更好地理解和应用 Docker 技术。希望对大家的部署工作有所帮助。

前言

这次自己有一个 NestJS 后端服务需要自己部署了，之前部署 node 服务可能更多是 pm2 那一套，自己的项目可以尝试各种各样的技术，所以这次就尝试一下早就想用的 docker 来实际部署一下

本文会讲什么：对于 docker 的理解，docker 必知必会的命令，以及最后是笔者的实战部署，和一些踩坑记录； 本文不会讲什么：docker 更深层次的原理，即本文更多是一篇应用性文章，欢迎继续阅读后续章节；

基本概念介绍

简介

如果是计算机专业的学生，那么是肯定学过操作系统的，而学这门课程有一门操作系统实验，需要自己在 linux 上通过模拟器再运行一个非常低版本的 linux，笔者隐约记得好像是 0.11 那个版本，因为这个版本代码相对来说都是比较核心主要的功能，用来学习是非常不错的。

在操作系统运行一个可以运行其他环境的"系统环境"，这不就是 Docker 的概念吗。或者如果你没有上述的经历，那总在本机运行过 VM 吧，甚至说 win11 中的 wsl 总知道吧。

基本概念就是这个：在 linux 系统上运行一个"系统环境"，官方叫做容器。

那这个所谓的"系统环境"可以做什么呢，当然是运行一些我们常用的东西，如 node、mysql、redis 以及我们自己的应用程序等。

图片来源

优点

好，问题又来了，为什么不直接在该 linux 系统上运行这些环境：这个问题用 Docker 的主要优势就能回答：

1）简化应用程序部署和依赖管理

Docker 是将应用程序和其依赖项打包在一个容器中，避免了复杂的依赖管理和手动安装，因此可以快速部署和更新应用程序。

怎么理解：

• python 打包 exe 用过吧：它会将其依赖的所有环境一起打包最后成为一个可执行文件，形成了这样一个可执行文件，是不是用户只需要双击就能打开，不需要像程序员一样安装各种复杂的依赖
• 前端的 electron 用过吧：它也将应用程序与浏览器环境打包在一起了，用户也可以直接使用你的应用程序了
• 这么理解：有了它，我们就可以直接把这个"软件包"进行部署，而没有它，我们就需要到用户的主机，去干什么pip install之类的，真累~

2）跨平台和环境可移植性

Docker 容器可以在任何操作系统、云平台和虚拟化环境中运行，保证了应用程序在不同环境下的稳定性和可靠性。

也是第一点所讲到的，既然都打包成了一个软件包，那么就可以非常方便地运行在各个环境之中了：

• 想想 Java 虚拟机 JVM，Java 刚出的时候主打的就是一个可移植性，其就是通过先编译成字节码，也就是那个.class文件，然后该文件就可以在任何安装了 JVM 的系统上运行了。
• Docker 也是，只要该环境安装了 Docker，那么由其打包的"软件包"也就能直接运行了

一些关键词及概念

想入门某个领域，第一步就是得先了解该领域特有的关键热词，下面是 Docker 中常用的一些关键词及概念简介：

1. Docker 镜像(Image): Docker 镜像是一个轻量级的、可移植的、自包含的软件包，其中包含了运行某个应用程序所需的所有文件、配置和依赖项。
2. Docker 容器(Container): Docker 容器是由 Docker 镜像创建的运行实例，容器中包含了所有运行应用程序所需的文件、配置和依赖项，以及运行时环境。

镜像与容器的概念就和程序与进程的概念是一致的，一个是乐谱，另外一个就是正在演奏的音乐了

4. Docker 仓库(Registry): Docker 仓库是一个用于存储和共享 Docker 镜像的中央存储库，Docker Hub 是一个公共的 Docker 仓库。
5. Dockerfile: Dockerfile 是一个文本文件，其中包含了一组指令，用于自动化构建 Docker 镜像。就和 C 语言中的 Makefile 差不多。
6. Docker Compose: Docker Compose 是一个工具，用于定义和运行多个 Docker 容器组成的应用程序，并管理它们之间的交互。
7. Docker 网络(Network): Docker 网络是一种机制，用于在多个 Docker 容器之间建立网络连接，以实现容器之间的通信。
8. Docker 数据卷(Volume): Docker 数据卷是一种机制，用于在 Docker 容器和主机之间共享数据。
9. Docker daemon：是 Docker 的核心组件之一，也称为 Docker 引擎。它是一个长期运行的后台进程，负责管理 Docker 镜像、容器、网络和存储卷等资源。

图片来源

相关概念如果不理解也没关系，后续实战时看看这些东西到底长啥样，就自然而然就明白了

常用命令

这里简单索引并介绍一下笔者自己常用的一些关于 docker 及 docker-compose 相关的命令，希望对你所有帮助：

命令	作用	备注
docker ps -n 5	查看正在运行的前 5 个容器	数字代表前几个，也可以不加-n，就是所有；就和ps -ef查看正在运行的进程一样
docker rm $(docker ps -a -q)	删除所有已经停止的容器	无
docker tag [镜像 id] [新镜像名称]:[新镜像标签]	根据 id 为某个镜像添加名称及标签	偶尔镜像名字显示<none>时极其有用
略	容器/镜像的导入与导出	参考链接
docker-compose up -d	启动并后台运行	无
docker exec -i -t containerId /bin/bash	进入到容器内部，并启动一个 bash shell，开始交互式操作	CTRL+D 退出

Docker 与 Docker-compose：构建镜像

命令	作用	备注
docker build -t nest-api .	在当前目录.构建镜像，默认使用 Dockerfile 文件	-f 指定任一 Dockerfile 文件；-t 代表镜像名
docker-compose build	在当前目录，通过默认的 docker-compose.yml 文件进行构建	略

一般一个 Dockerfile 对应一个容器，如果我们要部署多个容器，就需要每次运行各个不同的 Dockerfile，为了简化 docker 的复杂操作，就有了 dcoekr-compose，它就可以在其 yml 文件上写多个镜像进行部署容器

还有就是这里有一个 shell 脚本，后续会使用该setup.sh，作用就是每次更新部署时在对应目录运行就可以了：

#!/usr/bin/env bash
#image_version=`date +%Y%m%d%H%M`;

# 关闭容器
docker-compose stop || true;
# 删除容器
docker-compose down || true;
# 构建镜像
docker-compose build;
# 启动并后台运行
docker-compose up -d;
# 查看日志
docker logs nodejs;
# 对空间进行自动清理
docker system prune -a -f

实战

现在，你已经了解了 Docker 的相关概念以及 Docker 的一些常用操作了，下面就进入实战让你练练手并加深理解。

我的项目文件目录如下：

nest-api
├─ .dockerignore
├─ .eslintrc.js
├─ .github
│  └─ workflows
│     └─ ci.yml
├─ .gitignore
├─ .graphqlconfig
├─ .node-version
├─ .prettierrc.json
├─ .vscode
│  └─ extensions.json
├─ docker-compose.db.yml
├─ docker-compose.migrate.yml
├─ docker-compose.yml
├─ Dockerfile
├─ Dockerfile.alpine
├─ LICENSE
├─ nest-cli.json
├─ package-lock.json
├─ package.json
├─ pull-env.sh
├─ .env
├─ README.md
├─ run.sh
├─ setup.sh
├─ src[略]
略...

prisma+nest 应用的 Dockerfile

编写自己的 NestJS 应用需要的 Dockerfile：

FROM node:16-alpine AS builder

# Create app directory
WORKDIR /app

# A wildcard is used to ensure both package.json AND package-lock.json are copied
COPY package*.json ./
COPY prisma ./prisma/

# Install app dependencies
RUN npm install

COPY . .

RUN npm run build

FROM node:16-alpine

WORKDIR /app

COPY --from=builder /app/node_modules ./node_modules
COPY --from=builder /app/package*.json ./
COPY --from=builder /app/dist ./dist

EXPOSE 3000
CMD [ "npm", "run", "start:prod" ]

这些英文单词都是一看就差不多懂得命令这里就不过多赘述了，其中FROM node:16-alpine代表该镜像继承自 node 镜像，毕竟是个 node 应用嘛；apline版本更加轻量，打包体积更小，一般来说不去编写哪些 C++扩展都是够用的。

图片来源

nest 应用+postgresql+niginx 的 yml 配置

此时相当于我们就有我们自己应用的镜像文件了，但其依赖的环境还没有，比如 postgresql；还有就是我需要的 nginx，这些都是有现成的，所以就不用自己构建了，直接使用；但想要将它们弄在一起，就需要编写docker-compose.yml文件，如下：

version: '3.8'
services:
  nest-api:
    container_name: nest-api
    build:
      context: .
      dockerfile: Dockerfile
    ports:
      - '3000:3000'
    depends_on:
      - postgres
    env_file:
      - .env

  postgres:
    image: postgres:13
    container_name: postgres
    restart: always
    ports:
      - '5432:5432'
    env_file:
      - .env
    volumes:
      - postgres:/var/lib/postgresql/data

  nginx:
    image: nginx:stable-alpine      # 指定服务镜像
    container_name: nginx    # 容器名称
    restart: always                 # 重启方式
    ports:                          # 映射端口
      - "80:80"
      - "443:443"
    volumes:                        # 挂载数据卷
      - /etc/localtime:/etc/localtime
      - /home/ubuntu/work/nginx/conf.d:/etc/nginx/conf.d
      - /home/ubuntu/work/nginx/logs:/var/log/nginx
      - /home/ubuntu/work/nginx/cert:/etc/nginx/cert
    depends_on:                     # 启动顺序
      - nest-api

volumes:
  postgres:
    name: nest-db

其中volumes的意思就是让容器中的某个文件与操作系统中的某个文件进行对应，从而做到持久化存储。

配置 niginx

上述中的：

      - /home/ubuntu/work/nginx/conf.d:/etc/nginx/conf.d
      - /home/ubuntu/work/nginx/logs:/var/log/nginx
      - /home/ubuntu/work/nginx/cert:/etc/nginx/cert

冒号前面的路径是我自己在操作系统环境中创建的路径，你也可以根据自己的习惯进行创建，然后对应到容器的路径就可以了

1）conf.d 配置

vim /home/ubuntu/work/nginx/conf.d/default.conf

该文件内容如下：

server {
  listen 443 ssl http2;
  server_tokens off;

  root /var/www/html;
  index index.html index.htm;

  # 修改为自己的域名
  server_name api.example.com;

  client_max_body_size 4M;
  # ssl 证书存放位置
  ssl_certificate /etc/nginx/cert/api.example.com.pem;
  ssl_certificate_key /etc/nginx/cert/api.example.com.key;
  ssl_session_timeout 5m;
  ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:ECDHE:ECDH:AES:HIGH:!NULL:!aNULL:!MD5:!ADH:!RC4;
  ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
  ssl_prefer_server_ciphers on;

  # 访问 / 路径时执行反向代理
  location / {
    # 这里 nodejs 是 node 容器名
    proxy_pass http://nest-api:3000;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header Host $host;
    # 后端的 Web 服务器可以通过 X-Forwarded-For 获取用户真实 IP
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    # 允许客户端请求的最大单文件字节数
    client_max_body_size 15M;
    # 缓冲区代理缓冲用户端请求的最大字节数
    client_body_buffer_size 128k;
  }
}
server {
   listen 80;
   #请填写绑定证书的域名
   server_name api.example.com; 
   #把 http 的域名请求转成 https
   return 301 https://$host$request_uri; 
}

2）cert 文件夹

记得放入你下载的 ssl 证书就可以了。

3）logs

对应的日志，有问题就就cat一下，看里面有 error 不

prisma 的一个踩坑

这是 prisma 需要的 databaseURL：

DATABASE_URL=postgresql://${POSTGRES_USER}:${POSTGRES_PASSWORD}@${DB_HOST}:${DB_PORT}/${POSTGRES_DB}?schema=${DB_SCHEMA}&sslmode=prefer

其中DB_HOST在 nest 运行在本地的时候，比如你启动了 postgresql，然后npm run start:dev，这时候DB_HOST=localhost

而当你 nest 运行在容器中，比如部署的时候docker-compose up -d，就需要改为对应容器的名字postgres

我确实忘改了😭😭😭

最后

笔者在本文主要叙述了如下部分，也可以当作自检清单：

1. docker 是什么
2. docker 的优势，为什么要使用它
3. docker 相关的关键词及概念
4. 常用命令
5. 最后用了现在比较新的一些技术栈部署实践

本文实战部分没有每步都截图演示，假的理由是因为自己试试比啥都好，真实原因是懒得再去运行截图了...

最后希望本文对你有所帮助，如果本文中理解有误或者操作配置不当，也希望互帮互助，在评论区中友善指出...

参考

• 前端全栈之路 - 玩转 Docker (基础)
• 如何通过 Dockerfile 优化 Nestjs 镜像大小
• 使用 Jenkins + Docker + Nginx + MySQL + Redis 自动部署 Node 项目
• 给前端写的 Docker+Node+Nginx+Mongo 的本地开发+部署实战
• 使用 GitHub Actions 完成 Nest 项目自动打包并发布到服务器
• Nestjs | 实践：如何编写生产环境下的 Dockerfile?
• Nest 系列（八）一路坎坷，我实现了最简便的方式打包部署 nestjs+prisma 应用
• Running docker compose up -d (strconv.Atoi: parsing "": invalid syntax)
• Nginx 服务器 SSL 证书安装部署
• Docker Nginx 配置安装 SSL 证书（支持 Https 访问）
• Prisma Migrate: Deploy Migration with Docker