回顾

大家好，我是老马。

最近 dubbo3.x 在公司内部分享，于是想系统梳理一下。

总体思路是官方文档入门+一些场景的问题思考+源码解析学习。

QoS 命令的设计目的、使用方法说明，包括如何开启、关闭 qos 命令等，支持 HTTP/Telnet 访问方式

如何使用

QoS 提供了一些启动参数，来对启动进行配置，他们主要包括：

参数	说明	默认值
qos-enable	是否启动QoS	true
qos-port	启动QoS绑定的端口	22222
qos-accept-foreign-ip	是否允许远程访问	false
qos-accept-foreign-ip-whitelist	支持的远端主机ip地址（段）	(无)
qos-anonymous-access-permission-level	支持的匿名访问的权限级别	PUBLIC(1)

注意，从2.6.4/2.7.0开始，qos-accept-foreign-ip默认配置改为false，如果qos-accept-foreign-ip设置为true，有可能带来安全风险，请仔细评估后再打开。

telnet 与 http 协议

telnet 模块现在同时支持 http 协议和 telnet 协议，方便各种情况的使用示例：

  [shell]
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
➜  ~ telnet localhost 22222
Trying ::1...
telnet: connect to address ::1: Connection refused
Trying 127.0.0.1...
Connected to localhost.
Escape character is '^]'.
████████▄  ███    █▄  ▀█████████▄  ▀█████████▄   ▄██████▄
███   ▀███ ███    ███   ███    ███   ███    ███ ███    ███
███    ███ ███    ███   ███    ███   ███    ███ ███    ███
███    ███ ███    ███  ▄███▄▄▄██▀   ▄███▄▄▄██▀  ███    ███
███    ███ ███    ███ ▀▀███▀▀▀██▄  ▀▀███▀▀▀██▄  ███    ███
███    ███ ███    ███   ███    ██▄   ███    ██▄ ███    ███
███   ▄███ ███    ███   ███    ███   ███    ███ ███    ███
████████▀  ████████▀  ▄█████████▀  ▄█████████▀   ▀██████▀

dubbo>ls
As Provider side:
+----------------------------------+---+
|       Provider Service Name      |PUB|
+----------------------------------+---+
|org.apache.dubbo.demo.DemoService| N |
+----------------------------------+---+
As Consumer side:
+---------------------+---+
|Consumer Service Name|NUM|
+---------------------+---+

端口

新版本的 telnet 端口与 dubbo 协议的端口是不同的端口，默认为 22222

可以通过配置文件dubbo.properties 修改:

  [properties]
1
dubbo.application.qos-port=33333

或者通过设置 JVM 参数:

  [shell]
1
-Ddubbo.application.qos-port=33333

安全

默认情况下，dubbo 接收任何主机发起的命令

可以通过配置文件dubbo.properties 修改:

  [properties]
1
dubbo.application.qos-accept-foreign-ip=false

或者通过设置 JVM 参数:

  [shell]
1
-Ddubbo.application.qos-accept-foreign-ip=false

拒绝远端主机发出的命令，只允许服务本机执行。

同时可以通过设置qos-accept-foreign-ip-whitelist来指定支持的远端主机ip地址（段），多个ip地址（段）之间用逗号分隔，如：

配置文件dubbo.properties

  [properties]
1
dubbo.application.qos-accept-foreign-ip-whitelist=123.12.10.13, 132.12.10.13/24

设置 JVM 参数:

  [shell]
1
-Ddubbo.application.qos-accept-foreign-ip-whitelist=123.12.10.13,132.12.10.13/24

权限

为了对生命周期探针的默认支持，QoS 提供了匿名访问的能力以及对权限级别的设置，目前支持的权限级别有：

PUBLIC(1)
默认支持匿名访问的命令权限级别，目前只支持生命周期探针相关的命令
PROTECTED(2)
命令默认的权限级别
PRIVATE(3)
保留的最高权限级别，目前未支持
NONE(4)
最低权限级别，即不支持匿名访问

权限级别 PRIVATE> PROTECTED> PUBLIC> NONE, 高级别权限可访问同级别和低级别权限命令。当前以下命令权限为PUBLIC, 其它命令默认权限别为PROTECTED。

命令	权限等级
Live	PUBLIC (1)
Startup	PUBLIC (1)
Ready	PUBLIC (1)
Quit	PUBLIC (1)

默认情况下，dubbo 允许匿名主机发起匿名访问，只有PUBLIC权限级别的命令可以执行，其他更高权限的命令会被拒绝。

关闭匿名访问
可以通过设置qos-anonymous-access-permission-level=NONE来关闭匿名访问。

设置权限级别
可以通过配置文件dubbo.properties 修改:

  [properties]
1
dubbo.application.qos-anonymous-access-permission-level=PROTECTED

或者通过设置 JVM 参数:

  [shell]
1
-Ddubbo.application.qos-anonymous-access-permission-level=PROTECTED

HTTP 协议示例:

  [shell]
1
2
3
4
5
6
7
8
9
10
11
➜  ~ curl "localhost:22222/ls?arg1=xxx&arg2=xxxx"
As Provider side:
+----------------------------------+---+
|       Provider Service Name      |PUB|
+----------------------------------+---+
|org.apache.dubbo.demo.DemoService| N |
+----------------------------------+---+
As Consumer side:
+---------------------+---+
|Consumer Service Name|NUM|
+---------------------+---+

配置方式

优先顺序: 系统属性 > dubbo.properties > XML/Spring-boot 自动装配

系统属性

  [shell]
1
2
3
4
5
-Ddubbo.application.qos-enable=true
-Ddubbo.application.qos-port=33333
-Ddubbo.application.qos-accept-foreign-ip=false
-Ddubbo.application.qos-accept-foreign-ip-whitelist=123.12.10.13,132.12.10.13/24
-Ddubbo.application.qos-anonymous-access-permission-level=PUBLIC

dubbo.properties

在项目的src/main/resources目录下添加 dubbo.properties文件，内容如下:

  [properties]
1
2
3
4
5
dubbo.application.qos-enable=true
dubbo.application.qos-port=33333
dubbo.application.qos-accept-foreign-ip=false
dubbo.application.qos-accept-foreign-ip-whitelist=123.12.10.13, 132.12.10.13/24
dubbo.application.qos-anonymous-access-permission-level=PUBLIC

XML

如果要通过 XML 配置响应的QoS相关的参数，可以进行如下配置：

  [xml]
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans "
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance "
    xmlns:dubbo="http://dubbo.apache.org/schema/dubbo "
    xsi:schemaLocation="http://www.springframework.org/schema/beans 
    http://www.springframework.org/schema/beans/spring-beans.xsd 
    http://dubbo.apache.org/schema/dubbo  http://dubbo.apache.org/schema/dubbo/dubbo.xsd ">
    <dubbo:application name="demo-provider">
        <dubbo:parameter key="qos-enable" value="true"/>
        <dubbo:parameter key="qos-accept-foreign-ip" value="false"/>
        <dubbo:parameter key="qos-accept-foreign-ip-whitelist" value="123.12.10.13,132.12.10.13/24"/>
        <dubbo:parameter key="qos-anonymous-access-permission-level" value="NONE"/>
        <dubbo:parameter key="qos-port" value="33333"/>
    </dubbo:application>
    <dubbo:registry address="multicast://224.5.6.7:1234"/>
    <dubbo:protocol name="dubbo" port="20880"/>
    <dubbo:service interface="org.apache.dubbo.demo.provider.DemoService" ref="demoService"/>
    <bean id="demoService" class="org.apache.dubbo.demo.provider.DemoServiceImpl"/>
</beans>

spring-boot 自动装配

如果是 spring-boot 的应用，可以在application.properties或者application.yml上配置:

  [properties]
1
2
3
4
5
dubbo.application.qos-enable=true
dubbo.application.qos-port=33333
dubbo.application.qos-accept-foreign-ip=false
dubbo.application.qos-accept-foreign-ip-whitelist=123.12.10.13, 132.12.10.13/24
dubbo.application.qos-anonymous-access-permission-level=NONE

参考资料

https://cn.dubbo.apache.org/zh-cn/overview/mannual/java-sdk/reference-manual/qos/overview/

回顾
QoS 命令的设计目的、使用方法说明，包括如何开启、关闭 qos 命令等，支持 HTTP/Telnet 访问方式
- 如何使用
- 配置方式
参考资料

Dubbo3.x-54-单机运维命令 QOS 概述

回顾

QoS 命令的设计目的、使用方法说明，包括如何开启、关闭 qos 命令等，支持 HTTP/Telnet 访问方式

如何使用

telnet 与 http 协议

端口

安全

权限

配置方式

系统属性

dubbo.properties

XML

spring-boot 自动装配

参考资料

更多学习