本文为您介绍如何为CLB实例添加UDP监听器。 ## 操作说明 * 目标端口未被其他UDP监听器监听。 * CLB实例有未被独占的带宽。若无，请调整已有监听器独占的带宽或者提升CLB实例的规格。 * 四层监听器（TCP和UDP协议）支持将请求转发至IPv4或IPv6的后端服务器。 ## 操作步骤 1. 登录[负载均衡控制台](https://console.volcengine.com/clb/LoadBalancer)。 2. 在顶部导航栏，选择目标资源所属的项目和地域。 3. 单击目标CLB实例右侧的“配置监听器”按钮。 4. 单击“添加监听器”按钮。 5. 参考下表，配置协议和端口。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_43a20f855cb56516c8e586c577d27a9c.png =831x) |参数 |说明 |取值样例 | |---|---|---| |监听器名称 |配置监听器的名称。如不填写，则默认为“协议\-端口” ，例如“UDP\-80”。 |listener\-1 | |负载均衡协议 |选择CLB实例监听的协议类型。本文选择UDP。 |UDP | |监听端口|输入监听的端口。范围为1～65535。|监听单端口，80|\ | || |\ | |* 监听单端口：输入单个端口。当监听器监听到该端口的UDP请求时，会将请求中的目的IP和端口替换成后端服务器的IP地址和端口，并转发到后端服务器。| |\ | | * 适用于后端服务器应用开放单个端口的场景。| |\ | | * 仅支持关联未开启全端口转发的后端服务器组。| |\ | |* 监听全端口：输入端口段。当监听器监听到该端口段内的UDP请求时，会将请求的目的IP替换成后端服务器的IP地址，并转发到后端服务器。| |\ | | * 对于全端口UDP监听器，一个CLB实例仅支持创建一个。| |\ | | * 适用于后端服务器应用开放连续端口范围的场景。| |\ | | * 仅支持关联已开启全端口转发的后端服务器组。| |\ | || |\ | |:::tip| |\ | || |\ | |* 对于后端服务器应用开放连续端口范围的场景，除使用单个监听器监听全端口的功能外，也可以添加多个监听器，使不同监听器监听不同的端口。| |\ | |* 监听器监听全端口功能正在邀测中，暂仅支持完成 [企业认证](https://www.volcengine.com/docs/6261/64937) 的账号申请试用，如需试用，请联系客户经理。| |\ | || |\ | |:::| | |调度算法|指定监听器转发请求遵循的规则。|加权轮询（WRR）|\ | || |\ | |* 加权轮询（WRR）：权重值越高的后端服务器，被轮询到的次数（概率）越高。| |\ | |* 加权最小连接数（WLC）：将请求分发给“当前连接/权重”比值最小的后端服务器。| |\ | |* 源地址哈希（SH）：基于源IP地址的一致性哈希，相同源地址的请求会调度到相同的后端服务器。 | | |超时时间 |当该时长范围内没有接收新的访问请求时，负载均衡会自动关闭连接。UDP协议默认为90秒，允许配置范围为1 \- 300秒。 |90秒 | 6. 参考下表，配置高级功能。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_32dc3d463b961464fcea43c910679f40.png =853x) |参数 |说明 |取值样例 | |---|---|---| |访问控制|是否开启访问控制。开启后，将限制监听转发的流量。详情参见[访问控制概述](https://www.volcengine.com/docs/6406/68990)。|开启，黑名单，policy01|\ | |开启后，请选择控制方式和策略组。| |\ | || |\ | |* **控制方式**| |\ | | * 黑名单：CLB实例拒绝转发黑名单内的IP地址的请求。| |\ | | * 白名单：CLB实例仅允许转发白名单内IP地址的请求。| |\ | |* **策略组**| |\ | | 策略组即一组IP地址。最多支持选择5个策略组。 | | |Proxy\-Protocol协议|是否开启Proxy\-Protocol协议。当后端服务器需要获取真实源IP地址，而报文源IP被替换（例如：IPv6请求转发至IPv4后端服务器）时，可以开启Proxy\-Protocol协议。|否|\ | || |\ | |* 启用Proxy Protocol协议功能需要在后端服务器上做对应适配，不支持在线平滑迁移，请谨慎配置。| |\ | |* 使用示例请参考[通过Proxy Protocol协议获取客户端源IP](https://www.volcengine.com/docs/6406/124440)。 | | |会话保持|是否开启会话保持。|开启，1000秒|\ | || |\ | |* 开启后，负载均衡会将来自同一个源IP地址的访问请求转发到同一台后端服务器进行处理。| |\ | |* 会话保持超时时间的取值范围：1～3600，单位为秒。 | | |带宽上限|是否开启独占带宽。|开启，100Mbps|\ | || |\ | |* 开启：监听器独占CLB实例的带宽。取值范围：1～CLB实例未被独占的带宽。单位为Mbps。| |\ | |* 不开启：监听器共享CLB实例未被独占的带宽。 | | |连接优雅中断|是否开启连接优雅中断。|开启，100秒|\ | || |\ | |* 开启后，当后端服务器被删除、健康检查异常时，现有连接在连接优雅中断超时时间内正常传输。| |\ | |* 连接优雅中断超时时间的取值范围：0～900，单位为秒。 | | |标签|标签由一个键值对组成，用于资源的分类和搜索。更多关于标签的介绍请参见[标签管理](https://www.volcengine.com/docs/6406/110615)。|* 标签键：listener\-key|\ | |单击添加图标，输入标签键和标签值，为监听器添加标签。 |* 标签值：listener\-test | 7. 单击“下一步”按钮，为监听器配置后端服务器组信息。 1. 请按需选择添加方式和后端服务器组。 * 若已有满足需求的后端服务器组，可搜索或下拉进行选择。 * 若没有满需需求的后端服务器组，可新建，详细参数介绍请参见[创建后端服务器组](https://www.volcengine.com/docs/6406/68076)。 2. 单击“下一步”按钮，为后端服务器组添加后端服务器。请按需选择添加方式并配置后端服务器。 * 如果已有后端服务器可使用，可选择立即添加，然后添加后端服务器并为其配置端口和权重，后端服务器参数的详细说明请参见[添加后端服务器](https://www.volcengine.com/docs/6406/71218)。 * 如果没有后端服务器可使用，请选择创建完监听器后再添加。 :::tip * 为后端服务器组添加后端服务器时，请确保后端服务器关联的安全组已开放与监听器相同的协议，可参考 [配置后端服务器安全组](https://www.volcengine.com/docs/6406/69033)。 * 监听器所属CLB实例为IPv4实例时，只能配置IPv4的后端服务器组；监听器所属CLB实例为双栈实例时，可以按需配置IPv4或IPv6的后端服务器组。 ::: 8. 单击“下一步”按钮，参考下表，配置健康检查。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_4b6659c272be3f00a0e15247b91c8b29.png =867x) |参数 |说明 |取值样例 | |---|---|---| |健康检查 |是否开启健康检查。开启后，CLB实例会定时向后端服务器发送请求以测试其运行状态，判断其是否可用。当探测到后端服务器运行状况不佳时，会停止向其发送流量，并将流量转发给其他正常运行的后端服务器。 |开启 | |健康检查端口 |默认使用后端服务器的业务端口作为健康检查端口。若开启全端口监听功能，则需要指定健康检查端口。 |1 | |健康检查请求 |指定健康检查发送的请求字符串。 |healthcheckrequest | |预期正确响应|健康检查结果正常时期望返回的响应字符串。|ok|\ | |:::tip| |\ | |如果指定了“健康检查请求”，则必须设置该参数。| |\ | || |\ | |:::| | |响应超时|开启健康健康后，输入等待健康检查响应的时间。|2秒|\ | || |\ | |* 若在响应超时时间内未收到后端服务器返回的正确信息，则认为健康检查失败。| |\ | |* 取值范围：1～60秒。默认为2秒， | | |检测间隔|开启健康健康后，输入执行健康检查的时间间隔。|2秒|\ | || |\ | |* 检测间隔时间需大于等于响应超时时间。| |\ | |* 取值范围：2～300秒。默认为2秒，即每2s对后端服务器进行一次健康检查。 | | |健康阈值|开启健康健康后，输入判断后端服务器正常的健康检查次数。|3次|\ | || |\ | |* 对同一后端服务器连续执行指定次数的健康检查，结果均成功时，其健康检查状态由“异常”变为“正常”。| |\ | |* 取值范围：2～10次。默认为3次。 | | |不健康阈值|开启健康健康后，输入判断后端服务器异常的健康检查次数。|3次|\ | || |\ | |* 对同一后端服务器连续执行指定次数的健康检查，结果均失败时，其的健康检查状态由“正常”变为“异常”。| |\ | |* 取值范围：2～10次。默认为3次。 | | 9. 单击“下一步”按钮。 10. 单击“确定”按钮，完成创建。 ## 验证网络连通性至此，您已成功配置了一个具有转发、健康检查、访问控制等功能的UDP协议的CLB实例，在实例管理主列表页可以看到该实例的公网/私网IP，客户端访问该实例的IP和监听端口，该实例即可将请求转发到后端服务器。 ## 相关文档 [CreateListener](https://www.volcengine.com/docs/6406/71777)：为指定负载均衡实例创建一个监听器。