异常教程

docker nginx（保姆级教程）

更新时间:

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战(已更新的所有项目都能学习) / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

  • 新开坑项目:《Spring AI 项目实战》 正在持续爆肝中，基于 Spring AI + Spring Boot 3.x + JDK 21...， 点击查看 ;
  • 《从零手撸：仿小红书（微服务架构）》 已完结，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;演示链接： http://116.62.199.48:7070 ;
  • 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 90w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 3100+ 小伙伴加入学习 ，欢迎点击围观

在现代 Web 开发中，Docker 与 Nginx 的结合已成为构建高效、灵活应用架构的核心工具组合。Docker 的容器化技术简化了环境一致性问题，而 Nginx 作为高性能的 Web 服务器和反向代理，能够高效处理流量分发与静态资源托管。本文将从零开始，通过循序渐进的案例与代码示例，帮助编程初学者和中级开发者掌握如何利用 Docker 包装 Nginx，并实现实际场景中的应用部署。

2.1 Docker 与 Nginx 的基础概念

Docker：轻量级的“集装箱”

Docker 是一种容器化技术，允许开发者将应用程序及其依赖项打包到一个独立的容器中。想象一个集装箱：无论运输到哪个港口，内部物品的摆放方式都不会改变。Docker 容器同样如此，它将代码、运行时环境、库文件等打包为一个可移植的单元，确保在不同环境中运行结果一致。

Nginx：灵活的“交通指挥官”

Nginx 是一款开源软件，主要作为 Web 服务器、反向代理服务器和负载均衡器。它可以将客户端请求分发到多个后端服务，或高效处理静态文件（如图片、HTML 文件）。类比为交通指挥中心，Nginx 能根据规则引导车流（请求）到合适的出口（服务端点）。

两者的协同优势

  • 环境一致性：Docker 容器确保 Nginx 在开发、测试和生产环境中的配置完全一致。
  • 资源隔离：每个 Nginx 实例运行在独立的容器中，避免进程或端口冲突。
  • 快速部署：通过预定义的 Docker 镜像，可一键启动 Nginx 服务。

2.2 快速入门：在 Docker 中运行 Nginx

安装 Docker 环境

在开始前，需确保已安装 Docker。不同操作系统下的安装步骤可通过 Docker 官方文档 查阅。

拉取 Nginx 镜像

使用以下命令从 Docker Hub 获取官方 Nginx 镜像：

docker pull nginx

启动第一个 Nginx 容器

运行以下命令启动容器，并将容器的 80 端口映射到本地 80 端口：

docker run -d --name my-nginx -p 80:80 nginx
  • -d：后台运行容器
  • --name：指定容器名称为 my-nginx
  • -p：端口映射，格式为 本地端口:容器端口

此时访问 http://localhost，即可看到 Nginx 的默认欢迎页面。

2.3 配置 Nginx 的常用场景与代码示例

场景 1：自定义静态文件托管

若需托管自定义 HTML 文件，可将本地目录挂载到容器中：

docker run -d --name custom-nginx \  
  -v /path/to/your/html:/usr/share/nginx/html \  
  -p 80:80 nginx

其中：

  • -v 参数将本地 /path/to/your/html 目录挂载到容器的 /usr/share/nginx/html（Nginx 默认静态文件目录）。

场景 2：反向代理与负载均衡

假设有一个本地开发服务运行在 localhost:3000，可通过 Nginx 将 /api 路径的请求转发至此服务：

步骤 1：创建自定义 Nginx 配置文件

server {  
    listen 80;  
    server_name example.com;  

    location /api {  
        proxy_pass http://localhost:3000;  
        proxy_set_header Host $host;  
        proxy_set_header X-Real-IP $remote_addr;  
    }  
}

步骤 2：启动容器并挂载配置

docker run -d --name proxy-nginx \  
  -v /path/to/my_nginx.conf:/etc/nginx/conf.d/default.conf \  
  -p 80:80 nginx

此时访问 http://localhost/api，请求会被转发到本地的 3000 端口服务。

2.4 进阶技巧：持久化存储与多容器协作

技巧 1：数据卷（Volumes）持久化配置

若希望 Nginx 配置在容器重启后仍保留，可使用数据卷：

docker volume create nginx-config  

docker run -d --name vol-nginx \  
  -v nginx-config:/etc/nginx/conf.d \  
  -p 80:80 nginx

技巧 2：通过 Docker Compose 管理多服务

使用 docker-compose.yml 文件定义 Nginx 及后端服务：

version: '3'  
services:  
  backend:  
    image: my-backend-app  
    ports:  
      - "3000:3000"  

  nginx:  
    image: nginx  
    ports:  
      - "80:80"  
    volumes:  
      - ./nginx.conf:/etc/nginx/conf.d/default.conf  
    depends_on:  
      - backend

运行 docker-compose up 即可启动所有服务，Nginx 会自动代理到 backend 容器。

2.5 常见问题与解决方案

问题 1：端口冲突

若启动容器时提示端口被占用，可修改映射端口：

docker run -p 8080:80 nginx  # 将本地 8080 映射到容器 80

问题 2：配置文件语法错误

Nginx 配置错误会导致容器退出。通过以下命令查看日志：

docker logs my-nginx

若出现 nginx: [emerg] ... 错误，需检查配置文件语法（如缺少分号或缩进错误）。

结论

通过本文，读者应已掌握如何利用 Docker 快速部署 Nginx，并实现静态文件托管、反向代理等核心功能。从基础命令到进阶的多容器协作，Docker 提供了高度灵活的解决方案，而 Nginx 则凭借其高性能与配置灵活性，成为现代应用架构中的关键组件。

对于开发者而言，结合 Docker 与 Nginx 能显著提升开发效率与部署稳定性。建议读者通过实际项目练习，例如搭建一个包含多个后端服务的微服务架构，并通过 Nginx 实现动态路由与负载均衡。持续实践将帮助你更好地掌握这一工具链的强大能力。

最新发布

查看更多文章