添加DataV数据代理服务

工作原理

1. 用户在DataV执行相关查询操作，DataV会将加密的SQL查询字符串和数据库ID值传递给DataV Proxy应用程序。

2. DataV Proxy解析加密信息，建立与指定数据库的连接，并发送SQL查询字符串。

3. 数据库执行SQL查询并返回查询结果给DataV Proxy。

4. DataV Proxy将查询结果返回至DataV。

使用场景

数据代理服务常用于以下场景：

• 跨域请求

  • 解决浏览器的同源策略限制，允许前端应用从不同域名的服务获取数据。

  • 通过代理服务器转发请求，使客户端能够顺利访问跨域资源。

• 数据安全

  • 身份验证和授权：对请求进行身份验证，确保只有经过认证的用户才能访问数据。

  • 数据加密：对传输中的数据进行加密，保护数据不被窃取或篡改。

  • 隐藏敏感信息：代理服务可以隐藏后端数据库的真实地址和结构，减少直接暴露的风险。

步骤一：启动DataV Proxy

请根据您的业务需要部署DataV Proxy（例如，部署至ECS、本地环境）并启动该服务。

• Windows：

  1. 下载DataV Proxy应用安装包。

  2. 存放至所需位置，解压后双击datav_proxy_win32_x64.exe文件，系统将自动创建代理并启动服务。

• Linux/Mac：

  1. 执行如下命令，下载DataV Proxy应用。

     wget https://sh-conf.oss-cn-shanghai.aliyuncs.com/doc_files/datav_proxy.zip                        

  2. 解压安装包，并定位到项目所在目录。

  3. 执行如下命令，启动服务。DataV Proxy服务默认在8001端口启动。

     chmod 777 ./*    //表示所有用户对当前目录下的文件和子目录均具备读、写、执行权限。 
     sh exec.sh start

     说明

     • 可通过sh exec.sh start -p [端口号]命令，设置端口号并启动。例如，sh exec.sh start -p 8080。

     • 执行sh exec.sh stop命令，可停止服务。

步骤二：进入DataV Proxy配置页面

服务启动成功后，需在浏览器中访问http://{服务器所在的域名/IP地址}:端口（例如，http://10.10.10.10:8001）。访问成功，将进入DataV Proxy应用配置页面。

• 域名/IP：安装DataV Proxy的服务器的域名/IP地址。请根据您的网络环境配置相应域名，当您处于内网环境时，请使用内网IP。

• 端口：DataV Proxy服务的启动端口。

步骤三：配置DataV Proxy数据源

根据业务需要，新建所需类型的数据源，以便DataV Proxy通过该数据源访问相应数据库。DataV Proxy支持创建多种类型的数据源，本文以RDS MySQL为例，为您介绍数据源配置操作。

1. 数据库添加白名单。

   为避免DataV Proxy访问数据库存在限制，您需将DataV Proxy服务所在IP地址添加至RDS MySQL数据库的白名单。

2. 在DataV Proxy配置页面的左侧导航栏，单击数据源配置，选择mysql，单击新增。

3. 在新建数据源对话框配置参数信息。

   参数	说明

   参数	说明
   id	自定义的数据源ID，不可重复。
   host	数据库所在服务器的IP地址或域名。 此处需填写RDS MySQL实例的外网地址，可在RDS管理控制台的实例基本信息页获取。例如，rm-bp1xxxxxxxxxxxxxhmo.mysql.rds.aliyuncs.com。
   user	登录数据库的账号名称。
   password	登录数据库的密码。
   database	数据库名称。
   port	数据库端口号。 RDS MySQL端口号通常为3306。
   maxPoolSize	连接池中允许的最大数据库连接数量。
   timeout	等待获取连接的最长时间，单位为ms。

4. 测试数据源连通性。

   • 单击SQL测试，可在弹出的对话框中输入SQL语句，测试数据库中的数据是否符合要求。

   • 单击连接池信息，查看数据库的连接数量。

步骤四：其他配置

在DataV Proxy配置页面的左侧导航栏，进行如下配置：

• 密钥及跨域设置：

  • 密钥：用于添加DataV数据代理服务时配置相关参数。单击一键生成新Key/Secret ，生成新的Access Key和Access Secret。

    重要

    原始密钥为空，首次单击一键生成新 Key/Secret，会生成原始密钥。后续再单击，会生成新的密钥，新密钥生成后旧密钥将失效。

  • 跨域设置：跨域Origins配置为http://datav.aliyun.com，允许DataV-Board访问到当前数据代理服务。

  

• 查询日志 ：可按需查看指定日志信息。

  重要

  Linux及Mac查询时支持指定日志行数范围、匹配关键字。

  

公网环境访问

公网环境访问数据代理服务时，请使用浏览器（例如，Chrome、Firefox）访问http://datav.aliyun.com/。

内网环境访问

使用内网地址访问数据代理服务，且使用高版本Chrome浏览器，需完成下述配置：

1. 私有网络请求的跨域资源共享（CORS）设置。

• Chrome 94以上版本：访问chrome://flags/#block-insecure-private-network-requests，将状态设置为disable，并重启浏览器。使浏览器不会阻止从不安全的上下文（HTTP）发起的对私有网络的请求。

• Chrome 108以上版本：访问chrome://flags/#unsafely-treat-insecure-origin-as-secure，在unsafely-treat-insecure-origin-as-secure中设置DataV-Board的HTTP地址，并重启浏览器。使浏览器允许将http://datav.aliyun.com 这个不安全的源（HTTP）视为安全的源（HTTPS），从而允许其使用某些仅限于安全上下文的功能。

  

2. 在DataV Proxy中配置允许跨域访问。