异常教程

Docker 安装 Apache（超详细）

更新时间:

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

截止目前， 星球 内专栏累计输出 90w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 3100+ 小伙伴加入学习 ，欢迎点击围观

前言

在现代软件开发中，Docker 安装 Apache 已成为构建轻量级、可移植Web服务的常见方案。Docker 的容器化技术能够将Apache服务器及其依赖环境打包为独立单元，而Apache作为高性能的Web服务器，擅长处理静态文件和动态请求。本文将通过循序渐进的步骤，带领读者从零开始，掌握如何利用Docker快速部署Apache服务，并深入理解其核心原理。

环境准备：Docker 安装与验证

安装Docker

在开始之前，需要先在本地或服务器上安装Docker。以下是主流系统的安装命令示例：

操作系统安装命令
Ubuntu 20.04+sudo apt-get update && sudo apt-get install docker.io -y
macOS通过Docker Desktop图形界面安装（官网下载）
Windows在Windows商店搜索“Docker Desktop”并安装

安装完成后，运行以下命令验证Docker是否启动：

docker --version  
docker run hello-world

若输出包含“Hello from Docker!”字样，则表明环境已准备就绪。

Docker基础概念比喻

可以将Docker想象为“数字集装箱”：

  • 镜像（Image）：如同集装箱的设计图纸，定义了容器的运行环境。
  • 容器（Container）：基于镜像运行的实例，类似装载货物的集装箱。
  • Dockerfile：编写部署逻辑的“操作手册”，指导如何构建镜像。

核心步骤：从Dockerfile到容器运行

步骤1：编写Dockerfile

在项目根目录下创建名为Dockerfile的文件，并添加以下内容：

FROM httpd:latest  

COPY ./public-html/ /usr/local/apache2/htdocs/  

EXPOSE 80  

CMD ["apachectl", "-D", "FOREGROUND"]

指令详解

  • FROM：指定基础镜像，此处选用轻量级的httpd:latest（Apache官方镜像）。
  • COPY：将本地目录public-html复制到容器的网站根目录，类似“往集装箱里装载货物”。
  • EXPOSE：声明容器内部开放的端口，但需配合运行时参数映射到宿主机。
  • CMD：定义容器启动时执行的命令，确保Apache服务持续运行。

步骤2：构建镜像

在Dockerfile所在目录执行：

docker build -t my-apache-site .

此命令将根据Dockerfile生成名为my-apache-site的新镜像。

步骤3：运行容器

docker run -d -p 8080:80 --name my-apache-container my-apache-site

参数说明：

  • -d：后台运行容器。
  • -p 8080:80：将容器的80端口映射到本地的8080端口，类似“搭建桥梁”连接内外网络。
  • --name：为容器指定名称，便于后续管理。

验证部署效果

打开浏览器，访问http://localhost:8080。若看到页面内容，则表示Apache服务已成功运行。

配置与优化：增强功能与调试技巧

挂载数据卷（Data Volume）

若需动态更新网页内容，可使用数据卷替代直接复制文件。修改Dockerfile中的COPY指令为注释，运行容器时添加挂载参数：

docker run -d -p 8080:80 \  
  -v $(pwd)/public-html:/usr/local/apache2/htdocs \  
  --name my-apache-container my-apache-site

这样，本地目录的修改会实时反映到容器中，无需重新构建镜像。

自定义Apache配置

若需修改Apache的配置文件（如启用SSL或调整日志设置），可在Dockerfile中添加：

COPY ./conf/httpd.conf /usr/local/apache2/conf/httpd.conf

常见问题排查

  1. 端口冲突：若提示port is already allocated，可更换映射端口（如-p 8081:80）。
  2. 页面无法访问：检查防火墙设置，或运行docker logs my-apache-container查看容器日志。

实战案例：部署静态博客站点

场景描述

假设我们有一个静态博客目录my-blog，包含index.html和图片资源，需要通过Docker+Apache对外发布。

具体操作

  1. 目录结构： 
    my-blog/  
├── public-html/  
│   ├── index.html  
│   └── images/  
└── Dockerfile
  2. Dockerfile内容： 
    FROM httpd:2.4  
COPY public-html/ /usr/local/apache2/htdocs/  
EXPOSE 80
  3. 构建并运行： 
    docker build -t blog-site .  
docker run -d -p 8000:80 --name blog-container blog-site
  4. 访问结果：通过http://localhost:8000即可看到博客首页。

进阶技巧：结合多阶段构建与扩展

多阶段构建优化镜像体积

若需在容器内编译代码（如PHP动态页面），可采用多阶段构建：

FROM php:7.4-cli AS builder  
COPY . /src  
RUN cd /src && composer install  

FROM httpd:latest  
COPY --from=builder /src/public/ /usr/local/apache2/htdocs/

此方法将编译环境与运行环境分离，减少最终镜像体积。

扩展：集成MySQL数据库

若需同时部署数据库，可编写docker-compose.yml文件：

version: '3'  
services:  
  web:  
    build: .  
    ports:  
      - "8080:80"  
  db:  
    image: mysql:5.7  
    environment:  
      MYSQL_ROOT_PASSWORD: example

通过docker-compose up即可一键启动Apache和MySQL服务。

结论

通过本文的步骤，读者已掌握Docker 安装 Apache的全流程，并理解其背后的技术原理。无论是静态网站、动态Web应用，还是复杂的微服务架构，Docker与Apache的结合都能提供高效、可靠的解决方案。建议读者尝试将实际项目迁移到容器化环境中，体验“一次构建，到处运行”的便利性。

如需进一步学习，可探索Docker Hub上的Apache镜像变体（如包含PHP的httpd-php镜像），或研究Kubernetes等编排工具，将单机部署扩展为分布式集群。

最新发布

查看更多文章