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 启动主进程。生产部署时应结合镜像能力、端口规划和编排平台安全策略,评估是否切换非特权用户运行。
验证重点包括进程用户、文件权限、监听端口以及配置读取权限,避免因权限不足导致启动失败。
按自己的节奏,确认真正理解。