Web 服务器与网关 / 系统课时

构建 Nginx 容器镜像

构建 Nginx 容器镜像

本课学习如何基于官方 Nginx 镜像构建可复现运行环境,将配置、证书、日志和静态资源与镜像生命周期分离,并通过容器运行验证部署结果。

学习目标

  • 掌握 Nginx Docker 镜像构建的基本流程。
  • 理解镜像、挂载配置和运行参数之间的关系。
  • 验证容器中的 Nginx 服务是否符合部署要求。

设计 Nginx 容器结构

容器化部署的核心原则是镜像负责提供稳定运行环境,业务差异通过挂载或环境配置注入。这样可以避免每次修改配置都重新构建镜像。

典型结构包括 Nginx 程序镜像、只读配置文件、证书目录、静态资源目录以及日志采集目录。

编写 Dockerfile 构建镜像

Dockerfile 应保持简单,明确基础版本和需要复制的静态内容。正式环境通常会锁定基础镜像版本,避免上游镜像变化影响发布结果。

dockerfile
FROM nginx:1.27

COPY ./html /usr/share/nginx/html
COPY ./nginx.conf /etc/nginx/nginx.conf

EXPOSE 80

预期结果

text
镜像构建完成,包含 Nginx 程序、站点文件和配置文件

构建并运行容器

完成镜像定义后,需要构建镜像并启动容器验证服务。端口映射、目录挂载和运行用户设置会直接影响生产安全性。

bash
docker build -t my-nginx:<ID> .
docker run -d --name nginx-test -p <PORT>:80 my-nginx:<ID>

预期结果

text
容器 nginx-test 启动成功
服务监听容器内 80 端口

实际容器名称和端口值可能根据环境不同调整。

管理配置、证书和日志挂载

生产环境通常不会把敏感配置和证书永久写入镜像,而是通过挂载方式提供运行时文件。这样可以独立更新证书和配置,不影响镜像版本管理。

bash
docker run -d \
  -v /opt/nginx/conf:/etc/nginx:ro \
  -v /opt/nginx/cert:/etc/nginx/cert:ro \
  -v /opt/nginx/log:/var/log/nginx \
  -p <PORT>:80 nginx:1.27

预期结果

text
容器启动后读取外部配置目录
日志写入指定宿主机目录

验证非特权运行

默认 Nginx 容器可能以 root 启动主进程。生产部署时应结合镜像能力、端口规划和编排平台安全策略,评估是否切换非特权用户运行。

验证重点包括进程用户、文件权限、监听端口以及配置读取权限,避免因权限不足导致启动失败。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

构建 Nginx 容器镜像

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通