Docker + Nginx 部署配置

下面这 4 个文件通常是一套 Docker + Nginx 部署配置 。它们各司其职:Dockerfile 负责"怎么构建镜像",docker-compose.yml 负责"怎么编排和启动容器",nginx.conf 负责"Nginx 怎么转发/服务请求",.dockerignore 负责"构建镜像时哪些文件不要带进去"。

文件 主要作用 可以理解为
Dockerfile 定义 Docker 镜像如何构建 应用的"镜像制作说明书"
nginx.conf 定义 Nginx 的运行配置 Web 服务器 / 反向代理的"路由规则"
docker-compose.yml 定义多个容器如何一起运行 本地/服务器部署的"一键启动配置"
.dockerignore 排除不需要参与镜像构建的文件 Docker 版 .gitignore

1. Dockerfile

Dockerfile 是一个文本文件,里面写的是构建 Docker 镜像的指令。Docker 官方文档说,Docker 会读取 Dockerfile 中的指令来自动构建镜像;它本质上包含了你原本可能在命令行里一步步执行的构建命令。(Docker Documentation)

常见作用包括:

dockerfile 复制代码
FROM node:20-alpine
WORKDIR /app
COPY package*.json ./
RUN npm install
COPY . .
RUN npm run build
CMD ["npm", "start"]

它通常负责:

  1. 指定基础环境,比如 node、python、nginx。
  2. 拷贝项目代码到镜像中。
  3. 安装依赖。
  4. 执行构建命令。
  5. 指定容器启动后运行什么命令。

在你的这组文件里,Dockerfile 很可能用于构建前端项目、后端项目,或者自定义 Nginx 镜像。

2. nginx.conf

nginx.conf 是 Nginx 的主配置文件。Nginx 官方文档说明,Nginx 及其模块的行为由配置文件中的指令决定;默认配置文件通常叫 nginx.conf,可能位于 /usr/local/nginx/conf、/etc/nginx 或 /usr/local/etc/nginx。(Nginx)

它常用于配置:

nginx 复制代码
server {
    listen 80;

    location / {
        root /usr/share/nginx/html;
        index index.html;
    }

    location /api/ {
        proxy_pass http://backend:3000/;
    }
}

常见作用包括:

  1. 配置监听端口,例如 80、443。
  2. 配置静态资源目录,例如前端打包后的 dist。
  3. 配置反向代理,例如把 /api 请求转发给后端服务。
  4. 配置 HTTPS、缓存、压缩、日志。
  5. 配置多站点、多域名、多路径转发。

Nginx 本身可以作为 HTTP Web 服务器、反向代理、缓存、负载均衡器、TCP/UDP 代理等。(Nginx)

在 Docker 项目里,nginx.conf 经常配合 Dockerfile 或 docker-compose.yml 使用,比如把本地的 nginx.conf 挂载到容器里的 /etc/nginx/nginx.conf 或 /etc/nginx/conf.d/default.conf。

3. docker-compose.yml

docker-compose.yml 是 Docker Compose 的配置文件,用 YAML 格式描述一个应用由哪些服务组成。Docker 官方文档说明,Compose 文件用于配置 Docker 应用的 services、networks、volumes 等内容。(Docker Documentation)

一个典型例子:

yaml 复制代码
services:
  nginx:
    image: nginx:alpine
    ports:
      - "80:80"
    volumes:
      - ./nginx.conf:/etc/nginx/conf.d/default.conf
    depends_on:
      - app

  app:
    build: .
    expose:
      - "3000"

它通常负责:

  1. 定义有哪些容器服务,比如 nginx、frontend、backend、mysql、redis。
  2. 指定服务使用哪个镜像,或者从哪个 Dockerfile 构建。
  3. 配置端口映射,比如 80:80、3000:3000。
  4. 配置数据卷挂载,比如挂载配置文件、数据库数据目录。
  5. 配置容器之间的依赖关系。
  6. 配置网络,使服务之间可以通过服务名互相访问。

官方 Compose 规范中也提到,Compose 文件是一个 YAML 文件,核心结构通常包括 services,也可以包括 networks、volumes、configs、secrets 等。(GitHub)

在你的这组文件里,docker-compose.yml 很可能是启动整个项目的入口,例如:

bash 复制代码
docker compose up -d

4. .dockerignore

.dockerignore 用来告诉 Docker:构建镜像时,哪些文件或目录不要发送到构建上下文里。Docker 官方文档说明,构建上下文中可以使用 .dockerignore 文件排除文件和目录。(Docker Documentation)

典型内容:

dockerignore 复制代码
node_modules
.git
.env
dist
.DS_Store
*.log

它的作用主要是:

  1. 减小 Docker 构建上下文。
  2. 加快镜像构建速度。
  3. 避免把无关文件复制进镜像。
  4. 避免泄露敏感文件,比如 .env、私钥、日志。
  5. 避免把本地依赖目录,如 node_modules,带进镜像。

它和 .gitignore 很像,但作用对象不同:

文件 作用对象
.gitignore Git 提交时忽略哪些文件
.dockerignore Docker 构建镜像时忽略哪些文件

这四个文件之间的关系

可以按部署流程这样理解:

text 复制代码
.dockerignore
   ↓
过滤不需要参与构建的文件

Dockerfile
   ↓
根据项目代码构建 Docker 镜像

nginx.conf
   ↓
配置 Nginx 如何访问静态文件、转发 API、监听端口

docker-compose.yml
   ↓
把 Nginx、应用、数据库等服务组合起来,一键启动

一个常见前端项目部署流程可能是:

  1. .dockerignore 排除 node_modules、.git、日志等文件。
  2. Dockerfile 构建前端项目,生成 dist。
  3. nginx.conf 配置 Nginx,把 dist 作为静态网站目录,并把 /api 转发给后端。
  4. docker-compose.yml 启动 Nginx 容器、后端容器、数据库容器。

简单说:

text 复制代码
Dockerfile:做镜像
docker-compose.yml:跑容器
nginx.conf:管请求
.dockerignore:减负和防泄露
相关推荐
伞伞悦读32 分钟前
【第92期】逻辑回归的分数概率与阈值的实验与排查
人工智能·python·深度学习·机器学习
7177771 小时前
互联网企业研发平台推荐:从工具堆叠到一体化协同的选型逻辑
人工智能·gitee
立青.2 小时前
AI大模型术语
人工智能
土豆12504 小时前
你只说要什么,它负责拆活交付:任务编排插件上手指南
人工智能·llm
GoldenSpider.AI6 小时前
讲透 Claude Code 的 Code Mode:原理、流程、用法与 24 轮实测
人工智能·ai编程·claude code
oak隔壁找我6 小时前
一款运行在 DSH(DeepSeek Harness)中的工作区文件管理插件
人工智能
江屿风6 小时前
AI Agent架构全解析:从规划到记忆的智能跃迁
人工智能·笔记·架构·agent·c/s·mcp工作流
ZONGYUAN-ROOT6 小时前
【API配额】多源 LLM API 配额池化实战:轮换调度、变化量监控、故障自愈一套方案(Python 完整实现)
人工智能
syso_稻草人6 小时前
qwen-image-2.1 高清放大拆解:Qwen21LatentUpscale 潜空间 2x + denoise 0.35 修细节,12 组场景实测
人工智能·stable diffusion·prompt·comfyui·qwen-image2.1