30款热门AI模型一站整合DeepSeek/GLM/Qwen 随心用限时 5 折。 点击领海量免费额度在容器化部署的实践中我们常常遇到一个典型场景从官方基础镜像启动容器后发现缺少必要的软件包网络不通导致无法直接使用默认的Yum源。手动进入容器安装不仅效率低下更无法实现自动化与标准化。本文将系统性地解决这个问题手把手带你完成从定制一个包含基础工具的简单镜像到在容器内部署可用的Yum仓库最终在容器内成功安装并运行服务如Nginx的全过程。无论你是刚接触Docker的新手还是需要在隔离环境中配置服务的开发者这套闭环操作都能直接复用。1. 核心概念与问题背景在深入操作之前我们需要厘清几个关键概念并理解我们将要解决的核心问题。1.1 Docker镜像与容器Docker镜像是一个轻量级、可执行的独立软件包它包含运行某个软件所需的所有内容代码、运行时、库、环境变量和配置文件。你可以把它理解为一个应用程序及其运行环境的“模板”或“快照”。镜像是分层的、只读的。Docker容器是镜像的运行实例。当你从镜像启动一个容器时Docker会在镜像层之上创建一个可写的容器层。容器内进程的运行环境是相互隔离的。你可以把容器看作一个轻量级的、便携的、独立的“沙箱”。简单比喻镜像就像是面向对象编程中的“类”Class而容器则是这个类的“实例”Instance。1.2 Yum仓库与容器内软件安装YumYellowdog Updater, Modified是RPM系Linux发行版如CentOS、RHEL、Fedora的包管理器。它通过配置的软件仓库Repository来查找、下载并安装软件包及其依赖。在Docker容器中我们经常会使用基于CentOS或RHEL的官方镜像。然而出于安全和最小化原则这些基础镜像通常只包含最核心的系统组件不包含vim、wget、net-tools等常用工具其自带的Yum源配置也可能因为网络问题如默认连接国外源而无法使用。这就引出了我们的核心需求定制镜像创建一个包含我们所需基础工具的镜像避免每次启动容器都重复安装。配置容器内Yum源在容器内部将Yum源指向一个稳定、高速的地址如国内镜像站确保软件安装过程顺畅。在容器内安装部署服务利用配置好的Yum源在容器内安装如Nginx、MySQL等服务并使其能够运行。1.3 本文目标与最终成果通过本文的步骤你将能够编写一个高效的Dockerfile构建出自定义镜像。掌握在容器运行时内部配置Yum仓库的多种方法。在自定义的容器环境中成功安装并启动一个Nginx服务作为演示。理解镜像分层构建的原理与最佳实践。2. 环境准备与版本说明在开始实战前请确保你的操作环境已就绪。操作系统本文演示环境为CentOS 7.9但步骤同样适用于其他Linux发行版如Ubuntu或Windows/macOS上的Docker Desktop。核心是Docker引擎本身。Docker引擎请确保已安装并启动Docker服务。安装方法可参考官方文档或使用系统包管理器如yum install docker或apt-get install docker.io。验证安装docker --version。本文示例基于Docker版本20.10。启动Docker服务sudo systemctl start docker(Linux) 或启动Docker Desktop (Windows/macOS)。权限说明在Linux系统上非root用户运行Docker命令可能需要sudo或者将用户加入docker用户组sudo usermod -aG docker $USER需要重新登录生效。为简洁起见下文命令可能省略sudo请根据你的环境自行添加。基础镜像选择我们将使用centos:7作为基础镜像。这是一个非常经典且广泛使用的RPM系基础镜像。3. 第一阶段编写Dockerfile定制简单镜像我们的第一个目标是创建一个比官方centos:7更“好用”的镜像预装一些常用工具。3.1 创建项目目录与Dockerfile首先创建一个清晰的工作目录。mkdir -p ~/docker-custom-image cd ~/docker-custom-image在该目录下创建名为Dockerfile的文件注意大小写。这个文件是构建镜像的“蓝图”。vim Dockerfile # 或使用其他文本编辑器如 nano Dockerfile3.2 编写Dockerfile内容将以下内容写入Dockerfile。每一行我们都会详细解释。# 第一行指定基础镜像。这里我们使用CentOS 7的官方镜像。 FROM centos:7 # 第二行维护者信息已弃用但可保留为元数据。推荐使用LABEL。 LABEL maintaineryour-emailexample.com # 第三行设置镜像内的环境变量例如时区。 ENV TZAsia/Shanghai # 第四行在构建镜像时运行的命令。 # RUN 指令会在当前镜像层之上执行命令并创建新的镜像层。 # 这里我们做三件事 # 1. 安装基础工具vim编辑器、wget下载工具、net-tools网络诊断工具如ifconfig, netstat。 # 2. 清理yum缓存减小镜像体积。 # 3. 创建必要的目录。 RUN yum install -y vim wget net-tools \ yum clean all \ rm -rf /var/cache/yum/* \ mkdir -p /app # 第五行声明容器运行时监听的端口。这只是元数据方便使用者了解。 EXPOSE 80 # 第六行设置容器启动时默认的工作目录。 WORKDIR /app # 第七行设置容器启动时默认执行的命令。 # 这里我们启动一个bash shell防止容器因为没有前台进程而立即退出。 CMD [/bin/bash]关键点解析FROM必须是指令的第一条定义了构建的起点。RUN最常用的指令之一。注意我们将多个命令用连接并在最后清理缓存这非常重要。每一条RUN指令都会产生一个新的镜像层。将相关命令合并并清理临时文件可以显著减少最终镜像的体积。这是Docker镜像构建的最佳实践。yum clean all和rm -rf /var/cache/yum/*用于清除Yum安装过程中产生的缓存数据这些数据在运行时并不需要删除它们可以节省大量空间。CMD指定容器启动时的默认命令。这里设为bash方便我们交互式进入容器。在生产环境中这里通常会是一个具体的服务启动命令如nginx -g ‘daemon off;‘。3.3 构建自定义镜像在Dockerfile所在的目录~/docker-custom-image下执行构建命令。docker build -t my-centos:7-tools .-t my-centos:7-tools为构建的镜像打上标签Tag名称是my-centos标签是7-tools。标签有助于版本管理。.这个点代表当前目录是构建上下文Build Context。Docker守护进程会将此目录下的所有文件发送给构建进程。Dockerfile默认位于此路径。构建过程会逐条执行Dockerfile中的指令并输出日志。第一次构建可能会慢一些因为它需要下载centos:7基础镜像。3.4 验证镜像并运行容器构建成功后使用docker images查看本地镜像列表应该能看到my-centos。docker images | grep my-centos现在运行一个基于此镜像的交互式容器docker run -it --name my-test-container my-centos:7-tools成功运行后你会进入容器的bash shell。可以测试预装的工具# 检查vim是否安装 vim --version | head -1 # 检查wget wget --version | head -1 # 检查net-tools (ifconfig) ifconfig -a | head -2 # 退出容器注意退出后容器会停止 exit至此你已经成功创建了一个包含基础工具的自定义镜像。但容器内的Yum源仍然是默认的可能无法使用。接下来我们解决这个问题。4. 第二阶段为运行的容器配置Yum仓库配置容器内的Yum源有多种方式我们将介绍两种最常用、最实用的方法。4.1 方法一启动容器时挂载本地Yum源文件推荐用于开发/测试这是最灵活的方式。我们在宿主机上准备好适用于容器内系统的Yum源配置文件.repo文件然后在启动容器时将该文件挂载到容器内的对应目录。步骤1在宿主机准备Yum源文件以配置阿里云CentOS 7镜像源为例。在宿主机上创建文件# 在宿主机上操作 mkdir -p ~/docker-yum-config vim ~/docker-yum-config/CentOS-Base.repo将阿里云CentOS 7的源配置内容写入该文件。你可以从阿里云镜像站获取最新内容以下是一个示例模板[base] nameCentOS-$releasever - Base - mirrors.aliyun.com baseurlhttps://mirrors.aliyun.com/centos/$releasever/os/$basearch/ gpgcheck1 gpgkeyhttps://mirrors.aliyun.com/centos/RPM-GPG-KEY-CentOS-7 [updates] nameCentOS-$releasever - Updates - mirrors.aliyun.com baseurlhttps://mirrors.aliyun.com/centos/$releasever/updates/$basearch/ gpgcheck1 gpgkeyhttps://mirrors.aliyun.com/centos/RPM-GPG-KEY-CentOS-7 [extras] nameCentOS-$releasever - Extras - mirrors.aliyun.com baseurlhttps://mirrors.aliyun.com/centos/$releasever/extras/$basearch/ gpgcheck1 gpgkeyhttps://mirrors.aliyun.com/centos/RPM-GPG-KEY-CentOS-7 [centosplus] nameCentOS-$releasever - Plus - mirrors.aliyun.com baseurlhttps://mirrors.aliyun.com/centos/$releasever/centosplus/$basearch/ gpgcheck1 enabled0 gpgkeyhttps://mirrors.aliyun.com/centos/RPM-GPG-KEY-CentOS-7步骤2启动容器并挂载源文件使用-v或--mount参数将宿主机的文件挂载到容器内覆盖默认的源文件。# 停止并删除之前创建的测试容器如果存在 docker rm -f my-test-container 2/dev/null || true # 启动新容器并挂载Yum源配置文件 docker run -it --name my-dev-container \ -v ~/docker-yum-config/CentOS-Base.repo:/etc/yum.repos.d/CentOS-Base.repo \ my-centos:7-tools参数解释-v ~/docker-yum-config/CentOS-Base.repo:/etc/yum.repos.d/CentOS-Base.repo将宿主机的CentOS-Base.repo文件挂载到容器内的/etc/yum.repos.d/CentOS-Base.repo路径。容器内该路径原有的文件会被覆盖。步骤3在容器内验证Yum源进入容器后执行以下命令测试# 清理旧缓存 yum clean all # 重新建立缓存 yum makecache # 测试安装一个小工具例如 tree yum install -y tree tree --version如果速度很快说明阿里云镜像源配置成功。安装完tree后可以exit退出容器。优点无需修改镜像配置在宿主机管理方便可以随时切换不同的源。缺点容器迁移到其他宿主机时需要确保目标主机也有相应的源文件。4.2 方法二在Dockerfile中直接配置Yum源构建到镜像内如果你希望镜像本身就包含正确的Yum源方便在任何地方直接使用可以在构建镜像时就将源配置好。步骤1创建新的Dockerfile新建一个目录和Dockerfile例如~/docker-image-with-repo。mkdir -p ~/docker-image-with-repo cd ~/docker-image-with-repo vim Dockerfile步骤2编写新的Dockerfile内容这个Dockerfile在之前的基础上增加了配置Yum源的步骤。FROM centos:7 LABEL maintaineryour-emailexample.com ENV TZAsia/Shanghai # 关键步骤在安装软件前先备份并替换默认的Yum源文件 RUN mv /etc/yum.repos.d/CentOS-Base.repo /etc/yum.repos.d/CentOS-Base.repo.backup \ curl -o /etc/yum.repos.d/CentOS-Base.repo https://mirrors.aliyun.com/repo/Centos-7.repo \ sed -i -e /mirrors.cloud.aliyuncs.com/d -e /mirrors.aliyuncs.com/d /etc/yum.repos.d/CentOS-Base.repo \ yum install -y vim wget net-tools \ yum clean all \ rm -rf /var/cache/yum/* EXPOSE 80 WORKDIR /app CMD [/bin/bash]关键点解析mv ... .backup备份原有的源文件。curl -o ...直接从阿里云下载适用于CentOS 7的repo文件到容器内。这里使用了curl命令如果基础镜像没有curl需要先安装或者用wget替代。由于我们尚未安装任何工具这里假设centos:7基础镜像包含curl实际上通常包含。更稳妥的做法是先安装curl或wget。sed -i ...一个常见的修正操作。阿里云的repo文件中可能包含mirrors.cloud.aliyuncs.com等内网地址对于非阿里云ECS主机可能无法访问此命令将其删除确保使用公网地址。后续的yum install命令就会使用新配置的阿里云源了。步骤3构建并测试新镜像docker build -t my-centos:7-with-repo . docker run -it --rm my-centos:7-with-repo bash -c yum makecache fast--rm参数表示容器停止后自动删除。如果命令执行成功显示“元数据缓存已建立”说明镜像内的Yum源已正确配置。优点镜像自包含开箱即用不受宿主机环境影响。缺点源地址被固化在镜像中如果镜像站地址变更或需要切换其他源需要重新构建镜像。5. 第三阶段在容器内安装部署服务现在我们有了一个带有工具和可用Yum源的容器环境。让我们完成最后一步在容器内安装一个服务以Nginx为例并使其运行。我们将采用一种更符合生产实践的方式创建一个专门用于运行Nginx的镜像。5.1 创建服务部署专用的Dockerfile新建一个项目目录。mkdir -p ~/docker-nginx-service cd ~/docker-nginx-service vim Dockerfile写入以下内容# 使用我们之前构建的带源镜像作为基础或者直接使用配置好源的官方镜像。 # 这里为了演示完整性我们选择从centos:7开始并内联所有步骤。 FROM centos:7 LABEL maintaineryour-emailexample.com LABEL descriptionA custom CentOS 7 image with Nginx installed. # 1. 配置Yum源阿里云 RUN mv /etc/yum.repos.d/CentOS-Base.repo /etc/yum.repos.d/CentOS-Base.repo.backup \ curl -o /etc/yum.repos.d/CentOS-Base.repo https://mirrors.aliyun.com/repo/Centos-7.repo \ sed -i -e /mirrors.cloud.aliyuncs.com/d -e /mirrors.aliyuncs.com/d /etc/yum.repos.d/CentOS-Base.repo # 2. 安装Nginx和必要的工具 RUN yum install -y nginx vim wget \ yum clean all \ rm -rf /var/cache/yum/* # 3. 创建Nginx日志目录某些版本可能需要 RUN mkdir -p /var/log/nginx # 4. 暴露Nginx默认的HTTP端口 EXPOSE 80 # 5. 复制自定义的Nginx配置文件可选这里使用默认配置 # COPY nginx.conf /etc/nginx/nginx.conf # 6. 设置容器启动命令 # 使用 nginx -g ‘daemon off;‘ 让Nginx在前台运行这是容器保持运行的关键。 CMD [nginx, -g, daemon off;]关键点解析LABEL description添加镜像描述是良好的元数据实践。RUN安装Nginx使用配置好的Yum源安装Nginx。EXPOSE 80声明容器使用80端口。CMD [“nginx”, “-g”, “daemon off;”]这是最重要的一行。默认情况下Nginx以后台守护进程模式启动。在Docker容器中如果主进程PID 1退出容器就会停止。daemon off;指令让Nginx在前台运行从而保持容器持续活动。5.2 构建Nginx镜像并运行容器# 构建镜像 docker build -t my-nginx:centos7 . # 运行容器 # -d: 后台运行 # -p 8080:80: 将宿主机的8080端口映射到容器的80端口 # --name my-nginx-container: 为容器命名 docker run -d -p 8080:80 --name my-nginx-container my-nginx:centos75.3 验证服务检查容器状态docker ps | grep my-nginx-container应该能看到容器状态为Up。查看容器日志docker logs my-nginx-container如果没有错误会显示Nginx启动成功的日志。访问服务如果宿主机有浏览器打开http://localhost:8080。或者使用curl命令curl http://localhost:8080你应该能看到Nginx的欢迎页面“Welcome to nginx!”的HTML代码。进入容器进行管理docker exec -it my-nginx-container /bin/bash进入容器后你可以检查Nginx进程、配置文件等。ps aux | grep nginx cat /etc/nginx/nginx.conf exit恭喜你已经成功完成了一个完整的闭环从定制基础镜像、配置容器内Yum仓库到在容器内安装并运行一个真实的Web服务。6. 常见问题与排查思路在实际操作中你可能会遇到以下问题。这里提供排查思路。问题现象可能原因排查步骤与解决方案docker build失败提示Unable to find image ‘centos:7‘ locallyDocker无法从远程仓库拉取基础镜像。1. 检查网络连接。2. 配置Docker国内镜像加速器在/etc/docker/daemon.json中配置。3. 使用docker pull centos:7手动拉取。docker build过程中yum install超时或失败。1. 容器内默认Yum源网络不通。2. DNS解析问题。1.确保已按本文方法配置国内Yum源。2. 在Dockerfile的RUN命令前尝试添加RUN echo ‘nameserver 8.8.8.8‘ /etc/resolv.conf临时设置DNS。3. 检查宿主机的Docker守护进程网络配置。容器启动后立即退出Exited。容器内没有前台进程在运行。1. 检查CMD或ENTRYPOINT指令是否正确。对于Nginx、Tomcat等服务必须使用前台运行模式如nginx -g ‘daemon off;‘。2. 使用docker logs container_id查看退出前的日志。3. 尝试以交互式-it方式启动看是否有错误输出。宿主机无法通过curl localhost:8080访问容器服务。1. 端口映射错误或未映射。2. 容器内服务未监听正确端口。3. 宿主机防火墙阻止。1. 检查docker run的-p参数格式宿主机端口:容器端口。2. 进入容器(docker exec)检查服务是否在运行(ps aux)并监听端口(netstat -tlnp | grep :80)。3. 临时关闭宿主机防火墙测试生产环境慎用systemctl stop firewalld(CentOS 7)。4. 确保容器网络模式正确默认bridge。容器内无法解析域名如curl https://aliyun.com失败。容器内DNS配置问题。1. 检查容器内/etc/resolv.conf文件。2. 启动容器时使用宿主机的DNSdocker run --dns 8.8.8.8 ...。3. 修改Docker守护进程配置/etc/docker/daemon.json设置dns字段。镜像体积过大。1. 每一层RUN命令产生了大量缓存或临时文件。2. 安装了不必要的软件包。1.遵循“合并RUN指令”原则并在同一层清理缓存如yum clean all rm -rf /var/cache/yum/*。2. 使用体积更小的基础镜像如centos:7可考虑替换为alpine但需注意包管理器不同。3. 使用.dockerignore文件排除构建上下文中的无用文件。7. 最佳实践与工程建议掌握了基础操作后遵循以下最佳实践能让你的Docker使用更高效、更安全。7.1 镜像构建优化使用.dockerignore文件在构建上下文目录创建.dockerignore列出不需要打包进镜像的文件如.git,node_modules, 日志文件等可以加速构建过程并减小镜像体积。**/.git **/node_modules **/*.log **/*.tmp多阶段构建Multi-stage Build对于需要编译的应用如Go、Java使用多阶段构建可以在一个Dockerfile中使用一个镜像编译另一个更小的镜像运行极大减小最终镜像体积。# 第一阶段构建环境 FROM golang:1.19 AS builder WORKDIR /app COPY . . RUN go build -o myapp . # 第二阶段运行环境 FROM alpine:latest WORKDIR /root/ COPY --frombuilder /app/myapp . CMD [./myapp]固定基础镜像版本避免使用latest标签应指定具体版本如centos:7.9.2009以保证构建环境的一致性。7.2 容器运行与管理资源限制使用-m、--cpus等参数限制容器可使用的内存和CPU防止单个容器耗尽主机资源。docker run -d -m 512m --cpus1.5 --name my-app my-image数据持久化容器内产生的数据如数据库文件、日志应使用**数据卷Volume或绑定挂载Bind Mount**持久化到宿主机避免容器删除后数据丢失。# 使用命名卷 docker run -d -v my-data:/var/lib/mysql mysql:8.0 # 使用绑定挂载 docker run -d -v /host/path/logs:/app/logs my-app使用Docker Compose管理多容器应用当应用包含多个服务如Web、数据库、缓存时使用docker-compose.yml文件来定义和启动所有容器管理起来更加方便。7.3 安全与维护非root用户运行在Dockerfile中创建并使用非root用户来运行应用程序遵循最小权限原则。RUN groupadd -r appuser useradd -r -g appuser appuser USER appuser CMD [nginx, -g, daemon off;]定期更新镜像定期重建镜像以更新其中的基础镜像和软件包修复安全漏洞。扫描镜像漏洞使用docker scan命令或集成到CI/CD流水线中的镜像安全扫描工具如Trivy、Clair来检查镜像中的已知漏洞。通过本文从镜像定制、仓库配置到服务部署的完整演练你不仅掌握了Docker的单项操作更理解了容器化应用从构建到运行的连贯逻辑。这套方法可以迁移到任何基于RPM系镜像的服务部署中。接下来你可以尝试用同样的思路去容器化你自己的应用或者学习更高级的主题如Docker网络、Docker Compose编排以及Kubernetes集群管理从而构建更健壮、更易扩展的云原生应用体系。 30款热门AI模型一站整合DeepSeek/GLM/Qwen 随心用限时 5 折。 点击领海量免费额度