用户手册
Version 1.9 — Rev. 3

# 虚拟主机模板

虚拟主机模板可以轻松创建许多配置相似的新虚拟主机。
每个模板都包含一个模板配置文件、一个映射侦听器列表以及一个成员虚拟主机列表。
要添加基于模板的虚拟主机，管理员只需向模板成员列表添加一个具有唯一虚拟主机名和合格域名的成员。 模板映射侦听器列表中的所有侦听器会自动添加侦听器到虚拟主机的映射。
稍后，如果您需要为特定虚拟主机自定义配置，只需“实例化”该成员虚拟主机，然后将自动创建一个独立的虚拟主机配置。 即使在设置自定义虚拟主机时，模板仍然可以作为便捷的起点。

### 模板名称

#### 描述

模板的唯一名称。

#### 语法

文本

### 模板文件

#### 描述

指定此模板配置文件的路径。 该文件必须位于$SERVER_ROOT/conf/templates/下，且文件名扩展名为".conf"。 如果指定的文件不存在，尝试保存模板后会显示包含"点击创建"链接的错误。 点击该链接将生成一个新的空模板文件。删除模板时，该条目会从配置中移除，但实际的模板配置文件不会被删除。

#### 语法

路径

### 映射的侦听器

#### 描述

指定此模板映射到的所有侦听器名称。 此模板成员虚拟主机的侦听器到虚拟主机映射会添加到此字段指定的侦听器。 该映射会根据成员虚拟主机各自配置中的域名和别名，将侦听器映射到虚拟主机。

#### 语法

逗号分隔列表

### 虚拟主机名

#### 描述

此虚拟主机的唯一名称。该名称在所有模板成员虚拟主机和独立虚拟主机中不得重复。 在目录路径配置中，此名称可以由变量$VH_NAME引用。
如果还配置了同名的独立虚拟主机，则成员虚拟主机配置会被忽略。

#### 语法

文本

### 域名

#### 描述

指定该成员虚拟主机的主域名。 如果留空，将使用虚拟主机名。该值应为完全限定域名，也可以使用IP地址。 对于不在端口80上的网站，建议附加:<port>。 对于包含域名的配置，可以使用变量$VH_DOMAIN来引用此域。
该域名将在以下情况下使用：

1. 处理请求时匹配Host标头中的主机名。
2. 填充FrontPage或AWstats等附加组件的域名配置。
3. 基于虚拟主机模板配置侦听器到虚拟主机的映射。

#### 语法

域名

### 域名别名

#### 描述

指定虚拟主机的备用名称。所有可能的主机名和IP地址都应添加到此列表中。名称中允许使用通配符*和?。对于不在端口80上的网站，请附加:<port>。
别名将在以下情况下使用：

1. 处理请求时匹配Host标头中的主机名。
2. 填充FrontPage或AWstats等附加组件的域名和别名配置。
3. 基于虚拟主机模板配置侦听器到虚拟主机的映射。

#### 语法

以逗号分隔的域名列表。

### 成员虚拟主机根目录

#### 描述

指定此虚拟主机的根目录。如果留空，将使用此模板的默认虚拟主机根目录。
注意：这不是文档根。建议将与虚拟主机相关的所有文件（如虚拟主机配置、日志文件、HTML文件、CGI脚本等）放置在此目录下。 虚拟主机根目录可以通过变量$VH_ROOT引用。

#### 语法

路径

### 默认虚拟主机根目录

#### 描述

指定使用此模板的成员虚拟主机的默认根目录。 路径中必须包含变量$VH_NAME。这样每个成员模板都可以根据名称自动分配独立的根目录。

#### 语法

路径

### 实例化虚拟主机配置文件

#### 描述

指定实例化成员虚拟主机时生成的配置文件位置。 路径中必须包含变量$VH_NAME，以便每个虚拟主机都有自己的文件。该文件必须位于 $SERVER_ROOT/conf/vhosts/下。只有在通过实例化将成员虚拟主机移出模板后，才会创建此配置文件。

#### 语法

包含$VH_NAME变量并以.conf为后缀的字符串

#### 提示

Information 建议使用$VH_NAME/vhconf.conf，便于管理。

### 文档根目录

#### 描述

指定每个成员虚拟主机的唯一文档根目录路径。 路径中必须包含变量$VH_NAME或$VH_ROOT，以便每个成员虚拟主机都有自己的文档根目录。

#### 语法

包含$VH_NAME或$VH_ROOT变量的路径

#### 示例

$VH_ROOT/public_html/或$SERVER_ROOT/$VH_NAME/public_html。

### 模板中使用的文件名

#### 描述

指定基于模板的虚拟主机设置所使用的文件路径。 路径中必须包含变量$VH_NAME或$VH_ROOT，以便每个成员虚拟主机解析到自己的文件。 此设置用于日志文件等归模板所有的文件，而不是用于实例化虚拟主机配置文件。

#### 语法

带有$VH_NAME或$VH_ROOT变量的路径