Docker 搭建 Nginx 服务器

系列文章目录

Docker 搭建 Nginx 服务器

• 系列文章目录
• 前言
• 一、准备工作
• 二、设置 Nginx 容器的目录结构
• 三、启动一个临时的 Nginx 容器来复制配置文件
• 四、复制 Nginx 配置文件到本地目录
• 五、删除临时 Nginx 容器
• 六、创建并运行 Nginx 容器，挂载本地目录
• 七、修改 `nginx.conf` 文件配置监听端口
• 八、端口配置：Host 网络模式 vs Port 映射模式
• 九、查看日志和检查容器状态
• 十、访问 Nginx 服务
• 总结

前言

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

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

一、准备工作

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

Linux上进行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 映射模式。

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

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

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 容器不仅简化了部署流程，还提供了极大的灵活性和可扩展性。