Nginx Docker 入门 – wiki基地

作者： /

Nginx Docker 入门：从概念到实践的深度指南

在现代 Web 开发和运维领域，Nginx 和 Docker 无疑是两个重量级的主角。Nginx 以其高性能、高并发处理能力和灵活的配置成为最受欢迎的 Web 服务器和反向代理服务器之一；而 Docker 则通过容器化技术彻底改变了应用的构建、分发和部署方式，带来了前所未有的便捷性、可移植性和一致性。

将 Nginx 与 Docker 结合使用，能够极大地简化 Nginx 的部署、管理和扩展，同时也让 Nginx 更容易融入到复杂的微服务架构中。本文将带你深入了解如何将 Nginx 容器化，从基础概念讲起，逐步深入到实际操作和高级应用，帮助你轻松跨越 Nginx Docker 入门的门槛。

第一章：为什么选择 Nginx + Docker？理解它们的强大组合

在我们开始技术实操之前，非常有必要理解为什么将 Nginx 容器化是如此流行且具有优势。

1. Nginx：高性能的 Web 服务器和反向代理

简单来说，Nginx (发音 Engine-X) 是一个开源的 Web 服务器软件，也可以用作反向代理、负载均衡器、HTTP 缓存等。与 Apache 等老牌 Web 服务器相比，Nginx 采用了事件驱动的异步架构，使其在处理大量并发连接时表现出色，内存消耗也相对较低。它广泛应用于静态文件服务、动态应用的反向代理、API 网关等场景。

2. Docker：应用的轻量级容器化平台

Docker 是一种容器化技术，它允许开发者将应用程序及其所有依赖项（库、配置文件、其他二进制文件等）打包到一个称为“镜像”（Image）的标准单元中。这个镜像可以被部署到任何支持 Docker 的环境中，并在一个被称为“容器”（Container）的隔离环境中运行。容器提供了进程隔离和资源限制，使得应用可以在一个独立、可预测的环境中运行，不受宿主机或其他容器的影响。

3. Nginx + Docker：强强联合的优势

将 Nginx 运行在 Docker 容器中，可以获得以下核心优势：

  • 环境一致性： 告别“在我的机器上可以运行”的问题。无论是开发、测试还是生产环境，Nginx 容器都运行在完全相同的环境中，大大减少了因环境差异导致的部署问题。
  • 简化部署： 部署一个 Nginx 实例变得异常简单，只需要一条 docker run 命令即可拉取 Nginx 镜像并启动容器，无需在宿主机上安装和配置 Nginx 及其依赖。
  • 快速扩展和缩容： 随着流量的变化，可以轻松地启动或停止 Nginx 容器实例，实现快速的横向扩展和缩容。结合 Docker Swarm 或 Kubernetes 等容器编排工具，这一过程更加自动化。
  • 资源隔离： 每个 Nginx 容器都在自己的隔离环境中运行，拥有独立的进程空间、网络接口等。一个容器的故障不会影响到其他容器或宿主机。
  • 版本管理： Docker 镜像支持标签（Tag），可以轻松管理不同版本的 Nginx 或不同配置的 Nginx 镜像。回滚到旧版本也非常方便。
  • 配置的便捷性： 可以通过挂载卷（Volumes）或构建自定义镜像的方式，将 Nginx 的配置文件和静态文件与容器分离，使得配置的修改和管理更加灵活。
  • 可移植性： Nginx 容器可以在任何安装了 Docker 的机器上运行，无论是物理机、虚拟机还是云平台。

总而言之，Nginx 容器化是构建现代、可扩展、易于管理的 Web 服务架构的基础。

第二章：准备工作 – 安装 Docker

在开始 Nginx Docker 之旅前，你需要先在你的操作系统上安装 Docker。Docker 提供了适用于 Windows、macOS 和各种 Linux 发行版的安装包。

访问 Docker 官方网站（https://www.docker.com/get-started），找到对应你操作系统的安装指南并按照步骤进行安装。安装完成后，打开终端或命令提示符，运行以下命令来验证 Docker 是否安装成功并正在运行：

bash
docker --version
docker info
docker run hello-world

如果 hello-world 容器能够成功运行并输出信息，说明 Docker 环境已经准备就绪。

第三章：运行你的第一个 Nginx 容器

最快体验 Nginx Docker 的方法就是直接从 Docker Hub 拉取官方 Nginx 镜像并运行。Docker Hub 是 Docker 官方的公共镜像仓库，包含了大量常用软件的官方镜像。

1. 拉取 Nginx 镜像

Nginx 的官方镜像托管在 Docker Hub 上。你可以使用 docker pull 命令拉取最新版本的 Nginx 镜像：

bash
docker pull nginx:latest

nginx:latest 表示拉取 nginx 镜像的最新稳定版本。你也可以指定特定的版本，例如 nginx:1.21。如果你在运行容器时本地没有该镜像，Docker 会自动拉取。

2. 运行一个基础 Nginx 容器

使用 docker run 命令来启动一个 Nginx 容器：

bash
docker run -d -p 8080:80 --name my-nginx nginx

让我们分解一下这个命令：

  • docker run: 这是启动一个新容器的命令。
  • -d: 表示以后台（detached）模式运行容器。容器启动后不会占用当前终端，你仍然可以使用终端执行其他命令。
  • -p 8080:80: 这是端口映射（Port Mapping）。它将宿主机的 8080 端口映射到容器内部的 80 端口。Nginx 容器默认监听 80 端口，所以通过这个映射，你可以通过访问宿主机的 8080 端口来访问容器内部的 Nginx 服务。你可以将 8080 替换成宿主机上任意未被占用的端口。
  • --name my-nginx: 为容器指定一个名称，这里是 my-nginx。指定名称方便后续管理（如停止、启动、删除）。如果不指定，Docker 会随机生成一个名称。
  • nginx: 指定要运行的镜像名称，这里使用了默认的 latest 标签，即 nginx:latest。

3. 验证 Nginx 容器

容器启动后，你可以使用以下命令查看正在运行的容器：

bash
docker ps

你应该能看到一个名为 my-nginx 的容器，状态为 Up。

现在，打开你的 Web 浏览器，访问 http://localhost:8080。如果一切正常，你应该会看到 Nginx 的默认欢迎页面，上面写着 “Welcome to nginx!”。

4. 停止和删除容器

要停止这个容器：

bash
docker stop my-nginx

要启动已经停止的容器：

bash
docker start my-nginx

要删除容器（容器必须处于停止状态）：

bash
docker rm my-nginx

如果你想强制删除正在运行的容器（不推荐，除非必要）：

bash
docker rm -f my-nginx

第四章：配置 Nginx 容器 – 两种常用方法

运行默认的 Nginx 容器固然简单，但在实际应用中，你几乎总是需要自定义 Nginx 的配置，例如配置虚拟主机、反向代理、SSL 等。有几种方式可以在 Docker 中配置 Nginx：

方法一：通过卷（Volume）挂载配置文件或目录

这是最灵活、最常用的配置方式，特别适用于开发和快速迭代。通过挂载卷，你可以将宿主机上的配置文件或整个配置目录映射到容器内部 Nginx 读取配置的路径，这样修改宿主机上的文件，容器内的 Nginx 就能读取到最新的配置（通常需要重载配置）。

找到 Nginx 容器的默认配置路径：

Nginx 官方镜像将主配置文件放在 /etc/nginx/nginx.conf，并且通常会在 /etc/nginx/conf.d/ 目录中加载其他配置文件（这是推荐的方式，便于组织）。静态文件默认放在 /usr/share/nginx/html。

你可以通过运行一个临时容器来查看这些路径：

bash
docker run --rm nginx ls /etc/nginx/
docker run --rm nginx ls /usr/share/nginx/

创建自定义配置文件：

在宿主机上创建一个目录，例如 ~/nginx-config，并在其中创建一个 nginx.conf 文件或在 conf.d 子目录中创建 .conf 文件。

例如，创建一个简单的 ~/nginx-config/nginx.conf 文件，用来改变默认的欢迎页内容：

“`nginx

~/nginx-config/nginx.conf

worker_processes 1;

events {
worker_connections 1024;
}

http {
include mime.types;
default_type application/octet-stream;

sendfile        on;
keepalive_timeout 65;

server {
    listen 80;
    server_name localhost;

    location / {
        # 指定新的根目录，我们稍后会挂载静态文件到这里
        root /usr/share/nginx/html;
        index index.html;
    }

    # 可以在这里添加其他location块用于反向代理等
    # location /api/ {
    #     proxy_pass http://backend-service:8000/;
    # }
}

}
“`

或者，更常见的做法是在 conf.d 目录下创建单独的虚拟主机配置文件。例如，创建一个 ~/nginx-config/conf.d/default.conf 文件：

“`nginx

~/nginx-config/conf.d/default.conf

server {
listen 80;
server_name localhost; # 或者你的域名

location / {
    # Nginx 容器默认加载 /etc/nginx/conf.d/*.conf
    # 所以这个文件会被包含进来
    # 指定新的根目录，我们稍后会挂载静态文件到这里
    root /usr/share/nginx/html;
    index index.html;
}

# 可以添加其他配置，比如反向代理：
# location /api/ {
#     proxy_pass http://your-backend-service:port;
# }

}
``
（注意：如果你使用conf.d的方式，并且不挂载nginx.conf主配置文件，那么默认的nginx.conf会被使用，它通常会包含include /etc/nginx/conf.d/*.conf;这行，这样你的default.conf才能生效。挂载整个conf.d目录比只挂载nginx.conf` 更常见。）

创建静态文件：

在宿主机上创建另一个目录，例如 ~/my-website，并在其中创建一个 index.html 文件：

“`html





Welcome to My Nginx Container!

Hello from Dockerized Nginx!

This is a custom page served by Nginx in a Docker container.


“`

运行容器并挂载卷：

使用 docker run 命令，并通过 -v 参数挂载你创建的配置目录和静态文件目录。-v 参数的格式是 宿主机路径:容器路径。

bash
docker run -d -p 8080:80 \
--name my-nginx-with-config \
-v ~/nginx-config/conf.d:/etc/nginx/conf.d \
-v ~/my-website:/usr/share/nginx/html \
nginx

这个命令做了以下几件事：
* 以后台模式运行容器 (-d)。
* 将宿主机 8080 端口映射到容器 80 端口 (-p 8080:80)。
* 将宿主机 ~/nginx-config/conf.d 目录挂载到容器内的 /etc/nginx/conf.d 目录 (-v ~/nginx-config/conf.d:/etc/nginx/conf.d)。这将用你自定义的 conf.d 内容替换容器中原有的内容。
* 将宿主机 ~/my-website 目录挂载到容器内的 /usr/share/nginx/html 目录 (-v ~/my-website:/usr/share/nginx/html)。这将用你自定义的静态文件替换容器中原有的默认页面。
* 将容器命名为 my-nginx-with-config。
* 使用 nginx 镜像。

验证配置：

现在访问 http://localhost:8080，你应该能看到你在 ~/my-website/index.html 中创建的自定义页面。

优点： 方便修改配置和静态文件，无需重新构建镜像，适合开发和测试。
缺点： 配置文件和静态文件依赖于宿主机的文件系统，容器的可移植性略有降低（在不同机器上运行需要确保宿主机路径和文件存在），不适合将配置作为镜像的一部分进行版本管理。

方法二：构建自定义 Docker 镜像

这种方法是将你的自定义配置文件和静态文件直接打包进一个新的 Docker 镜像中。这使得镜像更加自给自足，具有更好的可移植性，并且可以将 Nginx 配置的版本与镜像版本绑定，适合生产环境部署。

创建 Dockerfile：

在你的项目根目录（例如 ~/my-dockerized-nginx）创建一个名为 Dockerfile 的文件（注意大小写，没有文件扩展名）。同时，将你的自定义 Nginx 配置文件（例如 conf.d/default.conf）和静态文件（例如 html/index.html）放在该目录下。

~/my-dockerized-nginx/
├── Dockerfile
├── conf.d/
│ └── default.conf
└── html/
└── index.html

Dockerfile 内容如下：

“`dockerfile

Dockerfile

基于官方的 Nginx 镜像

FROM nginx:latest

将宿主机上的自定义配置文件复制到容器内 Nginx 的配置目录

COPY <宿主机路径> <容器路径>

COPY conf.d/default.conf /etc/nginx/conf.d/default.conf

将宿主机上的静态文件复制到容器内 Nginx 提供服务的根目录

COPY html/index.html /usr/share/nginx/html/index.html

暴露容器内部的 80 端口 (文档说明，非必需，但建议)

EXPOSE 80

CMD 指定容器启动时运行的命令，官方 Nginx 镜像已经指定了启动 Nginx 的命令，所以通常不需要在这里重复指定

但如果你需要覆盖默认启动命令，可以在这里写，例如 CMD [“nginx”, “-g”, “daemon off;”]

这里我们保留官方镜像的默认启动命令，所以这一行可以省略或注释掉

CMD [“nginx”, “-g”, “daemon off;”]

“`

构建 Docker 镜像：

在 Dockerfile 所在的目录（~/my-dockerized-nginx）打开终端，运行 docker build 命令：

bash
docker build -t my-custom-nginx:v1 .

分解命令：
* docker build: 构建 Docker 镜像的命令。
* -t my-custom-nginx:v1: 为构建的镜像指定一个标签（tag）。my-custom-nginx 是镜像名称，v1 是标签（版本号）。命名规范通常是 [用户名/][镜像名]:[标签]。这里的 . 表示使用当前目录下的 Dockerfile 来构建镜像。

Docker 会读取 Dockerfile 中的指令，一步步执行构建过程。成功后，你可以使用 docker images 命令查看你刚刚构建的镜像。

运行自定义镜像的容器：

现在，使用你刚刚构建的镜像来运行容器：

bash
docker run -d -p 8080:80 --name my-custom-nginx-container my-custom-nginx:v1

这个命令与之前类似，只是将镜像名称换成了 my-custom-nginx:v1。注意，这次我们不再需要挂载配置文件和静态文件的卷，因为它们已经打包进了镜像。

验证：

访问 http://localhost:8080，你应该同样看到自定义的欢迎页面。

优点： 镜像自包含配置和文件，具有更好的可移植性和一致性，配置和应用代码一同版本化管理，适合 CI/CD 流水线。
缺点： 修改配置或静态文件后，需要重新构建镜像并重新创建或更新容器，流程相对复杂一些。

总结两种配置方法：

  • 卷挂载： 适合本地开发、快速调试、频繁修改配置或静态文件的情况。配置在宿主机上管理。
  • 构建自定义镜像： 适合生产环境部署、CI/CD、将配置作为应用版本一部分进行管理的情况。配置打包在镜像中。

在实际应用中，你可能会结合使用这两种方法。例如，构建一个包含基础配置的镜像，然后通过挂载卷的方式注入环境变量或敏感配置。

第五章：进阶应用：Nginx 作为反向代理

Nginx 最常见的用途之一是作为反向代理服务器，将外部请求转发给内部的应用程序服务（如 Node.js, Python Django/Flask, Java Spring Boot 等）。在 Docker 环境下，这通常意味着 Nginx 容器需要与其他的应用容器进行通信。

利用 Docker 网络：

为了让 Nginx 容器能够通过容器名称访问其他应用容器，最好将它们连接到同一个自定义的 Docker 网络中，而不是使用默认的 bridge 网络。

  1. 创建自定义网络：

    bash
    docker network create my-app-network

  2. 运行应用容器（例如一个简单的 Web 服务）：
    假设你有一个简单的 Flask 应用，打包成了 my-flask-app:latest 镜像，它监听 5000 端口。

    bash
    docker run -d --name flask-app --network my-app-network my-flask-app:latest
    通过 --network my-app-network 参数将容器连接到自定义网络。在同一个网络中的容器可以通过容器名称相互访问。

  3. 运行 Nginx 容器作为反向代理：

    创建一个 Nginx 配置文件 ~/nginx-proxy-config/conf.d/proxy.conf：

    “`nginx

    ~/nginx-proxy-config/conf.d/proxy.conf

    server {
    listen 80;
    server_name localhost; # 或你的域名

    location / {
    # 将请求转发到同一个网络中名为 flask-app 的容器的 5000 端口
    proxy_pass http://flask-app:5000;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}

# 你也可以配置其他路径转发到不同的后端服务
# location /api/v2/ {
#     proxy_pass http://another-service:8080/;
# }

    }
    “`

    运行 Nginx 容器，同样连接到 my-app-network，并挂载这个配置文件：

    bash
    docker run -d -p 80:80 \
    --name nginx-proxy \
    --network my-app-network \
    -v ~/nginx-proxy-config/conf.d:/etc/nginx/conf.d \
    nginx
    这里将宿主机的 80 端口映射到 Nginx 容器的 80 端口。

现在，当你访问 http://localhost 时，请求会进入 nginx-proxy 容器，然后被 Nginx 反向代理到 flask-app 容器的 5000 端口。

使用 Docker Compose：

对于包含多个服务（如 Nginx、Web 应用、数据库）的应用，使用 Docker Compose 来定义和管理整个应用栈会更加便捷。Docker Compose 使用一个 YAML 文件来配置应用的服务、网络和卷。

创建一个 docker-compose.yml 文件：

“`yaml

docker-compose.yml

version: ‘3.8’

services:
nginx:
image: nginx:latest
container_name: nginx-proxy
ports:
– “80:80”
volumes:
– ./nginx-proxy-config/conf.d:/etc/nginx/conf.d # 挂载 Nginx 配置
# – ./my-website:/usr/share/nginx/html # 如果需要提供静态文件，也可以挂载
networks:
– app-network # 连接到同一个网络

webapp:
# 使用你的应用镜像
image: my-flask-app:latest
container_name: flask-app
# ports:
# – “5000:5000” # 通常后端服务不需要将端口暴露给宿主机，只需要在容器网络中可访问
networks:
– app-network # 连接到同一个网络
# 如果应用需要访问数据库或其他服务，也在此处定义并连接到 app-network

定义网络

networks:
app-network:
driver: bridge # 使用默认的 bridge 驱动即可
“`

在 docker-compose.yml 文件所在的目录，运行以下命令启动所有服务：

bash
docker-compose up -d

这会创建并启动 app-network 网络、webapp 容器和 nginx 容器，并将 Nginx 容器的配置挂载进去。在 Nginx 容器中，你可以通过服务名 webapp 来访问应用容器。

Docker Compose 极大地简化了多容器应用的部署和管理，是 Nginx Docker 进阶使用的重要工具。

第六章：深入和故障排除

在使用 Nginx Docker 时，可能会遇到一些问题。以下是一些常见场景和排查方法：

1. 访问 Nginx 容器内部：

如果需要查看 Nginx 容器内的文件、日志或执行命令，可以使用 docker exec 命令：

bash
docker exec -it my-nginx bash # 进入容器的 bash 终端
-it 参数用于分配一个伪终端并保持标准输入打开，这样你就可以在容器内交互式地执行命令。

2. 查看 Nginx 容器日志：

Nginx 容器将访问日志和错误日志输出到标准输出（stdout）和标准错误（stderr），这样 Docker 可以捕获它们。使用 docker logs 命令查看日志：

bash
docker logs my-nginx
docker logs -f my-nginx # 实时跟踪日志

3. Nginx 配置错误：

如果 Nginx 容器启动失败或无法正常工作，很可能是配置文件有误。你可以通过 docker logs 查看启动日志，Nginx 通常会报告配置文件中的错误。

或者，可以在启动容器前，使用 nginx -t 命令检查配置文件的语法：

“`bash

假设你使用卷挂载配置，先启动一个临时容器并挂载配置

docker run –rm -v ~/nginx-config:/etc/nginx:ro nginx nginx -t

–rm 容器停止后自动删除

:ro 将卷挂载为只读，避免容器修改宿主机文件

nginx -t 是 Nginx 检查配置语法和连接测试的命令

“`

如果配置有误，这个命令会输出详细的错误信息。

4. 端口冲突：

确保你在 docker run -p 中指定的宿主机端口没有被其他程序占用。你可以使用操作系统的工具（如 netstat 或 lsof）检查端口占用情况。

5. 卷挂载问题：

  • 确保宿主机上的文件/目录路径是正确的。
  • 确保容器内的挂载点路径是正确的（例如 Nginx 配置默认在 /etc/nginx 或 /usr/local/nginx，静态文件默认在 /usr/share/nginx/html）。
  • 检查文件权限。有时，宿主机上的文件权限可能导致容器内的 Nginx 用户无法读取。确保 Nginx 用户（通常是 nginx 或 www-data）在容器内对挂载的文件有读取权限。

6. 容器网络问题：

  • 如果 Nginx 作为反向代理无法访问后端服务，检查它们是否在同一个 Docker 网络中 (docker network inspect <network_name>)。
  • 确保你在 Nginx 配置中使用的后端服务地址（例如 flask-app:5000）是后端容器在网络中的名称和端口。

第七章：展望未来 – 持续学习和优化

Nginx Docker 的入门仅仅是开始，你可以进一步探索：

  • HTTPS/SSL 配置： 在 Nginx 容器中配置 SSL 证书，实现 HTTPS 访问。通常会使用 Let’s Encrypt 和 Certbot， Certbot 也有官方的 Docker 镜像，可以结合使用。
  • 负载均衡： 配置 Nginx 容器作为负载均衡器，分发流量到多个后端应用容器实例。
  • 缓存配置： 利用 Nginx 的缓存功能提升静态资源或 API 响应的速度。
  • 日志管理： 将 Nginx 容器的日志收集到集中的日志管理系统（如 ELK Stack, Grafana Loki）中。
  • 监控： 监控 Nginx 容器的性能指标，如连接数、请求率等。
  • Docker Compose 进阶： 学习 Docker Compose 的更多功能，如环境变量、depends_on、健康检查等。
  • 容器编排： 学习 Kubernetes 或 Docker Swarm 等容器编排平台，实现 Nginx 容器的高可用、自动化扩展和管理。
  • 安全加固： 运行 Nginx 容器时注意安全事项，如避免以 root 用户运行，设置资源限制等。

结语

通过本文的学习，你应该已经掌握了将 Nginx 容器化的基础知识和常用操作方法，包括运行基本容器、通过卷挂载和构建自定义镜像进行配置、以及将其作为反向代理与后端服务结合使用。Nginx 和 Docker 的结合，能够极大地提升你的 Web 服务部署和管理效率。

容器化是现代 IT 领域不可逆转的趋势。掌握如何在 Docker 中运行和管理 Nginx，不仅能让你更轻松地处理当前的 Web 服务需求，也为你进一步学习容器编排等更高级的技术打下了坚实的基础。

现在，就开始你的 Nginx Docker 实践之旅吧！不断尝试和学习，你会发现这套组合的强大之处。

发表评论

您的邮箱地址不会被公开。 必填项已用 * 标注

滚动至顶部