# 添加QUIC监听器
#### 操作场景
QUIC协议适用于高延时、跨地域网络访问，或者网络波动大、弱网络环境等场景，如移动网络下的短视频、直播等音视频业务。
QUIC协议是基于UDP的快速互联网连接协议，改善拥塞控制，不依赖内核协议支持，用户使用具有更高的灵活性。
QUIC协议具备低时延、避免队头阻塞的多路复用优势，极佳的弱网性能可以有效解决网络、视频卡顿的问题，提升网络使用体验，同时保障数据传输的安全性。
#### 背景知识
- QUIC协议： QUIC（Quick UDP Internet Connections）协议又称快速UDP互联网连接协议，具备低时延、避免队头阻塞的多路复用优势。极佳的弱网性能在严重丢包和网络延迟的情况下仍然可以提供服务，有效解决网络、视频卡顿的问题，提升网络使用体验。同时，内置TLS安全能力，保障数据传输的安全性。不依赖内核协议支持，用户使用具有更高的灵活性。
  
- ELB支持的QUIC协议类型： ELB支持iQUIC（IETF标准化版QUIC）。HTTP/3协议是基于iQUIC实现的新一代应用层协议，依赖iQUIC来实现多路复用、拥塞控制、丢包检测和重传等功能。HTTP/3协议可以更快地启动客户端连接，解决了多路复用流的队头阻塞问题，并且支持客户端IP地址切换时的连接迁移。
  ELB支持的HTTP/3协议版本为h3，支持的Chrome浏览器版本为Chrome 87及以上。
  
- QUIC监听器使用场景
  表1QUIC监听器使用场景 
  | 使用场景                 | 场景说明                                                                                                                                                                                                                |
  |:---|:---|
  | QUIC监听器单独使用           | 访问QUIC监听器的客户端都支持HTTP/3协议时，可以单独使用QUIC监听器。                                                                                                                                                                          |
  | QUIC监听器与HTTPS监听器联合使用 | 如果访问QUIC监听器的客户端未全部支持HTTP/3协议时，可以将QUIC监听器与HTTPS监听器联合使用，ELB会根据客户端的情况自动协商，优先使用HTTP/3协议。协商不成功时，会切换使用HTTPS或HTTP/2协议。 创建HTTPS监听器时，勾选"升级至QUIC"，并选择联合使用的QUIC监听器。即可实现QUIC监听器与HTTPS监听器联合使用。 |
     
  
 
#### 约束与限制
- 仅支持应用型负载均衡实例可以创建QUIC监听器。
  ![](https://support.huaweicloud.com/usermanual-elb/public_sys-resources/note_3.0-zh-cn.png)
  应用型规格实例支持创建QUIC监听器功能陆续上线中，请以控制台实际为准。
  
- QUIC监听器仅支持添加后端协议为HTTP/HTTPS/GRPC的后端服务器组。
- QUIC监听器关联的后端服务器组流量分配策略不支持源IP算法。
- 仅支持iQUIC，即HTTP/3，支持的版本为h3。
- QUIC监听器不支持添加以下HTTP头字段：
  - X-Forwarded-For-Port：通过重写X-Forwarded-For-Port字段获取客户端的端口。
  
  - X-Real-IP：通过重写X-Real-IP字段获取客户端的源IP地址。
   
- QUIC监听器不支持基于网段的转发策略。
 
#### 添加QUIC监听器
1. 进入[弹性负载均衡列表页面](https://console.huaweicloud.com/vpc/?locale=zh-cn#/elb/list)。
2. 在弹性负载均衡列表页面，单击需要添加监听器的负载均衡名称。
3. 切换到"监听器"页签，单击"添加监听器"配置监听器参数参见[表2]。
    表2独享型负载均衡配置QUIC监听器参数说明 
   | 参数              | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
   |:---|:---|
   | 前端协议           | 客户端与负载均衡监听器建立流量分发连接的协议。 协议选择QUIC。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
   | 监听端口             | 客户端与负载均衡监听器建立流量分发连接的端口。 取值范围\[1-65535\]。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
   | 名称（可选）           | 监听器名称。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
   | 获取客户端IP        | QUIC监听器不支持"获取客户端IP"，当前开关不生效。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
   | 高级转发策略          | 高级转发策略支持多样化的转发规则和转发动作，便于灵活分流业务，合理分配资源。 更多信息请参见[高级转发策略概述](https://support.huaweicloud.com/usermanual-elb/elb_ug_jt_060301.html)。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
   | 访问控制            | 您可以使用ELB监听器的**访问控制** 功能来**控制访问ELB监听器的IP地址，** 更多信息请参见[访问控制](https://support.huaweicloud.com/usermanual-elb/elb_03_0003.html)。 监听器的访问控制默认支持"**允许所有IP访问**"。 您可以为监听器的访问控制设置**白名单** 或**黑名单** ，并选择适用的IP地址组。 - **白名单** ：只有白名单中的IP可以访问ELB的监听器。监听器仅转发来自所选访问控制IP地址组中设置的IP地址或网段的请求。 配置了白名单，但是不在白名单的IP也能访问后端服务器，可能的原因是该连接为长连接，需要客户端或后端服务器断开该长连接。   - **黑名单**：黑名单中的IP禁止访问ELB的监听器。监听器不会转发来自所选访问控制策略组中设置的IP地址或网段的请求。                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
   | **证书配置**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    ||
   | 服务器证书          | QUIC监听器默认SSL解析方式为"单向认证"，需绑定服务器证书。 服务器证书用于SSL握手协商，需提供证书内容和私钥。详见[创建证书](https://support.huaweicloud.com/usermanual-elb/elb_ug_zs_0004.html)。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
   | SNI             | SNI（Server Name Indication 服务器名称指示）是一种TLS协议的扩展，用于解决在一个监听器托管多个域名时，需要根据不同的请求域名匹配证书进行认证的问题。 客户端在发起SSL握手请求时提交请求的域名信息，ELB在收到请求后，会根据请求的域名查找证书。 如果能够找到请求域名对应的SNI证书，则使用该证书进行认证。 如果没有找到请求域名对应的SNI证书，则使用**服务器证书**进行认证。 详情请参见[开启SNI证书实现多域名访问](https://support.huaweicloud.com/usermanual-elb/elb_ug_jt_0021.html)。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
   | SNI证书            | 开启SNI之后，您需要为监听器配置至少一个SNI证书。 只能选择指定了**SNI扩展域名**的服务器证书。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
   | **更多配置（可选）**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 ||
   | 数据压缩           | 开启将对特定文件类型进行压缩；关闭则不会对任何文件类型进行压缩。 - Brotli支持压缩所有类型。  - Gzip支持压缩的类型如下： text/xml text/plain text/css application/javascript application/x-javascript application/rss+xml application/atom+xml application/xml application/json。    说明： 该功能陆续上线中，已发布区域请以控制台实际为准。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
   | 后端建连失败重调度       | 开启此开关，当ELB与后端服务器因连接错误或请求超时导致建连失败时，ELB会向后端服务器组内的其他后端服务器发起重试。 最多重试4次，若均失败，则返回502或504错误码。 - 连接错误：ELB在连接后端服务器时发生错误 ，如无法连接、拒绝连接等，返回502错误码。  - 请求超时：后端服务器没有响应，返回504错误码。 - 连接超时：ELB尝试与后端服务器建立连接，但在超时时间内没有成功。  - 等待响应超时：ELB已发送请求到后端服务器，但在超时时间内没有及时收到响应。     注意：对于非幂等性请求方法的请求，例如POST、PATCH和DELETE，如果ELB已经将请求转发到后端服务器之后发生了错误，则不会重试。 说明： 该功能陆续上线中，已发布区域请以控制台实际为准。                                                                                                                                                                                                                                                  |
   | 超时时间           | 弹性负载均衡支持配置监听器的超时时间，方便用户根据自身业务情况，自定义调整超时时间。 - 空闲超时时间（秒） 如果在空闲超时时间内一直没有访问请求，负载均衡会中断当前连接，直到下一次请求到来时再重新建立新的连接。 时间取值范围\[10-4000\]。   - 请求超时时间（秒） 客户端向负载均衡发起请求，如果在请求超时时间内客户端没有完成整个请求的传输，负载均衡将放弃等待关闭连接。 时间取值范围\[1-300\]。   - 响应超时时间（秒） 负载均衡向后端服务器发起请求，如果响应超时时间内接收请求的后端服务器无响应，负载均衡会向其他后端服务器重试请求。如果重试期间后端服务器一直没有响应，则负载均衡会给客户端返回HTTP 504错误码。 如果开启了会话保持功能，响应超时时间内对应的后端服务器无响应，负载均衡将不会发起重试请求，直接返回HTTP 504错误码。 时间取值范围\[1-300\]。                                                                                                                |
   | 每秒新建连接限速（每可用区） | 默认不限速，支持选择"限速"并输入限速值。 限速值代表当前监听器下，负载均衡实例在每个可用区支持的每秒新建连接数上限。 取值范围\[1-1,000,000\]。当限速值大于弹性负载均衡的实例规格时，以实例规格为上限。 说明： 该功能陆续上线中，已发布区域请以控制台实际为准。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
   | 每秒并发连接限速（每可用区）  | 默认不限速，支持选择"限速"并输入限速值。 限速值代表当前监听器下，负载均衡实例在每个可用区支持的每秒并发连接数上限。 取值范围\[1-1,000,000\]。当限速值大于弹性负载均衡的实例规格时，以实例规格为上限。 如果降低并发连接限速，已建立连接不受影响。 说明： 该功能陆续上线中，已发布区域请以控制台实际为准。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
   | 标签            | 可通过配置该项使用标签功能。标签的"键"和"值"是一一对应的，其中"键"值是唯一的。 说明： 如果您的组织已经设定弹性负载均衡的相关标签策略，则需按照标签策略规则为弹性负载均衡添加标签。标签如果不符合标签策略的规则，则可能会导致弹性负载均衡创建失败，请联系组织管理员了解标签策略详情。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
   | 描述（可选）        | 对于监听器描述。 字数范围\[0-255\]。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
   | 附加HTTP头字段        | 根据您的业务需求，您可以选择添加的HTTP头字段。 - **客户端访问信息** ： - 通过重写X-Forwarded-Host字段获取客户端的域名。    - **负载均衡器信息** ： - 通过重写X-Forwarded-Proto字段获取访问负载均衡实例的监听器的协议。  - 通过重写X-Forwarded-ELB-IP字段获取负载均衡实例的公网IP地址。  - 通过重写X-Forwarded-Port字段获取负载均衡实例的监听端口。  - 通过重写X-Forwarded-ELB-ID字段获取访问的负载均衡实例的ID。     更多详情请参考[配置附加HTTP头字段](https://support.huaweicloud.com/usermanual-elb/zh-cn_topic_0118147668.html)。 说明： 支持附加HTTP头字段功能陆续上线中，已发布区域请以控制台实际为准。 |
      
   
4. 单击"下一步：配置后端分配策略"，配置监听器的默认后端服务器组。
   1. 推荐选择"使用已有"后端服务器组。
   
   2. 您也可选择"新创建"后端服务器组，添加后端服务器并配置健康检查，
      1. 配置后端服务器组参数请参见[表3](https://support.huaweicloud.com/usermanual-elb/elb_ug_hdg_0003.html#elb_ug_hdg_0003__table17921104011492)。
      
      2. 单击"下一步：添加后端服务器"，添加后端服务器并配置健康检查。 添加后端服务器详见[后端服务器概述](https://support.huaweicloud.com/usermanual-elb/elb_ug_hd3_0001.html)，配置健康检查参数请参见[表4](https://support.huaweicloud.com/usermanual-elb/elb_ug_hdg_0003.html#elb_ug_hdg_0003__zh-cn_topic_0000001383606924_table11861154278)。
         
       
    
5. 单击"下一步：确认配置"。
6. 确认配置无误后，单击"提交"。
 
#### 相关文档
- [创建监听器 - CreateListener](https://support.huaweicloud.com/api-elb/CreateListener.html)
- [更新监听器 - UpdateListener](https://support.huaweicloud.com/api-elb/UpdateListener.html)
- [查询监听器详情 - ShowListener](https://support.huaweicloud.com/api-elb/ShowListener.html)
- [删除监听器 - DeleteListener](https://support.huaweicloud.com/api-elb/DeleteListener.html)
- [级联删除监听器 - DeleteListenerForce](https://support.huaweicloud.com/api-elb/DeleteListenerForce.html)
 
