配置基于域名的虚拟主机核心是利用HTTP请求头Host字段路由请求至独立目录,需启用Include指令、创建带权限的站点目录、编写含ServerName和DocumentRoot的VirtualHost块,并修改hosts文件实现本地解析。

配置基于域名的虚拟主机,核心是让 Apache 根据 HTTP 请求头里的 Host 字段,把不同域名的请求分发到各自独立的网站目录。它不需要额外 IP 或端口,本地开发和生产环境都最常用。
确保虚拟主机功能已启用
Apache 默认可能不加载虚拟主机配置,必须手动打开开关:
- 编辑主配置文件:/etc/apache2/apache2.conf(Ubuntu/Debian)或 /etc/httpd/conf/httpd.conf(CentOS/RHEL)或 Windows 下的 conf/httpd.conf
- 找到并取消注释这一行:Include conf/extra/httpd-vhosts.conf(Apache 2.4+ 常见)或 IncludeOptional sites-enabled/*.conf(较新 Debian 系统)
- 确认已声明监听端口,例如:Listen 80;如需 HTTPS,还要有 Listen 443
- 运行 sudo apache2ctl -t 或 sudo httpd -t 检查语法,输出 Syntax OK 才算通过
准备网站目录与权限
每个站点需要一个专属目录,且 Apache 进程(如 www-data 或 apache 用户)必须能读取其中内容:
Apache Superset 是一个广泛采用的开源 BI 平台,用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时,此技能非常有用。
- 创建目录,例如:sudo mkdir -p /var/www/site-a.local/public_html
- 放入测试页:echo "<h1>Site A</h1>" > /var/www/site-a.local/public_html/index.html
- 设置所有权(Linux/macOS):sudo chown -R $USER:www-data /var/www/site-a.local/public_html
- 设置目录权限:sudo chmod -R 755 /var/www/site-a.local
编写 VirtualHost 配置块
在 httpd-vhosts.conf 或 sites-available/site-a.local.conf 中添加如下结构(注意替换域名和路径):
<VirtualHost *:80>
ServerName site-a.local
ServerAlias www.site-a.local
DocumentRoot "/var/www/site-a.local/public_html"
<Directory "/var/www/site-a.local/public_html">
Require all granted
</Directory>
ErrorLog ${APACHE_LOG_DIR}/site-a-error.log
CustomLog ${APACHE_LOG_DIR}/site-a-access.log combined
</VirtualHost>
- ServerName 是唯一标识,必须精确匹配浏览器请求的 Host 值
- ServerAlias 可写多个别名,用空格分隔;支持通配符如 *.site-a.local
- Require all granted 是 Apache 2.4+ 的权限指令,替代旧版的 Allow from all
- 多个站点就复制粘贴多个 <VirtualHost *:80> 块,确保 ServerName 和 DocumentRoot 各不相同
完成本地测试闭环
仅改 Apache 配置还不够,浏览器必须能把域名解析到本机:
- 修改系统 hosts 文件:/etc/hosts(Linux/macOS)或 C:\Windows\System32\drivers\etc\hosts(Windows)
- 追加一行:127.0.0.1 site-a.local(可同时加多行,如 127.0.0.1 site-b.local)
- 保存后重启 Apache:sudo systemctl restart apache2(Debian/Ubuntu)或 sudo systemctl restart httpd(CentOS/RHEL)
- 浏览器访问 http://site-a.local,看到对应页面即成功

















