### 虛擬主機
虛擬主機是路由配置中的頂層配置。每個虛擬主機都有一個邏輯名稱以及一組域列表,會根據傳入請求的主機頭路由到對應的域。這允許為單個監聽器配置多個頂級域的路徑樹。一旦基于域選擇了虛擬主機,就會進行路由處理,以便查找并路由到相應上游集群或者是否執行重定向。
```
{
"name": "...",
"domains": [],
"routes": [],
"require_ssl": "...",
"virtual_clusters": [],
"rate_limits": [],
"request_headers_to_add": []
}
```
- **name**<br />
(required, string) 虛擬主機的邏輯名稱。這在發送某些統計信息時使用,但與轉發無關。默認情況下,名稱的最大長度限制為60個字符。可通過`--max-obj-name-len`命令行參數設置為所需的值,以提高此限制。
- **domains**<br />
(required, array) 將與此虛擬主機相匹配的域(主機/機構頭)的列表。支持通配符匹配主機,如“*.foo.com”或“*-bar.foo.com”。請注意,通配符不匹配空字符串。例如“*-bar.foo.com”將匹配“baz-bar.foo.com”,但不匹配“-bar.foo.com”。另外,允許一個特殊的“*”匹配任何主機/機構頭。整個路由配置中只有一臺虛擬主機可以匹配“*”。域名在所有虛擬主機中必須是唯一的,否則配置將無法加載。
- **routes**<br />
(required, array) 路由列表,將按配置順序匹配傳入請求。第一條匹配的路由將被使用。
- **cors**<br />
(optional, object) 指定虛擬主機的CORS策略。
- **require_ssl**<br />
(optional, string) 指定虛擬主機所期望的TLS認證的配置類型。可能的值有:
- **all**<br />
所有請求都必須使用TLS。如果請求不使用TLS,則會發送302重定向,通知客戶端使用HTTPS。
- **external_only**<br />
來自外部請求必須使用TLS。如果請求是來自外部的,并且它沒有使用TLS,則會發送302重定向,通知客戶端使用HTTPS。
如果未指定此選項,則虛擬主機沒有TLS要求。
- **virtual_clusters**<br />
(optional, array) 為此虛擬主機定義的虛擬集群列表。虛擬集群用于進行其他統計信息收集。
- **rate_limits**<br />
(optional, array) 應用于虛擬主機的一組速率限制配置。
- **request_headers_to_add**<br />
(optional, array) 指定此虛擬主機要添加到每個請求的HTTP頭部列表。以下面的形式指定:
```
[
{"key": "header1", "value": "value1"},
{"key": "header2", "value": "value2"}
]
```
有關更多信息,請參閱[自定義請求頭部](../../Configurationreference/HTTPconnectionmanager/HTTPheadermanipulation.md)的文檔。
## 返回
- [上一級](../HTTPRouteconfiguration.md)
- [首頁目錄](../../README.md)
- 首頁
- 簡介
- Envoy是什么
- 架構介紹
- 術語
- 線程模型
- 監聽器
- L3/L4網絡過濾器
- HTTP連接管理
- HTTP過濾器
- HTTP路由
- gRPC
- WebSocket支持
- 集群管理
- 服務發現
- 健康檢查
- 連接池
- 負載均衡
- 異常檢測
- 熔斷
- 全局限速
- TLS
- 統計
- 運行時配置
- 跟蹤
- TCP代理
- 訪問日志
- MongoDB
- DynamoDB
- Redis
- 熱重啟
- 動態配置
- 初始化
- 逐出
- 腳本
- 部署
- 業界對比
- 獲得幫助
- 歷史版本
- 編譯安裝
- 編譯
- 參考配置
- 演示沙箱
- 前端代理
- Zipkin跟蹤
- Jaeger跟蹤
- gRPC橋接
- 構建Envoy Docker鏡像
- 工具
- 配置參考
- V1 API 概述
- V2 API 概述
- 監聽器
- 網絡過濾器
- TLS客戶端身份認證
- Echo
- Mongo代理
- 速率限制
- Redis代理
- TCP代理
- HTTP連接管理器
- 路由匹配
- 流量轉移/分流
- HTTP頭部操作
- HTTP頭部清理
- 統計
- 運行時設置
- 路由發現服務
- HTTP過濾器
- 緩存
- CORS過濾器
- 故障注入
- DynamoDB
- gRPC HTTP/1.1 橋接
- gRPC-JSON 轉碼過濾器
- gRPC-Web 過濾器
- 健康檢查
- 速率限制
- 路由
- Lua
- 集群管理
- 統計
- 運行時設置
- 集群發現服務
- 健康檢查
- 熔斷
- 訪問日志
- 限速服務
- 運行時配置
- 路由表檢查工具
- 運維管理
- 命令行選項
- 熱重啟
- 管理接口
- 統計概述
- 運行時配置
- 文件系統
- 自定義擴展示例
- V1 API參考
- 監聽器
- 網絡過濾器
- TLS客戶端身份認證
- Echo
- HTTP連接管理
- Mongo代理
- 速率限制
- Redis代理
- TCP代理
- HTTP路由配置
- 虛擬主機
- 路由
- 虛擬集群
- 速率限制配置
- 路由發現服務
- HTTP過濾器
- 緩存
- CORS過濾器
- DynamoDB
- 故障注入
- gRPC HTTP/1.1 橋接
- gRPC-JSON 轉碼過濾器
- gRPC-Web 過濾器
- 健康檢查
- Lua
- 速率限制
- 路由
- 集群管理
- 集群
- 健康檢查
- 熔斷
- TLS上下文
- 異常值檢測
- HASH環負載均衡配置
- 異常檢測
- 集群發現服務
- 服務發現服務
- 訪問日志
- 管理接口
- 限速服務
- 運行時配置
- 跟蹤
- V2 API參考
- 啟動引導
- 監聽&監聽發現
- 集群&集群發現
- 服務發現
- 健康檢查
- HTTP路由管理&發現
- TLS配置
- 通用的類型
- 網絡地址
- 協議選項
- 發現API
- 限速組件
- 過濾器
- 網絡過濾器
- TLS客戶端身份認證
- HTTP連接管理
- Mongo代理
- 速率限制
- Redis代理
- TCP代理
- HTTP過濾器
- 緩存
- 故障注入
- 健康檢查
- Lua
- 速率限制
- 路由
- gRPC-JSON轉碼器
- 常見訪問日志類型
- 常見故障注入類型
- FAQ
- Envoy有多快?
- 我在哪里獲得二進制文件?
- 我如何設置SNI?
- 如何設置區域感知路由?
- 我如何設置Zipkin跟蹤?