CentOS 7 Apache(httpd)安装与虚拟主机配置详解

第一次在一台 CentOS 7 服务器上部署 Web 环境时，我第一反应是去搜“Apache2 安装教程”，然后照着 Ubuntu 的习惯输入 apt install apache2 类似的思路，结果在 CentOS 上显然行不通。后来才弄明白，CentOS 7 里的 Apache HTTP Server 不叫 apache2，软件包名是 httpd，systemd 服务名也叫 httpd。这篇教程我会把从零到能跑通第一个站点的完整过程写清楚，包括安装前的环境准备、yum 安装步骤、主配置文件结构、虚拟主机拆分方法，以及装完后最容易踩到的防火墙、SELinux 和语法报错问题。适合刚接触 CentOS 7、对 Web 服务器还没有形成完整认知的新手，也适合需要快速在存量服务器上部署静态站点的运维朋友直接对照执行。

1. 先弄明白：CentOS 7 里的 Apache2 为什么包名是 httpd

你在 CentOS 7 上执行 yum search apache 会看到很多结果，但很难看到名为 apache2 的包；执行 yum install apache2 大概率直接提示没有匹配的包。这不代表系统里装不了 Apache，而是 CentOS 7 沿用了 RHEL 的命名习惯：Apache HTTP Server 的守护进程在 Unix/Linux 世界里本身就叫 httpd，CentOS 仓库就把软件包与启动脚本全部按 httpd 来命名。

1.1 官方项目名、包名和服务名要拆开看

Apache HTTP Server 是 Apache 软件基金会维护的开源软件。在 Debian/Ubuntu 系统上，它被包装成 apache2 包，提供服务名是 apache2；而在 CentOS/RHEL 系列系统上，它被包装成 httpd 包，安装后二进制文件在 /usr/sbin/httpd，systemd 服务名叫 httpd.service。同一个软件，两个系列的发行版用了不同的包名，这是历史遗留的维护习惯，并不是技术上的错误。

如果你在搜索引擎里看惯了“Ubuntu 安装 Apache2”，再切到 CentOS 7 环境时会很容易绕晕。最直接的解决方式是记住这句话：CentOS 7 里所有和 Apache 打交道的命令、服务名、目录基本都是 httpd，真正的包名也是 httpd，没有 apache2 这个顶层包名。教程标题里的“Apache2”指的是软件本身，而不是 CentOS 里的命令。

1.2 仓库里的 httpd 版本：为什么默认不是最新版

安装之前最好有个认知：CentOS 7 的 yum 默认仓库不会给你装最新的 Apache 版本，而是固定提供 Apache 2.4.6 系列。运行下面的命令可以确认这一点：

bash复制yum list available httpd

在默认源可用的情况下，你会看到类似下面的输出：

code复制httpd.x86_64   2.4.6-97.el7.centos   base

这种版本策略是为了避免发行版内部出现大面积依赖冲突。CentOS 的维护者会把安全补丁合并到 2.4.6 这个主版本里，然后以更高的 RPM release 号发布，比如 2.4.6-97。也就是说，版本号看起来不高，但它包含了官方同步过来的大量安全修复。对绝大多数业务场景来说，用发行版自带的 httpd 包是最稳妥的，既省去编译依赖的麻烦，也能直接和 systemd、日志轮转机制整合。如果你预期一定需要某个 Apache 新版本才有的特性，再考虑源码编译，否则不要提前陷入编译地狱。

2. 动手之前先做准备：yum 源、系统更新和主机名规划

很多人以为安装 httpd 就是一条命令的事，真正被卡住的地方往往发生在安装之前。最常见的两个问题，一是 yum 源没配好导致 yum install httpd 直接失败，二是主机名没有规划导致后续启动服务时总出现 ServerName 相关的警告。我建议在敲安装命令前，先把这几项花十分钟过一遍。

2.1 先确认系统版本、内核架构和 yum 源可用性

无论你手里拿的是 CentOS-7-x86_64-Minimal-2009.iso 还是 DVD ISO，安装完系统后的第一件事不是急着装 Web 服务，而是先确认这台机器的基本状态。依次执行：

bash复制cat /etc/redhat-release
uname -m
yum clean all
yum update -y

cat /etc/redhat-release 会告诉你系统具体是 CentOS Linux release 7 的哪个小版本；uname -m 用来确认架构是 x86_64 还是 aarch64。yum update 这一步在时间紧张时可能会被跳过，但我个人建议至少执行一次，尤其是新的 minimal 安装，因为初始源里的软件包索引很可能已经过期。更新过程不会影响 Apache 安装逻辑，却会减少后续因为依赖库版本过老而产生的奇怪问题。

如果执行 yum 命令时报连接错误，说明 /etc/yum.repos.d/CentOS-Base.repo 里的源地址在当前网络下不可达。这时需要把仓库文件里的 mirrorlist 行注释掉，换成可访问的 base 源地址。改完之后重新执行 yum clean all，让索引重新拉取。这一步属于最常规的环境修复，也是安装前最值得先做的一步。

2.2 主机名规划不做好，ServerName 警告会一直跟着你

刚装完系统时，主机名通常是默认的 localhost.localdomain。直接启动 httpd 后，系统日志和命令行里很容易出现类似下面的提示：

code复制AH00558: httpd: Could not reliably determine the server's fully qualified domain name

这个提示本身不致命，但它意味着 Apache 在做反向解析或生成默认跳转地址时拿不到完整域名。更规范的做法是在安装前设计好主机名，比如给这台服务器分配一个内部域名：

bash复制hostnamectl set-hostname web01.example.net

然后打开 /etc/hosts，把主机名和本机地址的对应关系写进去：

code复制127.0.0.1   localhost localhost.localdomain localhost4 localhost4.localdomain4
::1         localhost localhost.localdomain localhost6 localhost6.localdomain6
192.168.1.10   web01.example.net web01

这里的第三行需要替换成这台机器的实际 IP。做完之后执行 hostname 确认返回的是完整的 web01.example.net，再启动 httpd，ServerName 警告基本就会消失。这个步骤虽然不直接参与 Apache 的安装，但对后续虚拟主机的域名判断非常关键。

2.3 先用发行版包安装，不要急着碰源码编译

标题里带了“完整教程”四个字，有些读者会以为必须走源码编译流程才完整。实际上对于绝大多数部署场景，源码编译既不是必要的，也不是更优的。原因有三点：第一，源码包不会自动注册到 systemd，编译出的二进制、模块目录和 conf 目录都要手动设置；第二，Apache 的依赖 apr、apr-util、pcre 等都需要自己处理版本；第三，后续 yum 更新安全补丁时，源码安装的实例不会被自动覆盖维护。

默认方案应该始终是：

bash复制yum install -y httpd httpd-tools

只有当你需要定制 MPM 模块、修改编译参数、或者明确要用特殊模块组合且发行版包无法满足时，才值得去下载 Apache 源码包自己编译。编译安装适合已经具备排错能力的经验型运维，不适合项目期第一套环境。先跑通 yum 方案，把整个服务链路摸熟，之后如果确实需要编译版本，再单独隔离目录操作也不迟。

3. 正式安装：执行 yum 安装、启动并验证 httpd

准备工作做完后，安装本身其实很快。这一节用完整步骤把从安装到首次验证的过程铺开，同时解释为什么有些命令必须执行、有些验证结果应该重点看。

3.1 安装命令：httpd 和 httpd-tools 是配套组合

安装时不要只装 httpd，我建议连同 httpd-tools 一起装上：

bash复制yum install -y httpd httpd-tools

httpd 是主服务包，会带来 /usr/sbin/httpd 二进制文件、/etc/httpd/conf/httpd.conf 主配置、默认站点目录 /var/www/html，以及 systemd 单位文件。httpd-tools 则提供了若干个常用小工具，比如用于 Basic 认证的 /usr/bin/htpasswd，还有用于本地压测的 ab，后面排查问题会经常用到，所以一起安装很划算。

安装完成后建议确认一下 RPM 包是否正常落地：

bash复制rpm -qa | grep httpd

正常情况下你至少会看到 httpd 和 httpd-tools 两个包。如果你发现只装上了主包而 tools 包没装上，问题通常出在 yum 源未刷新或软件包索引不完整，这时候重新执行 yum clean all && yum makecache 再装一次即可。

3.2 启动服务：别再用 service，CentOS 7 基本靠 systemctl

安装完成后，启动服务前我习惯先手动检查一下当前配置文件语法，因为排错顺序应该从源头开始：

bash复制apachectl -t

如果输出只有一行：

code复制Syntax OK

说明配置暂没有问题，可以放心启动。接着执行：

bash复制systemctl start httpd
systemctl enable httpd

第一条命令是立刻启动服务，第二条命令是让 httpd 在系统重启后自动拉起。也可以把它们合并成一条：

bash复制systemctl enable --now httpd

用 systemctl enable 而不是去手工编辑 rc.local，是 systemd 时代的标准做法。如果你曾经用过老版本的 service httpd start，在 CentOS 7 上虽然也能工作，但底层已经被 systemd 接管，真正可靠的状态查询和异常记录都建议走 systemctl。

启动完成后用下面命令查看状态：

bash复制systemctl status httpd

如果看到 active (running)，说明服务已经正常起来。如果看到 failed，就需要进入后面的排错环节。这里注意一点，服务名是 httpd，不是 apache2，也不是 Apache，命令写错会得到 unit not found 的提示。

3.3 启动后的三项验证：端口、进程和本地响应

服务状态 running 有时并不等于真正对外可访问。我每次装完服务都会依次执行下面三条指令：

bash复制ss -lntp | grep :80
ps aux | grep httpd
curl -I http://127.0.0.1/

第一条命令会显示当前处于 LISTEN 状态的 80 端口，如果没有输出，表示 httpd 可能没有写入网络 socket，原因多半是配置里的 Listen 参数出了问题。第二条命令可以看到多个 httpd 进程，这是 Apache 的工作模式造成的，父进程负责管理，子进程负责处理请求，看到多个并不代表异常。第三条命令直接用本机向自己发起一次 HTTP HEAD 请求，如果返回类似下面的内容，说明服务已经能正常响应：

code复制HTTP/1.1 200 OK
Date: Mon, 02 Sep 2024 10:00:00 GMT
Server: Apache/2.4.6 (CentOS)
Last-Modified...
Content-Type: text/html; charset=UTF-8

到这一步，最基础的 httpd 安装和启动流程已经跑通。如果你只需要一个能访问的默认页面，此时在浏览器里输入这台机器的 IP 就能看到 Apache 测试页。

4. 理解 httpd.conf：不背全文，但要抓四条主线

装好服务只是第一步。真正让新手崩溃的，往往是从编辑 /etc/httpd/conf/httpd.conf 开始的。这个文件默认有一千行左右，绝大多数人不应该从头到尾读一遍。你只需要理解配置文件的组织方式，并且知道几个核心指令的作用，就能应付大部分业务场景。

4.1 配置文件靠 include 串起来，不用满世界翻文件

CentOS 7 的 httpd 配置目录结构大致如下：

code复制/etc/httpd/
├── conf/
│   └── httpd.conf
├── conf.d/
│   └── *.conf
├── conf.modules.d/
│   └── *.conf
├── logs -> /var/log/httpd
├── modules -> /usr/lib64/httpd/modules
└── run -> /run/httpd

httpd.conf 是主配置文件。但主文件内部靠 include 指令加载了其他目录里的配置，关键行类似：

code复制Include conf.modules.d/*.conf
IncludeOptional conf.d/*.conf

也就是说，只要 /etc/httpd/conf.d/ 下面放一个以 .conf 结尾的文件，它就会被自动加载。我建议日常操作遵循一个原则：全局参数和监听端口改主配置；独立的站点配置、模块级配置放到 conf.d 目录下的独立文件里。这样你排查问题时永远知道某段配置大概在哪个文件，不用在整台服务器上到处 grep。

4.2 四个核心指令：Listen、ServerName、DocumentRoot 和 Directory

主配置里有大量指令，对新手而言，最优先理解的是下面四个：

Listen 决定 httpd 监听哪些 IP 的哪些端口。默认值是：

apache复制Listen 80

如果你的业务要跑在 8080 端口，就改这里，但不要只在浏览器里访问 8080，防火墙和 SELinux 端口规则也要同步放开。否则就会出现 80 端口能开、8080 端口却怎么都访问不了的奇怪现象。

ServerName 是服务器对外宣称的域名。如果没有设置，启动时会看到 AH00558 警告。可以在主配置里写：

apache复制ServerName localhost:80

注意冒号后面要带端口号，否则可能报端口判断错误。更规范的做法是把 ServerName 写成这台机器将要对外提供服务的完整域名。

DocumentRoot 是网站默认目录，默认位置是：

apache复制DocumentRoot "/var/www/html"

不管这个目录未来是否要拆成多个虚拟主机，先把它和 Directory 指令配对理解。Directory 指令是对目录级别的访问控制做约束，比如：

apache复制<Directory "/var/www/html">
    Options Indexes FollowSymLinks
    AllowOverride None
    Require all granted
</Directory>

这段配置的含义是：允许 /var/www/html 目录被所有来源访问，目录访问不支持下层 .htaccess 覆盖，关闭目录浏览但允许符号链接跟随。如果你要启用伪静态规则，或者要在子目录里放 .htaccess，就需要把 AllowOverride None 改成 AllowOverride All，否则规则会被忽略，表现就是页面能打开但伪静态路径全部 404。

4.3 默认站点目录和“测试页”的衔接方式

安装完成后的默认页是 /usr/share/httpd/noindex/index.html，CentOS 通过 welcome.conf 实现了一个比较特别的引导页面。你访问服务器 IP 时会看到 Apache 测试页，那是安装包预置的页面，不代表你的业务文件已经就绪。

实际使用时，最简单的验证办法是在 /var/www/html 下创建一个测试文件：

bash复制echo "<h1>Hello httpd</h1>" > /var/www/html/index.html
curl -I http://127.0.0.1/

正常情况下，curl 的返回代码应该是 200。如果你真想用某个自定义目录作为站点根目录，可以去修改 DocumentRoot 和对应的 Directory，但我不建议直接在主配置里反复改路径。更好的做法是下面要讲的虚拟主机方案：每个站点一个目录、一个独立配置文件，目录隔离清晰，后续排错也不会影响默认站点。

5. 从单站点到虚拟主机：用 conf.d 分文件管理更稳妥

如果只是临时测一下服务，默认站点就够了。但真实业务几乎不会只挂一个静态页面、也不会只部署一个项目。这时候就需要配置虚拟主机。虚拟主机的价值在于让一台 httpd 根据 Host 请求头分发到不同网站目录，而不再把所有东西都塞进默认站点。CentOS 7 里配置虚拟主机不算复杂，关键是遵循分区管理的思路。

5.1 站点目录别随意放，先把根目录和子目录规划清楚

我习惯把每个独立项目的文档根目录放到 /var/www/ 下面，不用默认的 /var/www/html 作为所有业务的总出口。比如要建两个站点，可以是：

bash复制mkdir -p /var/www/siteA
mkdir -p /var/www/siteB

这样的好处是每个站点的 HTML 文件、静态资源和可能的 session 临时文件能互相隔离。即使日志文件由 Apache 统一管理，项目目录之间的权限边界也足够清晰。不要把所有项目文件全部堆在 /var/www/html 下，短期的确能跑，长期维护绝对会乱。

创建站点文件时写入一个最基础的首页：

bash复制cat > /var/www/siteA/index.html <<'EOF'
<!DOCTYPE html>
<html lang="zh-CN">
<head><meta charset="utf-8"></head>
<body><h1>Site A is running</h1></body>
</html>
EOF

5.2 一份可直接抄的虚拟主机配置

进入 /etc/httpd/conf.d/，创建一个独立配置文件，比如 siteA.conf：

apache复制<VirtualHost *:80>
    ServerName siteA.example.net
    DocumentRoot /var/www/siteA

    <Directory /var/www/siteA>
        Options -Indexes +FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>

    ErrorLog logs/siteA.example.net-error_log
    CustomLog logs/siteA.example.net-access_log combined
</VirtualHost>

ServerName 要写真实的域名或者访问时使用的 Host 头，DocumentRoot 要指向上面建的目录。配置里的 <Directory> 段比较关键：Require all granted 表示允许所有客户端访问；Options -Indexes 表示禁止列出目录结构，避免出现一个没有 index.html 的目录直接把文件全暴露出来。

配置文件写完后，先检查语法：

bash复制apachectl -t

看到 Syntax OK 后再重载配置：

bash复制systemctl reload httpd

使用 reload 而不是