1.准备构建上下文
[root@host1 ~]# mkdir dockerfile-test && cd dockerfile-test
[root@host1 dockerfile-test]# touch nginx.repo
[root@host1 dockerfile-test]# touch Dockerfile
[root@host1 dockerfile-test]# vi nginx.repo
[root@host1 dockerfile-test]# cat nginx.repo
[nginx-stable]
name=nginx stable repo
baseurl=http://nginx.org/packages/centos/9Stream/$basearch/
gpgcheck=1
enabled=1
gpgkey=https://nginx.org/keys/nginx_signing.key[nginx-mainline]
name=nginx mainline repo
baseurl=http://nginx.org/packages/mainline/centos/9Stream/$basearch/
gpgcheck=1
enabled=0
gpgkey=https://nginx.org/keys/nginx_signing.key
2.编写 Dockerfile
[root@host1 dockerfile-test]# vi Dockerfile
[root@host1 dockerfile-test]# cat Dockerfile# 1. 基础镜像:使用 CentOS Stream 9 官方镜像(匹配目标源版本)
FROM centos/stream9:latest# 2. 维护者信息(可选,标注镜像归属)
LABEL maintainer="your-name <your-email@example.com>" \os.version="CentOS-Stream-9-20250903.0" \nginx.repo.version="stable"# 3. 复制本地适配 Stream 9 的 nginx.repo 到容器 YUM 源目录
# 路径 /etc/yum.repos.d/ 是 CentOS Stream 9 标准 YUM 源目录
COPY nginx.repo /etc/yum.repos.d/# 4. 安装 Nginx(适配 Stream 9 的 YUM 操作)
RUN set -eux; \# 1. 导入 Nginx GPG 密钥(避免 Stream 9 下校验失败)rpm --import https://nginx.org/keys/nginx_signing.key; \# 2. 清理旧缓存,生成新缓存(Stream 9 推荐用 dnf,兼容 yum)dnf clean all; \dnf makecache fast; \# 3. 安装 Nginx(--setopt=tsflags=nodocs 减少镜像体积,不安装文档)dnf install -y nginx --setopt=tsflags=nodocs; \# 4. 清理缓存(进一步减小镜像体积)dnf clean all; \# 5. 确保 Nginx 运行目录权限(Stream 9 下默认权限可能更严格)chown -R nginx:nginx /var/log/nginx /var/run/nginx; \chmod 755 /var/log/nginx /var/run/nginx# 5. 暴露 Nginx 默认端口(80/tcp,与配置一致)
EXPOSE 80/tcp# 6. 配置 Nginx 前台运行(关键:避免容器启动后立即退出)
# Stream 9 下 Nginx 二进制路径与传统 CentOS 一致,无需调整
CMD ["nginx", "-g", "daemon off;"]
3.使用 docker build 命令构建镜像
注意:访问不了外网改用本地部署
4.离线环境下基于 CentOS 构建 Nginx Docker 镜像
1.本地 CentOS 基础镜像制作(核心:替代在线镜像)
# 打包系统根目录(排除动态目录与设备文件,避免镜像异常)
sudo tar -czf centos-local-rootfs.tar.gz \--exclude=/proc --exclude=/sys --exclude=/dev --exclude=/tmp --exclude=/var/tmp \/
# 导入打包文件为Docker基础镜像
sudo docker import centos-local-rootfs.tar.gz centos-local:base
[root@host1 ~]# sudo tar -czf centos-local-rootfs.tar.gz \--exclude=/proc --exclude=/sys --exclude=/dev --exclude=/tmp --exclude=/var/tmp \/
tar: 从成员名中删除开头的“/”
tar: /run/docker.sock: 忽略套接字(socket)
tar: /run/docker/metrics.sock: 忽略套接字(socket)
tar: /run/docker/libnetwork/1d7343f57de7.sock: 忽略套接字(socket)
tar: /run/containerd/s/9084af067cbc0fd363a366468af18f682023e35e8d8440d8ee65311f80a1febb: 忽略套接字(socket)
tar: /run/containerd/containerd.sock: 忽略套接字(socket)
tar: /run/containerd/containerd.sock.ttrpc: 忽略套接字(socket)
tar: /run/vmware/guestServicePipe: 忽略套接字(socket)
tar: /run/chrony/chronyd.sock: 忽略套接字(socket)
tar: /run/mcelog-client: 忽略套接字(socket)
tar: /run/irqbalance/irqbalance995.sock: 忽略套接字(socket)
tar: /run/.heim_org.h5l.kcm-socket: 忽略套接字(socket)
tar: /run/avahi-daemon/socket: 忽略套接字(socket)
tar: /run/setroubleshoot/setroubleshoot_server: 忽略套接字(socket)
tar: /run/lsm/ipc/simc: 忽略套接字(socket)
tar: /run/lsm/ipc/sim: 忽略套接字(socket)
tar: /run/cups/cups.sock: 忽略套接字(socket)
tar: /run/lvm/lvmpolld.socket: 忽略套接字(socket)
tar: /run/user/0/pipewire-0-manager: 忽略套接字(socket)
tar: /run/user/0/pipewire-0: 忽略套接字(socket)
tar: /run/user/0/bus: 忽略套接字(socket)
tar: /run/user/0/systemd/private: 忽略套接字(socket)
tar: /run/user/0/systemd/notify: 忽略套接字(socket)
tar: /run/user/0/systemd/inaccessible/sock: 忽略套接字(socket)
tar: /run/user/42/wayland-0: 忽略套接字(socket)
tar: /run/user/42/pipewire-0-manager: 忽略套接字(socket)
tar: /run/user/42/pipewire-0: 忽略套接字(socket)
tar: /run/user/42/pulse/native: 忽略套接字(socket)
tar: /run/user/42/bus: 忽略套接字(socket)
tar: /run/user/42/systemd/private: 忽略套接字(socket)
tar: /run/user/42/systemd/notify: 忽略套接字(socket)
tar: /run/user/42/systemd/inaccessible/sock: 忽略套接字(socket)
tar: /run/udev/control: 忽略套接字(socket)
tar: /run/dbus/system_bus_socket: 忽略套接字(socket)
tar: /run/systemd/coredump: 忽略套接字(socket)
tar: /run/systemd/private: 忽略套接字(socket)
tar: /run/systemd/journal/io.systemd.journal: 忽略套接字(socket)
tar: /run/systemd/journal/stdout: 忽略套接字(socket)
tar: /run/systemd/journal/socket: 忽略套接字(socket)
tar: /run/systemd/journal/dev-log: 忽略套接字(socket)
tar: /run/systemd/io.system.ManagedOOM: 忽略套接字(socket)
tar: /run/systemd/userdb/io.systemd.DynamicUser: 忽略套接字(socket)
tar: /run/systemd/notify: 忽略套接字(socket)
tar: /run/systemd/inaccessible/sock: 忽略套接字(socket)
tar: /root/centos-local-rootfs.tar.gz: 在我们读入文件时文件发生了变化
tar: 从硬连接目标中删除开头的“/”
[root@host1 ~]# sudo docker import centos-local-rootfs.tar.gz centos-local:base
sha256:e34186ee4bfa2e4b483206b0c4f9c26b329a7d900c5bf090f151010076210e1b
验证镜像
[root@host1 ~]# docker images | grep centos-local
centos-local base e34186ee4bfa 12 seconds ago 6.43GB
2.Nginx 离线 RPM 包下载(依赖本地 YUM 源)
[root@host1 ~]# yum install -y yum-utils
上次元数据过期检查:7:51:09 前,执行于 2025年09月10日 星期三 15时04分04秒。
软件包 yum-utils-4.3.0-22.el9.noarch 已安装。
依赖关系解决。
无需任何处理。
完毕!
[root@host1 ~]# yumdownloader --resolve --destdir=nginx-rpms nginx
上次元数据过期检查:7:51:15 前,执行于 2025年09月10日 星期三 15时04分04秒。
(1/4): nginx-filesystem-1.20.1-24.el9.noarch.rpm 26 kB/s | 9.3 kB 00:00
(2/4): nginx-1.20.1-24.el9.x86_64.rpm 74 kB/s | 36 kB 00:00
(3/4): nginx-core-1.20.1-24.el9.x86_64.rpm 856 kB/s | 570 kB 00:00
(4/4): centos-logos-httpd-90.8-3.el9.noarch.rpm 1.3 MB/s | 1.5 MB 00:01
验证
[root@host1 ~]# ls -l nginx-rpms/
总用量 2168
-rw-r--r--. 1 root root 1579851 9月 10 22:55 centos-logos-httpd-90.8-3.el9.noarch.rpm
-rw-r--r--. 1 root root 37053 9月 10 22:55 nginx-1.20.1-24.el9.x86_64.rpm
-rw-r--r--. 1 root root 583889 9月 10 22:55 nginx-core-1.20.1-24.el9.x86_64.rpm
-rw-r--r--. 1 root root 9479 9月 10 22:55 nginx-filesystem-1.20.1-24.el9.noarch.rpm
3.修正Dockerfile
FROM centos-local:base
LABEL maintainer="tester@abc.com"
# 复制离线RPM包到容器内
COPY ./nginx-rpms /tmp/nginx-rpms
# 离线安装Nginx(禁用外网源+忽略GPG校验)
RUN yum localinstall -y /tmp/nginx-rpms/*.rpm \--nogpgcheck \--disablerepo=* \ # 新增反斜杠,确保命令连续性&& yum clean all \&& rm -rf /tmp/nginx-rpms # 清理RPM包,减小镜像体积
# 自定义Nginx首页内容
RUN echo "Hello! This is nginx server (offline build)" > /usr/share/nginx/html/index.html
# 暴露Nginx默认端口
EXPOSE 80
# 前台启动Nginx(避免容器退出)
CMD ["nginx", "-g", "daemon off;"]
4.镜像构建与问题排查
[root@host1 dockerfile-test]# docker build -t centos-with-nginx:1.0 .
[+] Building 0.0s (6/8) docker:default=> [internal] load build definition from Dockerfile 0.0s=> => transferring dockerfile: 475B 0.0s=> [internal] load metadata for docker.io/library/centos-local:base 0.0s=> [internal] load .dockerignore 0.0s=> => transferring context: 2B 0.0s=> [internal] load build context 0.0s=> => transferring context: 2B 0.0s=> [1/4] FROM docker.io/library/centos-local:base 0.0s=> ERROR [2/4] COPY ./nginx-rpms /tmp/nginx-rpms 0.0s
------> [2/4] COPY ./nginx-rpms /tmp/nginx-rpms:
------
Dockerfile:5
--------------------3 | LABEL maintainer="tester@abc.com"4 | 5 | >>> COPY ./nginx-rpms /tmp/nginx-rpms6 | 7 | RUN yum localinstall -y /tmp/nginx-rpms/*.rpm \
--------------------
ERROR: failed to build: failed to solve: failed to compute cache key: failed to calculate checksum of ref af1a50fb-c1e8-4693-96ea-aea71e06623b::ox2260dtgoy01masgivj3hc3a: "/nginx-rpms": not found
[root@host1 dockerfile-test]# sudo find / -name "nginx-rpms" -type d
/root/nginx-rpms
[root@host1 dockerfile-test]# mv /root/nginx-rpms /root/dockerfile-test/
[root@host1 dockerfile-test]# cd /root/dockerfile-test
[root@host1 dockerfile-test]# ls -l
总用量 4
-rw-r--r--. 1 root root 376 9月 10 23:08 Dockerfile
drwxr-xr-x. 2 root root 184 9月 10 22:55 nginx-rpms
[root@host1 dockerfile-test]# docker build -t centos-with-nginx:1.0 .
[+] Building 1.8s (9/9) FINISHED docker:default=> [internal] load build definition from Dockerfile 0.0s=> => transferring dockerfile: 475B 0.0s=> [internal] load metadata for docker.io/library/centos-local:base 0.0s=> [internal] load .dockerignore 0.0s=> => transferring context: 2B 0.0s=> [internal] load build context 0.0s=> => transferring context: 2.21MB 0.0s=> CACHED [1/4] FROM docker.io/library/centos-local:base 0.0s=> [2/4] COPY ./nginx-rpms /tmp/nginx-rpms 0.0s=> [3/4] RUN yum localinstall -y /tmp/nginx-rpms/*.rpm --nogpgcheck --disablerepo=* 1.4s=> [4/4] RUN echo "Hello! This is nginx server (offline build)" > /usr/share/nginx/html/index 0.2s=> exporting to image 0.2s => => exporting layers 0.2s => => writing image sha256:7c5315069664141b331877afb32716dc6f0a9918731e8717a449ff564560fc20 0.0s => => naming to docker.io/library/centos-with-nginx:1.0
5.镜像功能验证
[root@host1 dockerfile-test]# docker images | grep centos-with-nginx
centos-with-nginx 1.0 7c5315069664 6 minutes ago 6.54GB
[root@host1 dockerfile-test]# docker run -d -p 8080:80 --name test-nginx centos-with-nginx:1.0
7ecac05c7dac295bd2d80a68dd540ae8cf7b19174609dfb614c11722b525e7a4
[root@host1 dockerfile-test]# docker ps | grep test-nginx
7ecac05c7dac centos-with-nginx:1.0 "nginx -g 'daemon of…" 11 seconds ago Up 11 seconds 0.0.
0.0:8080->80/tcp, [::]:8080->80/tcp test-nginx
[root@host1 dockerfile-test]# curl http://localhost:8080
Hello! This is nginx server (offline build)