什么是docker ？#

可以简单理解为一种轻量化的虚拟机。它不需要像虚拟机那样完整的重新虚拟一个新的操作系统$\rightarrow$更轻量化。

docker同样具有复用性高、拓展性强等优点。

项目概要#

我想要部署的系统是前后端分离的，大致可以分为由vue3实现的前端部分+ASP.Net Core实现的后端部分+SQL的数据库部分。

由于Docker 和容器化技术的核心原则之一：每个容器只运行一个进程/服务$\rightarrow$我起码需要$3$个容器一起运行，所以简单的单一容器技术满足不了我的需求，最后采用docker compose技术实现。

Dockerfile#

Dockerfile是一个文本文件，其中包含了一系列用于自动化构建 Docker 镜像的指令。

Docker 会读取 Dockerfile 中的指令，一步一步地执行这些指令，最终生成一个可运行的 Docker 镜像。这个镜像包含了应用程序代码、运行时、库、依赖以及运行应用程序所需的一切。

Docker Compose#

docker-compose.yml文件是一种组织多个docker镜像一起工作的yaml文件。通过使用 docker compose up命令，就可以创建并启动所有服务。

坑一：前端 API 路径不对？Nginx 反向代理来拯救！#

后端同时监听了两个端口，一个是HTTP下的5070端口，另一个是HTTPS的7069端口。

前端代码中配置了 basePath，通过如下⬇️方式指定了后端接口地址：

constapi = newEmployeeApi(
  newConfiguration({
    basePath:'https://localhost:7069',
    // eslint-disable-next-line @typescript-eslint/no-unused-vars
    accessToken: (name?: string, scopes?: string[]) => {
      if (name === 'Bearer') {
        returnuser.token + '';
      }
      return'';
    },
    middleware: [loginMiddleWare],
  })
);

上述写法在本地开发环境下运行良好，但当前后端被分别打包进独立容器并部署后，问题就出现了：前端无法成功请求后端 API 并获取数据。这是因为 basePath 中写死了 https://localhost:7069，在容器中，前端实际上是在访问其自身容器的 7069 端口，而不是后端容器。由于前后端运行在两个完全隔离的容器中，使用 localhost：7069 无法实现跨容器通信。

此时，选择Nginx做网关进行反向代理是一个好的选择。

反向代理（Reverse Proxy）是一个位于客户端和服务器之间的中间服务，它的作用是代表客户端向后端服务器转发请求

Nginx配置的方法：

1. 项目根目录下按照如下文件结构创建相关文件夹和文件

project/ 
├── docker-compose.yml 
└── nginx/ 
    └── nginx.conf <-- 创建这个文件 
    └── conf.d/ <-- 创建这个目录
        └── default.conf <-- 创建这个文件

2. 分别在 nginx.conf和 default.conf文件中写好对应的配置内容
3. 需要在 docker compose.yml中添加Nginx的部分

nginx:
    image: nginx:latest
    container_name: card-nginx
    restart: always
    ports:
      - "80:80"      # 将宿主机的 80 端口映射到 Nginx 容器的 80 端口
     # - "443:443"   # 如果需要 HTTPS, 可以取消注释此行，并配置 SSL 证书
    volumes:
     # 挂载宿主机上的 Nginx 主配置文件
      - ./nginx/nginx.conf:/etc/nginx/nginx.conf:ro
     # 挂载宿主机上的 Nginx server block 配置目录
      - ./nginx/conf.d:/etc/nginx/conf.d:ro
    depends_on:
      - frontend  
      - backend  
    networks:
      - card-network

4. 端 API 客户端 basePath: 替换为 http://localhost/api

坑二：MySQL 容器启动了，数据库却是空的？#

当我解决了上一个问题后，前端容器中仍然返回了500错误。查看后端服务的log后发现数据库已经连接成功了，但表格不存在。

MySql.Data.MySqlClient.MySqlException (0x80004005): Table 'card.employee' doesn't exist

通过Navicat连接Mysql映射端口查看发现其中确实一张数据表都没有，但本地开发时实际表格都存在。它背后通常隐藏着一个关键的认知差异：你连接的数据库，可能并不是你以为的那个。

project/
├── docker-compose.yml
├── nginx/
├── Card.Backend/
├── card-frontend/
└── mysql-init/        # <--- 新建的目录
    └── init.sql       # <--- 导出的 SQL 文件放这里

  services:
     mysql:
       image: mysql:8.0
       container_name: card-mysql
       restart: always
       environment:
         MYSQL_ROOT_PASSWORD: 123456
         MYSQL_DATABASE: card
       ports:
         - "3307:3306"
       volumes:
         - mysql_data:/var/lib/mysql           # 数据持久化卷
         - ./mysql-init:/docker-entrypoint-initdb.d:ro# <--- 添加这一行
       networks:
         - card-network
   # ... 其他服务和卷/网络定义