apache 基于域名虚拟主机配置

封面图 • 2025-12-18 • APACHE

Apache 基于域名的虚拟主机（Virtual Host）配置，是通过 `NameBased Virtual Hosting` 实现的。这种配置方式允许你根据不同的域名（或子域名）将请求路由到不同的网站目录。

---

## 🧩 一、基本原理

Apache 默认使用基于 IP 的虚拟主机，但你可以通过设置 `NameVirtualHost` 和 `<VirtualHost>` 指令来实现基于域名的虚拟主机。

---

## 📦 二、配置步骤

### 1. 启用虚拟主机模块

确保 Apache 已启用 `mod_vhost_alias` 或 `mod_ssl`（如果需要 HTTPS）：

```bash
sudo a2enmod vhost_alias
```

或者检查是否已启用：

```bash
apachectl -M | grep vhost
```

如果没有启用，可以使用上面的命令启用。

---

### 2. 编辑 Apache 配置文件

通常在 `/etc/apache2/sites-available/` 目录下创建新的虚拟主机配置文件，例如：

```bash
sudo nano /etc/apache2/sites-available/example.com.conf
```

#### 示例配置文件内容：

```apache
<VirtualHost *:80>
    ServerAdmin admin@example.com
    ServerName example.com
    ServerAlias www.example.com

DocumentRoot /var/www/example.com/public_html
    <Directory /var/www/example.com/public_html>
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>

ErrorLog ${APACHE_LOG_DIR}/example.com-error.log
    CustomLog ${APACHE_LOG_DIR}/example.com-access.log combined
</VirtualHost>
```

- `ServerName`: 主域名
- `ServerAlias`: 可选，用于别名（如 www.example.com）
- `DocumentRoot`: 网站根目录
- `ErrorLog` 和 `CustomLog`: 日志路径

---

### 3. 创建网站目录和测试页面

```bash
sudo mkdir -p /var/www/example.com/public_html
sudo nano /var/www/example.com/public_html/index.html
```

写入一些内容：

```html
<!DOCTYPE html>
<html>
<head>
    <title>Example.com</title>
</head>
<body>
    <h1>Welcome to Example.com!</h1>
</body>
</html>
```

---

### 4. 启用该虚拟主机配置

```bash
sudo a2ensite example.com.conf
```

---

### 5. 重启 Apache 服务

```bash
sudo systemctl restart apache2
```

或者使用：

```bash
sudo apachectl graceful
```

---

## 🕹️ 三、验证配置

访问 `http://example.com` 查看是否显示你刚刚创建的页面。

---

## 🛡️ 四、HTTPS 配置（可选）

如果你要为域名启用 HTTPS，可以使用 `mod_ssl` 并配置 SSL 证书（如使用 [Let's Encrypt](https://letsencrypt.org/)）。

示例配置（`/etc/apache2/sites-available/example.com-le-ssl.conf`）：

```apache
<IfModule mod_ssl.c>
<VirtualHost *:443>
    ServerName example.com
    ServerAlias www.example.com

SSLEngine on
    SSLCertificateFile "/etc/ssl/certs/yourdomain.crt"
    SSLCertificateKeyFile "/etc/ssl/private/yourdomain.key"

ErrorLog ${APACHE_LOG_DIR}/example.com-ssl-error.log
    CustomLog ${APACHE_LOG_DIR}/example.com-ssl-access.log combined
</VirtualHost>
</IfModule>
```

然后启用并重启：

```bash
sudo a2ensite example.com-le-ssl.conf
sudo systemctl restart apache2
```

---

## 🧠 五、注意事项

- 确保域名解析正确（DNS A 记录指向服务器 IP）
- 如果使用多个虚拟主机，建议每个都单独配置
- 保留默认的 `000-default.conf` 文件，除非你不需要它

---

## ✅ 六、常见问题排查

- **无法访问**：检查防火墙、DNS 设置、Apache 错误日志（`/var/log/apache2/error.log`）
- **权限错误**：确保 `DocumentRoot` 目录权限正确（一般为 `www-data` 用户）
- **配置错误**：运行 `apachectl configtest` 检查配置语法

---

如果你需要我帮你生成一个具体的配置文件，或者你有特定的域名和路径，请告诉我，我可以直接帮你写好。