# Apache模块 mod_vhost_alias
| [说明](#calibre_link-11) | 提供大批量虚拟主机的动态配置支持 |
| --- | --- |
| [状态](#calibre_link-12) | 扩展(E) |
| [模块名](#calibre_link-13) | vhost_alias_module |
| [源文件](#calibre_link-14) | mod_vhost_alias.c |
### 概述
本模块通过将HTTP请求中的IP地址和/或"`Host:`"头内容转换为所要提供服务的文件路径名来创建动态的虚拟主机配置。这样的做法，使得应用配置大量相似的虚拟主机变得更为容易。
### 注意
如果使用`mod_alias`或`mod_userdir`来将URI转换为文件名，那么`mod_vhost_alias`的设定将被覆盖。例如，下面的配置将始终把`/cgi-bin/script.pl` 映射为`/usr/local/apache2/cgi-bin/script.pl` 。
```
ScriptAlias /cgi-bin/ /usr/local/apache2/cgi-bin/
VirtualScriptAlias /never/found/%0/cgi-bin/
```
## 目录名称的转换
本模块中的所有指令都用于将字符串替换为路径名。被替换的字符串(以后称为"name")可以是服务器名(参见`UseCanonicalName`指令以了解决策方法)或者是"点数字"格式的虚拟主机IP地址。替换操作由`printf`格式修饰符控制，该修饰符有以下几种格式：
| `%%` | 插入一个百分号(`%`) |
| --- | --- |
| `%p` | 插入虚拟主机的端口号 |
| `%N.M` | 插入名称(或者名称的一部分) |
`N`和`M`被用来指定name中的子字符串。`N`从name中用小数点分隔的某部分中选取，而`M`是从`N`选中的字符串中选取部分字符。`M`是可选的且默认为"0"；小数点当且仅当`M`存在时才必须书写。替换操作如下：
| `0` | 整个name |
| --- | --- |
| `1` | 第一部分 |
| `2` | 第二部分 |
| `-1` | 最后一部分 |
| `-2` | 倒数第二部分 |
| `2+` | 从第二部分开始到最后的所有部分 |
| `-2+` | 倒数第二部分以及之前的各部分 |
| `1+`和`-1+` | 等同于`0` |
如果`N`或`M`大于部分的个数，则简单的用下划线来替换。
## 示例
对于一个简单的基于名称的虚拟主机，配置文件中可能会使用下面的指令：
```
UseCanonicalName Off
VirtualDocumentRoot /usr/local/apache/vhosts/%0
```
那么对`http://www.example.com/directory/file.html`的请求将会返回文件`/usr/local/apache/vhosts/www.example.com/directory/file.html`
对于拥有大量虚拟主机的情况而言，减少`vhosts`目录大小的一个好办法就是重新组织。为此你可以使用下面的配置：
```
UseCanonicalName Off
VirtualDocumentRoot /usr/local/apache/vhosts/%3+/%2.1/%2.2/%2.3/%2
```
那么对`http://www.domain.example.com/directory/file.html`的请求将会返回文件`/usr/local/apache/vhosts/example.com/d/o/m/domain/directory/file.html`
进一步的分割可以用name尾字符来索引(hashing)，例如：
```
VirtualDocumentRoot /usr/local/apache/vhosts/%3+/%2.-1/%2.-2/%2.-3/%2
```
该例返回文件`/usr/local/apache/vhosts/example.com/n/i/a/domain/directory/file.html`
也可以这样使用：
```
VirtualDocumentRoot /usr/local/apache/vhosts/%3+/%2.1/%2.2/%2.3/%2.4+
```
该例返回文件`/usr/local/apache/vhosts/example.com/d/o/m/ain/directory/file.html`
对于基于IP地址的虚拟主机，可以这样配置：
```
UseCanonicalName DNS
VirtualDocumentRootIP /usr/local/apache/vhosts/%1/%2/%3/%4/docs
VirtualScriptAliasIP /usr/local/apache/vhosts/%1/%2/%3/%4/cgi-bin
```
对`http://www.domain.example.com/directory/file.html`的请求将会返回文件`/usr/local/apache/vhosts/10/20/30/40/docs/directory/file.html` ，这里假设`www.domain.example.com`的IP地址为10.20.30.40。对`http://www.domain.example.com/cgi-bin/script.pl`的请求将会执行程序`/usr/local/apache/vhosts/10/20/30/40/cgi-bin/script.pl`
如果你希望在`VirtualDocumentRoot`指令中包含点字符(`.`)，但这又和`%`指令产生冲突，可以这样解决：
```
VirtualDocumentRoot /usr/local/apache/vhosts/%2.0.%3.0
```
对`http://www.domain.example.com/directory/file.html`的请求将会返回文件`/usr/local/apache/vhosts/domain.example/directory/file.html`
`LogFormat`指令的`%V`和`%A`在和本模块的协同中起了一定作用。
## VirtualDocumentRoot 指令
| [说明](#calibre_link-18) | 对于给定的基于名称的虚拟主机动态配置根文档目录 |
| --- | --- |
| [语法](#calibre_link-19) | `VirtualDocumentRoot _interpolated-directory_|none` |
| [默认值](#calibre_link-24) | `VirtualDocumentRoot none` |
| [作用域](#calibre_link-20) | server config, virtual host |
| [状态](#calibre_link-21) | 扩展(E) |
| [模块](#calibre_link-22) | mod_vhost_alias |
`VirtualDocumentRoot`指令使Apache可以通过虚拟主机的域名找到相应的文档。扩展_interpolated-directory_所得到的目录将会作为虚拟主机的根目录，这和`DocumentRoot`指令的参数是一样的。如果_interpolated-directory_为`none` ，那么`VirtualDocumentRoot`将被关闭。该指令不能和`VirtualDocumentRootIP`指令在同一作用域中使用。
## VirtualDocumentRootIP 指令
| [说明](#calibre_link-18) | 对于给定的基于IP的虚拟主机动态配置根文档目录 |
| --- | --- |
| [语法](#calibre_link-19) | `VirtualDocumentRootIP _interpolated-directory_|none` |
| [默认值](#calibre_link-24) | `VirtualDocumentRootIP none` |
| [作用域](#calibre_link-20) | server config, virtual host |
| [状态](#calibre_link-21) | 扩展(E) |
| [模块](#calibre_link-22) | mod_vhost_alias |
`VirtualDocumentRootIP`与`VirtualDocumentRoot`相似，只是替换操作时用的不是虚拟主机名称，而是IP地址。
## VirtualScriptAlias 指令
| [说明](#calibre_link-18) | 对于给定的基于名称的虚拟主机动态配置CGI目录 |
| --- | --- |
| [语法](#calibre_link-19) | `VirtualScriptAlias _interpolated-directory_|none` |
| [默认值](#calibre_link-24) | `VirtualScriptAlias none` |
| [作用域](#calibre_link-20) | server config, virtual host |
| [状态](#calibre_link-21) | 扩展(E) |
| [模块](#calibre_link-22) | mod_vhost_alias |
`VirtualScriptAlias`指令使Apache确定何处存放的是CGI脚本，这和`VirtualDocumentRoot`的做法是一样的。它匹配请求中的以`/cgi-bin/`开始的URI，更像"`ScriptAlias` `/cgi-bin/`"的作用。
## VirtualScriptAliasIP 指令
| [说明](#calibre_link-18) | 对于给定的基于IP的虚拟主机动态配置CGI目录 |
| --- | --- |
| [语法](#calibre_link-19) | `VirtualScriptAliasIP _interpolated-directory_|none` |
| [默认值](#calibre_link-24) | `VirtualScriptAliasIP none` |
| [作用域](#calibre_link-20) | server config, virtual host |
| [状态](#calibre_link-21) | 扩展(E) |
| [模块](#calibre_link-22) | mod_vhost_alias |
`VirtualScriptAliasIP`和`VirtualScriptAlias`相似，只是替换操作使用的不是虚拟主机名称，而是IP地址。
``
- Apache HTTP Server Version 2.2 文档 [最后更新：2006年3月21日]
- 版本说明
- 从1.3升级到2.0
- 从2.0升级到2.2
- Apache 2.2 新特性概述
- Apache 2.0 新特性概述
- The Apache License, Version 2.0
- 参考手册
- 编译与安装
- 启动Apache
- 停止和重启
- 配置文件
- 配置段(容器)
- 缓冲指南
- 服务器全局配置
- 日志文件
- 从URL到文件系统的映射
- 安全方面的提示
- 动态共享对象(DSO)支持
- 内容协商
- 自定义错误响应
- 地址和端口的绑定(Binding)
- 多路处理模块
- Apache的环境变量
- Apache处理器的使用
- 过滤器(Filter)
- suEXEC支持
- 性能方面的提示
- URL重写指南
- Apache虚拟主机文档
- 基于主机名的虚拟主机
- 基于IP地址的虚拟主机
- 大批量虚拟主机的动态配置
- 虚拟主机示例
- 深入研究虚拟主机的匹配
- 文件描述符限制
- 关于DNS和Apache
- 常见问题
- 经常问到的问题
- Apache的SSL/TLS加密
- SSL/TLS高强度加密：绪论
- SSL/TLS高强度加密：兼容性
- SSL/TLS高强度加密：如何...?
- SSL/TLS Strong Encryption: FAQ
- 如何.../指南
- 认证、授权、访问控制
- CGI动态页面
- 服务器端包含入门
- .htaccess文件
- 用户网站目录
- 针对特定平台的说明
- 在Microsoft Windows中使用Apache
- 在Microsoft Windows上编译Apache
- Using Apache With Novell NetWare
- Running a High-Performance Web Server on HPUX
- The Apache EBCDIC Port
- 服务器和支持程序
- httpd - Apache超文本传输协议服务器
- ab - Apache HTTP服务器性能测试工具
- apachectl - Apache HTTP服务器控制接口
- apxs - Apache 扩展工具
- configure - 配置源代码树
- dbmmanage - 管理DBM格式的用户认证文件
- htcacheclean - 清理磁盘缓冲区
- htdbm - 操作DBM密码数据库
- htdigest - 管理用于摘要认证的用户文件
- httxt2dbm - 生成RewriteMap指令使用的dbm文件
- htpasswd - 管理用于基本认证的用户文件
- logresolve - 解析Apache日志中的IP地址为主机名
- rotatelogs - 滚动Apache日志的管道日志程序
- suexec - 在执行外部程序之前切换用户
- 其他程序
- 杂项文档
- 与Apache相关的标准
- Apache模块
- 描述模块的术语
- 描述指令的术语
- Apache核心(Core)特性
- Apache MPM 公共指令
- Apache MPM beos
- Apache MPM event
- Apache MPM netware
- Apache MPM os2
- Apache MPM prefork
- Apache MPM winnt
- Apache MPM worker
- Apache模块 mod_actions
- Apache模块 mod_alias
- Apache模块 mod_asis
- Apache模块 mod_auth_basic
- Apache模块 mod_auth_digest
- Apache模块 mod_authn_alias
- Apache模块 mod_authn_anon
- Apache模块 mod_authn_dbd
- Apache模块 mod_authn_dbm
- Apache模块 mod_authn_default
- Apache模块 mod_authn_file
- Apache模块 mod_authnz_ldap
- Apache模块 mod_authz_dbm
- Apache模块 mod_authz_default
- Apache模块 mod_authz_groupfile
- Apache模块 mod_authz_host
- Apache模块 mod_authz_owner
- Apache模块 mod_authz_user
- Apache模块 mod_autoindex
- Apache模块 mod_cache
- Apache模块 mod_cern_meta
- Apache模块 mod_cgi
- Apache模块 mod_cgid
- Apache模块 mod_charset_lite
- Apache模块 mod_dav
- Apache模块 mod_dav_fs
- Apache模块 mod_dav_lock
- Apache模块 mod_dbd
- Apache模块 mod_deflate
- Apache模块 mod_dir
- Apache模块 mod_disk_cache
- Apache模块 mod_dumpio
- Apache模块 mod_echo
- Apache模块 mod_env
- Apache模块 mod_example
- Apache模块 mod_expires
- Apache模块 mod_ext_filter
- Apache模块 mod_file_cache
- Apache模块 mod_filter
- Apache模块 mod_headers
- Apache模块 mod_ident
- Apache模块 mod_imagemap
- Apache模块 mod_include
- Apache模块 mod_info
- Apache模块 mod_isapi
- Apache模块 mod_ldap
- Apache模块 mod_log_config
- Apache模块 mod_log_forensic
- Apache模块 mod_logio
- Apache模块 mod_mem_cache
- Apache模块 mod_mime
- Apache模块 mod_mime_magic
- Apache模块 mod_negotiation
- Apache模块 mod_nw_ssl
- Apache模块 mod_proxy
- Apache模块 mod_proxy_ajp
- Apache模块 mod_proxy_balancer
- Apache模块 mod_proxy_connect
- Apache模块 mod_proxy_ftp
- Apache模块 mod_proxy_http
- Apache模块 mod_rewrite
- Apache模块 mod_setenvif
- Apache模块 mod_so
- Apache模块 mod_speling
- Apache模块 mod_ssl
- Apache模块 mod_status
- Apache模块 mod_suexec
- Apache模块 mod_unique_id
- Apache模块 mod_userdir
- Apache模块 mod_usertrack
- Apache模块 mod_version
- Apache模块 mod_vhost_alias
- Developer Documentation for Apache 2.0
- Apache 1.3 API notes
- Debugging Memory Allocation in APR
- Documenting Apache 2.0
- Apache 2.0 Hook Functions
- Converting Modules from Apache 1.3 to Apache 2.0
- Request Processing in Apache 2.0
- How filters work in Apache 2.0
- Apache 2.0 Thread Safety Issues
- 词汇和索引
- 词汇表
- 指令索引
- 指令速查
- 模块索引
- 站点导航