apache虚拟主机配置文件

apache虚拟主机配置文件的核心是用<VirtualHost>块把域名、端口、站点目录和日志绑定在一起，改完必须用apachectl -t检查语法并重载服务，否则配置不会生效。不绕弯子，直接告诉你文件在哪、怎么改、常见坑在哪，以及多域名和HTTPS的实操写法。

apache虚拟主机配置文件到底在哪

不同操作系统和安装方式,配置文件的位置不一样，你不需要死记硬背，只要掌握一个逻辑：Apache启动时会读取主配置文件，主配置里会通过Include指令把额外的配置文件加载进来。

• Debian/Ubuntu系统：主配置在/etc/apache2/apache2.conf，虚拟主机单独放在/etc/apache2/sites-available/目录下，启用后用sites-enabled/里的软链接生效。
• CentOS/RHEL系统：主配置在/etc/httpd/conf/httpd.conf，虚拟主机通常直接写在/etc/httpd/conf.d/目录下的.conf文件里。
• Windows环境：配置文件在Apache安装目录下的conf/httpd.conf，虚拟主机也在同一个文件里，或者通过Include引入。
• 宝塔面板/AMH等集成环境：路径一般是/www/server/apache/conf/或者/www/server/panel/vhost/apache/，每个站点一个文件。

判断当前生效路径有个笨办法：执行apachectl -V，输出里的HTTPD_ROOT和SERVER_CONFIG_FILE会直接告诉你主配置文件的绝对路径，打开主配置后，搜索Include关键字，就能看到虚拟主机目录的挂载位置。

apache虚拟主机配置不生效怎么办

很多人改完配置文件,发现访问域名还是跳到默认页面或者报404，这不是Apache没读到文件，而是以下几个原因在捣乱。

语法错误被静默忽略

执行命令：

apachectl -t

如果输出Syntax OK，说明语法没问题，如果报错，会具体告诉你哪个文件第几行有问题，最常见的是漏了结尾的</VirtualHost>标签，或者引号不配对。

配置了但没启用

Debian系系统下,sites-available里的文件不会自动生效，必须执行：

a2ensite your-site.conf
systemctl reload apache2

CentOS系则要看conf.d目录下文件后缀是不是.conf，如果不是，Apache不会读取。

域名解析没指向服务器

配置文件再正确,如果域名的A记录没指向这台服务器的IP，你访问域名时根本到不了Apache，先用

ping或者dig确认解析结果，本地测试的话，改/etc/hosts文件手动指向。

目录权限和默认首页缺失

虚拟主机指向的目录必须存在,且Apache用户（通常是www-data或apache）要有读取权限，目录下还要有index.html或index.php，否则即使配置正确也会看到目录列表或403。

重载服务而不是重启

改配置后建议用systemctl reload apache2而不是restart，Reload只重新读取配置，不断开已有连接，对线上影响更小，但如果是修改了监听端口或加载模块，则必须restart。

apache虚拟主机配置多个域名的三种写法

一台服务器上跑多个网站是虚拟主机最核心的用途,业内专家指出，按场景选择不同的虚拟主机类型，比盲目堆配置更靠谱。

基于域名：最常见的做法

一个IP地址对应多个不同域名,配置文件里写多个<VirtualHost :80>块，用ServerName区分。

<VirtualHost :80>
    ServerName blog.example.com
    DocumentRoot /var/www/blog
    ErrorLog ${APACHE_LOG_DIR}/blog-error.log
    CustomLog ${APACHE_LOG_DIR}/blog-access.log combined
</VirtualHost>
<VirtualHost :80>
    ServerName shop.example.com
    DocumentRoot /var/www/shop
    ErrorLog ${APACHE_LOG_DIR}/shop-error.log
    CustomLog ${APACHE_LOG_DIR}/shop-access.log combined
</VirtualHost>

访问blog.example.com时Apache自动匹配第一个块，访问shop.example.com时匹配第二个，注意ServerName必须唯一，不能重复。

基于端口：测试环境常用

开发阶段不想配域名,就不同端口对应不同站点，修改ports.conf或httpd.conf增加监听端口，比如Listen 8080和Listen 8081，然后写：

<VirtualHost :8080>
    ServerName localhost
    DocumentRoot /var/www/site1
</VirtualHost>
<VirtualHost :8081>
    ServerName localhost
    DocumentRoot /var/www/site2
</VirtualHost>

访问http://服务器IP:8080和8081看到不同站点，生产环境不建议这么做，因为用户记端口成本高，也不利于HTTPS证书部署。

基于IP：多IP服务器用

服务器绑定了多个IP地址时,用IP区分虚拟主机。

<VirtualHost 192.168.1.10:80>
    DocumentRoot /var/www/ip1
</VirtualHost>
<VirtualHost 192.168.1.11:80>
    DocumentRoot /var/www/ip2
</VirtualHost>

这种方式如今很少见,云服务器通常一个弹性公网IP搞定，多IP意味着更高的成本，行业共识认为，除非有特殊的合规或网络隔离要求，否则优先用基于域名的方式。

apache虚拟主机配置https的完整流程

给虚拟主机加HTTPS不是单独一个配置项,而是分三步：获取证书、配置443端口、跳转。

第一步：获取证书文件

证书通常包含三个文件：证书文件（.crt或.pem）、私钥文件（.key）、证书链文件（chain.crt），免费证书可以从Let’s Encrypt获取，也可以从云服务商申请免费一年期的证书，下载后统一放到/etc/apache2/ssl/或/etc/httpd/ssl/目录下。

第二步：写443端口的VirtualHost块

<VirtualHost :443>
    ServerName blog.example.com
    DocumentRoot /var/www/blog
    SSLEngine on
    SSLCertificateFile /etc/apache2/ssl/blog_example_com.crt
    SSLCertificateKeyFile /etc/apache2/ssl/blog_example_com.key
    SSLCertificateChainFile /etc/apache2/ssl/blog_example_com_chain.crt
    <Directory /var/www/blog>
        Options -Indexes
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

别忘了启用SSL模块：

a2enmod ssl
systemctl restart apache2

第三步：把80端口跳转到443

修改原来的80端口虚拟主机,加一行重定向：

<VirtualHost :80>
    ServerName blog.example.com
    Redirect permanent / https://blog.example.com/
</VirtualHost>

这样用户访问http://开头的地址，浏览器会自动跳到HTTPS，跳转后要注意网站内部的图片、CSS、JS链接必须改成相对路径或HTTPS，否则地址栏是锁形图标，但页面里依然有混合内容警告。

一个完整的HTTPS虚拟主机配置例子

把所有指令合在一起,就是一个可以直接套用的模板：

<VirtualHost :80>
    ServerName www.example.com
    ServerAlias example.com
    Redirect permanent / https://www.example.com/
</VirtualHost>
<VirtualHost :443>
    ServerName www.example.com
    ServerAlias example.com
    DocumentRoot /var/www/example
    SSLEngine on
    SSLCertificateFile /etc/ssl/example.com.crt
    SSLCertificateKeyFile /etc/ssl/example.com.key
    SSLCertificateChainFile /etc/ssl/example.com.chain.crt
    ErrorLog ${APACHE_LOG_DIR}/example-error.log
    CustomLog ${APACHE_LOG_DIR}/example-access.log combined
    <Directory /var/www/example>
        Options -Indexes +FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

配置文件里最容易踩的5个细节

除了上面说的大方向,有些小细节能让你的配置更稳。

• ServerAlias别漏写：想让人访问example.com和www.example.com都指向同一站点，就在ServerName下面加ServerAlias example.com，漏了的话，第二个域名会落到第一个虚拟主机上。
• DocumentRoot目录别用：写绝对路径，比如/var/www/html，不要写~/html这种相对路径。
• 日志文件要分开：每个虚拟主机配置独立的ErrorLog和CustomLog，否则所有站点日志混在一起，排错时想死的心都有。
• 修改默认站点：Debian系有个000-default.conf，它匹配所有未被其他虚拟主机匹配的请求，如果你想拦截未绑定域名，就在这个文件里写一个默认跳转或返回403。
• Options -Indexes一定要加：这行禁止显示目录文件列表，不加的话，用户直接访问没有索引文件的目录，能看到里面所有文件，这属于信息泄露。

Q&A：apache虚拟主机配置文件常见问题与排查

为什么我改了apache虚拟主机配置文件，网站还是显示默认页面？

先执行apachectl -t确认语法无误，再确认你的配置文件是否被Include加载，Debian系要检查sites-enabled里有没有软链接，CentOS系要检查文件后缀是不是.conf，最后看访问的域名是否和ServerName精确匹配，尤其注意大小写和有没有带www。

配置多个域名时，为什么第二个域名打不开？

检查第二个域名的DNS解析是否指向当前服务器IP,如果解析正常，确认第二个<VirtualHost>块里ServerName是否拼写正确，且没有和第一个重复。ServerAlias里如果有泛域名，比如.example.com，它会优先匹配所有子域名，导致具体的子域名配置失效。

apache虚拟主机配置https后，为什么页面排版全乱了？

这是典型的混合内容问题,页面通过HTTPS加载，但CSS、JS、图片还是HTTP链接，浏览器阻止了不安全请求，导致样式表加载失败，解决办法是全局替换站点内所有HTTP资源链接为HTTPS或相对路径，也可以在配置里加RequestHeader set X-Forwarded-Proto "https"，但最直接的方法是修改数据库或代码里的绝对URL。