Docker部署Nginx 及Nginx的基本使用最佳实践

 更新时间:2025年04月24日 15:40:12   作者:Kwan的解忧杂货铺@新空间  
Nginx是一个高性能的HTTP和反向代理服务器,广泛应用于Web服务、负载均衡和静态资源托管等领域,这篇文章主要介绍了Docker部署Nginx 以及Nginx的基本使用,需要的朋友可以参考下

容器化技术正在彻底改变现代应用的部署方式,而 Docker 作为这一领域的先驱,为开发者提供了快速构建、交付和运行应用的能力。

一、环境准备与基础概念

1.1 Docker 核心优势

Docker 通过以下特性显著提升部署效率:

  • 环境一致性:镜像封装了应用及其依赖,消除"在我机器上能运行"的问题
  • 资源隔离:基于 Linux 命名空间和 cgroups 技术实现进程与资源隔离
  • 快速部署:镜像分层机制和共享基础层大幅提升部署速度
  • 版本控制:支持镜像版本管理和快速回滚

1.2 安装 Docker 引擎

在 Ubuntu 22.04 LTS 上安装最新社区版:

sudo apt update
sudo apt install apt-transport-https ca-certificates curl software-properties-common
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io

验证安装:

sudo docker --version
sudo systemctl status docker

二、Nginx 容器化部署实战

2.1 镜像获取与验证

从 Docker Hub 拉取官方镜像:

docker pull nginx:1.23-alpine

选择 Alpine 版本的优势:

  • 基于轻量级 Alpine Linux(约 5MB)
  • 默认包含常用模块:gzip、SSL、realip 等
  • 遵循安全最佳实践,最小化攻击面

查看镜像详情:

docker image inspect nginx:1.23-alpine | jq '.[0].Config.ExposedPorts'

2.2 基础运行与验证

启动临时容器:

docker run --rm -d -p 8080:80 --name nginx-test nginx:1.23-alpine

参数解析:

  • --rm:容器停止后自动删除
  • -d:后台守护进程模式
  • -p:端口映射(宿主机端口:容器端口)
  • --name:指定容器名称

访问验证:

curl -I http://localhost:8080
# 预期输出:HTTP/1.1 200 OK

2.3 持久化数据管理

创建数据目录结构:

mkdir -p ~/nginx-docker/{conf,html,logs}

获取默认配置:

docker run --rm nginx:1.23-alpine cat /etc/nginx/nginx.conf > ~/nginx-docker/conf/nginx.conf

自定义配置文件示例(~/nginx-docker/conf/conf.d/app.conf):

server {
    listen 80;
    server_name localhost;
    location / {
        root /usr/share/nginx/html;
        index index.html;
        try_files $uri $uri/ =404;
    }
    access_log /var/log/nginx/access.log main;
    error_log /var/log/nginx/error.log warn;
}

2.4 完整部署命令

docker run -d \
  --name production-nginx \
  -p 80:80 \
  -p 443:443 \
  -v ~/nginx-docker/html:/usr/share/nginx/html \
  -v ~/nginx-docker/conf:/etc/nginx \
  -v ~/nginx-docker/logs:/var/log/nginx \
  --restart unless-stopped \
  nginx:1.23-alpine

挂载点说明:

  • html 目录:存放静态资源文件(支持热更新)
  • conf 目录:包含 nginx.conf 和 conf.d 子目录
  • logs 目录:持久化访问日志和错误日志

三、高级配置技巧

3.1 环境变量配置

通过-e参数注入配置:

docker run -d \
  -e NGINX_ENVSUBST_TEMPLATE_DIR=/etc/nginx/templates \
  -e NGINX_HOST=example.com \
  -e NGINX_PORT=8080 \
  nginx:1.23-alpine

模板文件示例(/etc/nginx/templates/default.conf.template):

server {
    listen ${NGINX_PORT};
    server_name ${NGINX_HOST};
    # 其他配置...
}

3.2 性能调优参数

docker run -d \
  --ulimit nofile=65536:65536 \
  --sysctl net.core.somaxconn=4096 \
  --memory="512m" \
  --cpus="1.5" \
  nginx:1.23-alpine

3.3 健康检查配置

Dockerfile 内置健康检查:

HEALTHCHECK --interval=30s --timeout=3s \
  CMD curl -f http://localhost/ || exit 1

查看健康状态:

docker inspect --format='{{json .State.Health}}' container_name

四、安全最佳实践

4.1 用户权限控制

避免使用 root 运行:

docker run -d \
  --user 1000:1000 \
  -v /path/to/certs:/etc/nginx/certs:ro \
  nginx:1.23-alpine

4.2 网络安全配置

限制网络访问:

docker network create nginx-net
docker run -d \
  --network nginx-net \
  --security-opt no-new-privileges \
  --cap-drop ALL \
  --cap-add NET_BIND_SERVICE \
  nginx:1.23-alpine

4.3 镜像安全扫描

定期检查漏洞:

docker scan nginx:1.23-alpine

五、故障排查与维护

5.1 日志分析技巧

实时查看日志:

docker logs -f --tail 100 production-nginx

过滤错误日志:

docker exec production-nginx grep error /var/log/nginx/error.log

5.2 容器调试方法

进入容器 shell:

docker exec -it production-nginx sh

检查配置文件:

docker exec production-nginx nginx -t

5.3 常见问题解决方案

| 问题现象 | 排查步骤 | 解决方案 |
| --------------- | --------------------------------------------- | -------------------------- | --------------------- |
| 403 Forbidden | 1. 检查挂载目录权限
2. 确认 index 文件存在 | 设置chmod -R 755 html |
| 502 Bad Gateway | 1. 检查后端服务状态
2. 查看代理配置 | 验证 upstream 服务器可达性 |
| 地址已被占用 | 查看端口冲突情况 | 使用netstat -tulnp | grep :80查找冲突进程 |

六、生产环境部署建议

  • 使用 Docker Compose:通过 YAML 文件管理多容器应用
  • 配置 TLS 证书:使用 Let’s Encrypt 自动续期证书
  • 设置资源限制:防止单个容器耗尽系统资源
  • 启用日志轮转:使用 logrotate 管理容器日志
  • 实施监控告警:集成 Prometheus+Grafana 监控体系

到此这篇关于Docker部署Nginx 及Nginx的基本使用最佳实践的文章就介绍到这了,更多相关docker nginx部署内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Docker和镜像的操作方法

    Docker和镜像的操作方法

    这篇文章主要介绍了Docker和镜像的操作方法,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2021-03-03
  • Docker创建openresty容器的实现步骤

    Docker创建openresty容器的实现步骤

    OpenResty可以用来构建高性能的Web应用和服务,本文主要介绍了Docker创建openresty容器的实现步骤,文中通过示例代码介绍的非常详细,需要的朋友们下面随着小编来一起学习学习吧
    2024-03-03
  • K3s离线部署全过程

    K3s离线部署全过程

    部署K3s集群需关闭防火墙/SELinux,安装Docker,配置主机解析与主机名,上传安装包,主节点安装后调整nodeport范围并生成Token,节点加入集群后将身份改为Worker,最终验证集群状态
    2025-09-09
  • Docker中Nginx反向代理的实现步骤

    Docker中Nginx反向代理的实现步骤

    为了安全考虑,我们一般会设置反向代理,用来屏蔽应用程序真实的IP和端口号,本文主要介绍了Docker中Nginx反向代理的实现步骤,具有一定的参考价值,感兴趣的可以了解一下
    2024-03-03
  • 详解java项目打包docker镜像的几种方式

    详解java项目打包docker镜像的几种方式

    本文主要介绍了详解java项目打包docker镜像的几种方式,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2023-01-01
  • docker利用selenium+testng实现web自动化的方法

    docker利用selenium+testng实现web自动化的方法

    这篇文章主要给大家介绍了关于docker利用selenium+testng实现web自动化的相关资料,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习吧
    2018-10-10
  • docker run本地镜像tar用法详解

    docker run本地镜像tar用法详解

    Docker中,使用docker load加载本地.tar镜像,再通过docker run运行,注意名称可能不同,需用docker images确认,确保文件完整及标签正确
    2025-09-09
  • 解决docker数据文件过大导致根磁盘满的问题

    解决docker数据文件过大导致根磁盘满的问题

    本篇文章主要介绍了解决docker数据文件过大导致根磁盘满的问题,具有一定的参考价值,感兴趣的小伙伴们可以参考一下。
    2017-04-04
  • Docker安装部署完全流程使用指南(Linux通用版)

    Docker安装部署完全流程使用指南(Linux通用版)

    Docker 是一种流行的开源容器化平台,它能够将应用程序及其依赖打包进轻量级、可移植的容器中运行,这篇文章主要介绍了Linux系统下Docker安装部署完全流程使用指南,需要的朋友可以参考下
    2026-04-04
  • docker私有仓库的搭建和使用详解

    docker私有仓库的搭建和使用详解

    这篇文章主要介绍了docker私有仓库的搭建和使用详解,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-10-10

最新评论