系列文章目录

---

前言

在现代 Web 开发中，Nginx 是一个广泛使用的高性能 Web 服务器，它不仅可以用于反向代理，还能作为负载均衡器、HTTP 缓存等。通过 Docker 部署 Nginx，不仅能够简化安装过程，还能轻松进行配置和管理。

本篇文章将指导你通过 Docker 快速搭建一个 Nginx 环境，并讲解如何修改配置文件以定制化你的服务器设置。

---

一、准备工作

首先，确保你的系统上已经安装了 Docker。

Linux上进行Docker安装有两种方式：

1. Docker自动化安装
2. Docker手动安装

可以根据该文章的步骤进行安装：https://blog.csdn.net/weixin_44876263/article/details/136714078?spm=1001.2014.3001.5502

二、设置 Nginx 容器的目录结构

为了便于管理，我们首先创建一个目录结构，用于存放 Nginx 配置文件、日志文件和 HTML 文件。

# 安装路径
DIR="/opt/docker/demo"
DOCKER_NAME="docker-nginx"

# 创建目录结构
mkdir -p "$DIR/nginx/conf"
mkdir -p "$DIR/nginx/log"
mkdir -p "$DIR/nginx/html"

• conf：存放 Nginx 的主配置文件和自定义配置文件。
• log：存放 Nginx 的日志文件。
• html：存放静态网站文件。

三、启动一个临时的 Nginx 容器来复制配置文件

我们需要一个基础的 Nginx 配置文件，Docker 官方镜像已经内置了标准配置文件。为了方便地获取并修改这些配置文件，我们首先启动一个临时的 Nginx 容器。

# 启动一个临时的 nginx 容器来复制配置文件
docker run --name nginx_test -p 9011:80 -d nginx:stable-alpine

这个命令会启动一个 nginx:stable-alpine 容器，并将其 80 端口映射到宿主机的 9011 端口。我们可以通过访问 http://localhost:9011 来查看默认的 Nginx 欢迎页面。

四、复制 Nginx 配置文件到本地目录

接下来，我们将容器内的 Nginx 配置文件复制到本地，以便进行自定义修改。使用以下命令将 nginx.conf 文件和 conf.d 配置目录复制到宿主机的 $DIR/nginx/conf 目录中：

# 复制 nginx 配置文件到本地目录
docker cp nginx_test:/etc/nginx/nginx.conf "$DIR/nginx/conf/nginx.conf"
docker cp nginx_test:/etc/nginx/conf.d "$DIR/nginx/conf/conf.d"

这样，我们就获取到了 Nginx 的配置文件，并且可以根据需要进行修改。

五、删除临时 Nginx 容器

复制完配置文件后，我们不再需要这个临时的 Nginx 容器，因此可以将其删除：

# 删除临时 nginx 容器
docker rm -f nginx_test

六、创建并运行 Nginx 容器，挂载本地目录

现在，我们可以使用自己的配置文件来启动一个持久化的 Nginx 容器。通过将本地目录挂载到容器中，我们可以确保配置文件、日志和网站文件持久化存储在宿主机上。

以下是启动 Nginx 容器的命令：

docker run -d \
  --restart=always \
  --name "$DOCKER_NAME" \
  --network host \
  -v "$DIR/nginx/conf/nginx.conf:/etc/nginx/nginx.conf" \
  -v "$DIR/nginx/conf/conf.d:/etc/nginx/conf.d" \
  -v "$DIR/nginx/log:/var/log/nginx" \
  -v "$DIR/nginx/html:/opt/html" \
  nginx:stable-alpine

解释各个参数：

• -d：后台运行容器。
• --restart=always：容器在崩溃或系统重启后自动重启。
• --name "$DOCKER_NAME"：容器的名称为 docker-nginx。
• --network host：容器将使用宿主机的网络栈。
• -v "$DIR/nginx/conf/nginx.conf:/etc/nginx/nginx.conf"：挂载自定义的 nginx.conf 配置文件到容器中。
• -v "$DIR/nginx/conf/conf.d:/etc/nginx/conf.d"：挂载自定义的配置目录。
• -v "$DIR/nginx/log:/var/log/nginx"：挂载日志目录，便于查看和管理日志。
• -v "$DIR/nginx/html:/opt/html"：挂载网站文件目录，用于存放静态网页。

七、修改 nginx.conf 文件配置监听端口

如果你希望更改 Nginx 的默认端口，可以在修改的 nginx.conf 文件中进行配置。在 nginx.conf 中，你可以找到以下内容：

server {
    listen 80;
    server_name localhost;
    client_max_body_size 100m;

    access_log /var/log/nginx/access.log main;
    error_log /var/log/nginx/error.log notice;
    
    #测试
    location /demo/testme {
        default_type text/html;
        return 200 "demo success 80!";
    }

     #首页静态资源
     location /demo {

            autoindex off; # 禁止目录索引
            server_tokens off; # 在http{}块中隐藏服务器版本号

            client_max_body_size 100m;
            alias /opt/html/dist;
            index index.html index.htm;

            try_files $uri $uri/ /demo/index.html;  #front为路由 而不是目录
    }
}

将 listen 80; 改为你需要的端口（例如 listen 8080;）。这样，Nginx 就会监听新的端口。

八、端口配置：Host 网络模式 vs Port 映射模式

在 Docker 中，容器的端口配置是非常关键的。Nginx 容器支持两种主要的端口配置方式：Host 网络模式 和 Port 映射模式。

1. Host 网络模式

   在 Docker 中使用 --network host 时，容器将共享宿主机的网络栈，这意味着容器直接使用宿主机的 IP 地址和端口来暴露服务。通过这种方式，容器会使用宿主机的端口 80 来提供服务。

   配置命令：

   docker run -d \
     --restart=always \
     --name "$DOCKER_NAME" \
     --network host \
     -v "$DIR/nginx/conf/nginx.conf:/etc/nginx/nginx.conf" \
     -v "$DIR/nginx/conf/conf.d:/etc/nginx/conf.d" \
     -v "$DIR/nginx/log:/var/log/nginx" \
     -v "$DIR/nginx/html:/opt/html" \
     nginx:stable-alpine
   

   • 优点
     • 容器共享宿主机的网络，性能较高。
     • 无需显式端口映射，容器与宿主机共享相同的网络。
   • 缺点
     • 容器与宿主机的网络完全共享，可能会有端口冲突，尤其是多个容器或服务同时运行时。
     • 容器的端口与宿主机端口相同，可能存在安全隐患。

2. Port 映射模式

   如果你希望使用宿主机的特定端口来访问容器内的服务，可以使用 -p 参数进行端口映射。通过这种方式，容器内部的端口（例如 80）将映射到宿主机的另一个端口（例如 8080）。

   配置命令：

   docker run -d \
    --restart=always \
    --name "$DOCKER_NAME" \
    -p 8080:80 \
    -v "$DIR/nginx/conf/nginx.conf:/etc/nginx/nginx.conf" \
    -v "$DIR/nginx/conf/conf.d:/etc/nginx/conf.d" \
    -v "$DIR/nginx/log:/var/log/nginx" \
    -v "$DIR/nginx/html:/opt/html" \
    nginx:stable-alpine
   

   在这个配置中：
   -p 8080:80：将宿主机的 8080 端口映射到容器的 80 端口。你可以通过宿主机的 http://localhost:8080 访问 Nginx 服务。

   • 优点
     • 容器端口与宿主机端口不同，可以避免端口冲突。
     • 容器与宿主机之间有更好的网络隔离性。
     • 支持多个容器映射到宿主机不同的端口，适合多容器环境。
   • 缺点
     • 可能会导致稍微的性能损失，因为需要进行额外的端口映射。
     • 需要手动管理和指定端口映射。

九、查看日志和检查容器状态

容器启动后，你可以通过以下命令查看容器的状态，确保它在运行中：

docker ps

如果容器未正常运行，可以查看日志进行排查：

docker logs docker-nginx

查看 Nginx 的访问日志和错误日志也可以帮助你调试网站：

tail -f "$DIR/nginx/log/access.log"
tail -f "$DIR/nginx/log/error.log"

十、访问 Nginx 服务

完成上述步骤后，你可以通过浏览器访问宿主机的 IP 地址和配置的端口，查看 Nginx 是否正常运行。

• 如果使用了 --network host，则可以通过 http://localhost 或宿主机的 IP 地址访问服务。
• 如果使用了端口映射，例如 -p 8080:80，则可以通过 http://localhost:8080 访问 Nginx 欢迎页面。

---

总结

通过 Docker 部署 Nginx 容器非常简便，并且可以灵活配置各个参数。通过挂载本地目录，Nginx 的配置文件、日志和网站文件可以持久化存储在宿主机上，便于管理和备份。使用 Docker 来运行 Nginx 容器不仅简化了部署流程，还提供了极大的灵活性和可扩展性。