能力 说明 鼠标控制 支持移动、点击、双击、右键、按下、释放、拖拽和滚动 键盘控制 支持按键、组合键和文本输入 屏幕观察 支持截取当前桌面屏幕，用于 Agent 观察界面状态 坐标获取 支持获取当前鼠标位置 等待控制 支持在自动化流程中等待页面或应用响应

工具调用示例 移动鼠标： plaintext { "name": "movemouse", "arguments": { "desktopCode": "xxx", "x": 500, "y": 300 } } 输入文本： plaintext { "name": "typetext", "arguments": { "desktopCode": "xxx", "text": "Hello from AIuse MCP" } } 创建目录： plaintext { "name": "createdirectory", "arguments": { "desktopCode": "xxx", "path": "C:/aiusertest" } } 常见问题 如果 Qoder 中没有加载出工具列表，请优先检查： 本地是否已安装 Node.js，且 npx v 可正常输出版本号。 MCP 配置中的 command、args 和 env 是否填写正确。 CTGAPIKEY 和 CTGAPISECRET 是否正确。 AccessKey 是否已关联目标云电脑。 目标云电脑是否在线。 调用工具时是否明确传入或说明了 desktopCode。 安全建议 不要将包含 AccessKey Secret 的 MCP 配置提交到公开仓库。 多人共享开发环境时，建议使用个人或项目级 AccessKey。 如 Qoder 或 MCP Client 支持密钥管理，建议优先使用密钥管理能力。 AccessKey 泄露后，应立即在控制台禁用并更换。

参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID，您可以查看 获取： 查 bb9fdb42056f11eda1610242ac110002

接口功能介绍 调用该接口查询集群一小时内的事件列表。 接口约束 无 URI GET /v2/cce/clusters//apis/events.k8s.io//events 路径参数 参数 是否必填 参数类型 说明 示例 下级对象 clusterId 是 String 集群ID，获取方式请参见如何获取接口URI中参数。 47281b02f87757478f20b1827c97cadf apiVersion 是 String 资源api的版本，请选择当前所操作集群支持的资源api版本，可参见Kubernetes版本与资源API版本对应表。 v1 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 labelSelector 否 String Kubernetes labelSelector，可通过label过滤资源；label之间通过“,”分隔，特殊符号要转义为url编码，如“”写为“%3D” name%3Daaa fieldSelector 否 String Kubernetes fieldSelector，可通过field过滤资源；label之间通过“,”分隔，特殊符号要转义为url编码，如“”写为“%3D”，以下为过滤Event常用的key及其含义： type：事件等级，有Normal和Warning两种等级 regarding.kind：产生事件资源的类型，如Pod、Node等 regarding.name：产生事件资源的名称 regarding.namesapce：产生事件资源所在的命名空间 regarding.kind%3DPod,type%3DNormal

使用保密字典 方式1： 通过挂载数据卷使用配置项 1、登陆云容器引擎控制台， 点击左侧导航栏中的集群，进入集群列表页。 2、在集群列表中点击需要使用保密字典的集群，进入集群管理页面。 3、在集群管理页面导航栏中选择工作负载， 在列表中选择需要创建的工作负载，本文以无状态为例。 4、点击新建，进入新建Deployment页面。 5、根据实际需要设置工作负载的基本信息（名称、镜像等），并在数据卷中，点击添加数据卷，选择secret类型，填写卷名称，并选择添加已有secret选择已有的保密字典。 6、在实例内容器的挂载点中，选择挂载数据卷，并添加挂载的容器路径及权限。 7、点击提交，完成创建。 方式2：环境变量中使用配置项 1、登陆云容器引擎控制台， 点击左侧导航栏中的集群，进入集群列表页面。 2、在集群列表中点击需要使⽤保密字典的集群，进入集群管理页面。 3、在集群管理页面导航栏中选择工作负载， 在列表中选择需要创建的工作负载，本文以无状态为例。 4、点击新建，进入新建Deployment页面。 5、根据实际需要设置工作负载的基本信息（名称、镜像等），并在环境变量中，点击新增变量，类型选择secretKeyRef，并选择已有的保密字典，填写环境变量名。 6、点击提交，完成创建。

参数 参数说明 名称 新建的镜像拉取凭证名称，同⼀个命名空间里命名必须唯⼀ 仓库域名 需要使用凭证认证的仓库域名 用户名 仓库认证用户名 密码 仓库认证密码 serviceAccount 在指定serviceAccount中加入该镜像拉取凭证

资源 1.19 1.21 1.23 1.25 1.27 1.29 1.31 Deployment apps/v1 apps/v1 apps/v1 apps/v1 apps/v1 apps/v1 apps/v1 StatefulSet apps/v1 apps/v1 apps/v1 apps/v1 apps/v1 apps/v1 apps/v1 DaemonSet apps/v1 apps/v1 apps/v1 apps/v1 apps/v1 apps/v1 apps/v1 ReplicaSet apps/v1 apps/v1 apps/v1 apps/v1 apps/v1 apps/v1 apps/v1 Job batch/v1 batch/v1 batch/v1 batch/v1 batch/v1 batch/v1 batch/v1 CronJob batch/v1beta1 batch/v1 batch/v1 batch/v1 batch/v1 batch/v1 batch/v1

资源 1.19 1.21 1.23 1.25 1.27 1.29 1.31 CustomResourceDefinition (CRD) apiextensions.k8s.io/v1 apiextensions.k8s.io/v1 apiextensions.k8s.io/v1 apiextensions.k8s.io/v1 apiextensions.k8s.io/v1 apiextensions.k8s.io/v1 apiextensions.k8s.io/v1 Event (events.k8s.io) events.k8s.io/v1 events.k8s.io/v1beta1 events.k8s.io/v1 events.k8s.io/v1beta1 events.k8s.io/v1 events.k8s.io/v1beta1 events.k8s.io/v1 events.k8s.io/v1 events.k8s.io/v1 events.k8s.io/v1

参数 参数说明 服务器地址 输入AD认证服务器地址。 域名 输入AD认证服务器域名。 端口 端口默认两个选择： 关闭SSL，默认为389端口。 开启SSL，默认为636端口。 支持自定义端口号。 BaseDN 填写AD认证服务器中设置的用户目录节点。 服务器账号名 填写AD认证服务器账号名称，默认为administrator。 账号密码 填写AD认证服务器账号密码。 过滤器 符合过滤条件的用户将被同步至云堡垒机。 例如：(&(objectClassperson))

接口功能介绍 用户查询实例绑定安全组列表 接口约束 需要提供数据库实例Id. URI GET /teledbdcp/v2/openapi/dcporderinfo/getInstanceSecurityGroups 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 instId 是 String 实例id 请求参数 请求头header参数 参数 是否必填 参数类型 说明 示例 下级对象 projectid 是 String 项目id 请求体body参数 无 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 接口状态码，参考下方状态码 200 error String 错误码 TELEDBDCP1000 message String 描述信息 returnObj Object 返回对象 returnObj 表 returnObj 参数 参数类型 说明 示例 下级对象 data Array of Objects 响应数据 data 表 data 参数 参数类型 说明 示例 下级对象 securityGroupName String 安全组名称 id String 安全组id description String 安全组描述信息 vpcId String 虚拟私有云网ID securityGroupRules Array of Objects 安全组规则信息 securityGroupRules 表 securityGroupRules 参数 参数类型 说明 示例 下级对象 direction String 出方向egress、入方向ingress etherType String IP类型:IPv4、IPv6 protocol String 协议: ANY、TCP、UDP、ICMP(v4) description String 安全组规则描述信息 id String 唯一标识ID securityGroupId String 安全组ID rangeMin String ICMP类型端口:最小值 rangMax String ICMP类型端口:最大值 action String 拒绝策略:允许accept 拒绝drop remoteIpCidr String 远端地址:0.0.0.0/0

画质问题可能由以下原因导致： 1. 原始内容质量。如果原始视频本身分辨率较低，转换后也不够清晰，建议选择高清片源。 2.网络带宽不足：网络不稳定时系统会自动降低画质以保证流畅，建议检查网络。 3. 环境光线。周围环境太亮会影响3D效果，建议调暗室内灯光，或在较暗环境下使用。 4. 设备镜片：检查AR/VR眼镜镜片是否干净，有污渍会影响观看效果。 为什么进入3D模式后，不能调整画面分辨率了？ 这是正常现象。3D模式下，系统为了保证最佳的3D效果和流畅度，会自动选择最优的分辨率方案，因此不支持手动调整。如果您觉得画质不够清晰，可以： 1. 退出3D模式，在云电脑普通模式下调整分辨率后再重新进入3D模式。 2. 检查网络状况，确保带宽充足。 3. 选择更高清的原始视频内容。 怎么让3D模式使用更流畅？ 以下是网络优化建议： 1. 使用5GWiFi：如果路由器支持，连接5GHz频段的WiFi，速度更快、干扰更少。 2. 避开高峰期：晚上810点是网络使用高峰期，尽量避开这个时段使用。 3. 独占网络：使用时让其他设备暂时断开网络，避免带宽被占用。 4. 靠近路由器：WiFi信号强度会影响体验，尽量靠近路由器使用。 5. 使用有线网络：如果条件允许，使用网线连接会更稳定。

工具/命令/服务 特点 说明 DCS控制台界面一键式迁移 操作简单，同时支持在线迁移和离线迁移（备份文件导入）两种方式，其中在线迁移支持增量数据迁移。 离线迁移，适用于源Redis和目标Redis网络不连通、源Redis不支持SYNC/PSYNC命令的场景。需要将数据备份文件导入到OBS，DCS从OBS桶中读取数据，将数据迁移到DCS的Redis中。 在线迁移，涉及到SYNC/PSYNC命令，适用于源Redis放通了SYNC/PSYNC命令的场景。支持将源Redis中的数据全量迁移或增量迁移到目标Redis中。 Rediscli Redis自带命令行工具，支持导出RDB文件，也支持将持久化的AOF文件整库导入。 AOF文件为所有数据更改命令的全量集合，数据文件稍大。 Rump 支持在线迁移，支持在同一个实例的不同数据库之间，以及不同实例的数据库之间迁移。 不支持增量迁移。建议停业务后迁移，避免出现Key丢失。详情参考 RedisShake 在线迁移和离线迁移均支持的一款开源工具。 适用于Cluster集群的数据迁移。 自行开发迁移脚本 灵活，根据实际情况适配。

迁移信息收集表 评估和准备阶段收集的信息填写参考下表： 迁移源 信息项 说明 ::: 源Redis （列出所有待迁移的实例） 源Redis实例的IP地址 源Redis （列出所有待迁移的实例） Redis访问密码（如有） 源Redis （列出所有待迁移的实例） 总数据量大小 info memory命令查询得到，参考usedmemoryhuman的值。 用于评估迁移方案、DCS缓存实例规格、ECS可用磁盘空间等是否满足，以及预估迁移耗时（业务中断时间）。 源Redis （列出所有待迁移的实例） 不为空的数据库编号 info keyspace命令查询得到。 用于确认迁移是否涉及多数据库，非AOF文件方式迁移，部分开源工具可能须逐库处理导出和导入。 DCS缓存实例中，单机和主备实例支持0255共256个数据库，集群默认只提供一个数据库。 源Redis （列出所有待迁移的实例） 各数据库的key数量 用于迁移后进行数据完整性验证。 源Redis （列出所有待迁移的实例） 数据类型 CDM迁移服务当前支持Hash和String两种数据格式，如果源数据含有list、set之类数据，请采用第三方迁移工具。 ECS（弹性云主机） 如果待迁移实例较多，可准备多台ECS并行迁移 弹性IP地址 选择与DCS缓存实例网络互通的弹性云主机进行数据导入，确保导入过程网络稳定。 带宽建议选取高配，提升数据传输效率。 ECS（弹性云主机） 如果待迁移实例较多，可准备多台ECS并行迁移 系统登录用户/密码 ECS（弹性云主机） 如果待迁移实例较多，可准备多台ECS并行迁移 CPU/内存 部分迁移工具支持多线程并行导入，使用高规格ECS，能提升导入速度。 ECS（弹性云主机） 如果待迁移实例较多，可准备多台ECS并行迁移 可用磁盘空间 ECS需要预留足够的可用磁盘空间，存储压缩文件以及解压后的缓存数据文件。 注：为提高数据传输效率，对于较大的数据文件，建议压缩后再传输到弹性云主机。 DCS缓存实例 （根据源Redis实例数与数据量情况选择合适的规格与实例数） 实例连接地址 DCS缓存实例 （根据源Redis实例数与数据量情况选择合适的规格与实例数） 实例连接端口 DCS缓存实例 （根据源Redis实例数与数据量情况选择合适的规格与实例数） 实例访问密码 DCS缓存实例 （根据源Redis实例数与数据量情况选择合适的规格与实例数） 实例类型 DCS缓存实例 （根据源Redis实例数与数据量情况选择合适的规格与实例数） 实例规格/可用内存 网络配置 VPC 提前规划VPC，确保应用服务、DCS缓存实例等处于相同VPC中。 网络配置 子网 网络配置 安全组或白名单 由于Redis 3.0和Redis 4.0/5.0/6.0实例部署模式不一样，控制访问方式也不一样，需要制定相应的安全组或白名单规则，确保网络连通。 ... ... 其他配置信息。

本节主要介绍使用在线迁移自建Redi 场景描述 在满足源端自建Redis和目标Redis的网络相通、源Redis放通SYNC和PSYNC命令这两个前提下，DCS支持通过在线迁移的方式，将源端的自建Redis数据全量或增量迁移到DCS目标Redis中。 约束与限制 如果源Redis禁用了SYNC和PSYNC命令，请务必放通后再执行在线迁移，否则会导致在线迁移失败。 在线迁移不支持公网方式直接迁移。 进行在线迁移时，建议将源端实例的参数repltimeout配置为300秒，clientoutputbufferlimit配置为源端实例最大内存的20%。 源端仅支持Redis 3.0及3.0以上的Redis版本。 较早建立的实例如果密码中包含单引号（'），则该实例不支持进行在线迁移，建议修改实例密码或使用其他迁移方式。 在线迁移，相当于临时给源端Redis增加一个从节点并且做一次全量同步到迁移机，建议在业务低峰期执行迁移，否则可能导致源端实例CPU瞬时冲高，时延增大。 前提条件 在迁移之前，请先阅读迁移方案概览，选择正确的迁移方案，了解当前DCS支持的在线迁移能力，选择适当的目标实例。 如果是单机/主备等多DB的源端实例迁移到Proxy集群实例，Proxy集群默认不开启多DB，仅有一个DB0，请先确保源端实例DB0以外的DB是否有数据，如果有，请先参考[开启多DB操作](

installation)。 wget b. 执行如下命令，解压Redis客户端源码包。 tar xzf redis5.0.8.tar.gz c. 进入Redis目录并编译Redis客户端源码。 cd redis5.0.8 cd src make 4. 使用如下命令导出RDB文件： rediscli h {sourceredisaddress} p {port} a {password} rdb {output.rdb} {sourceredisaddress}为源Redis的连接地址，{port}为源Redis的端口，{password}为源Redis的连接密码，{output.rdb}为RDB文件名。 执行命令后回显"Transfer finished with success."，表示文件导出成功。 上传RDB文件至ECS 为节省传输时间，建议先压缩RDB文件，再将压缩文件（如以SFTP方式）上传到ECS。 ECS需保证有足够的磁盘空间，供数据文件解压缩，同时要与缓存实例网络互通，通常要求相同VPC和相同子网，且安全组规则不限制访问端口。 导入数据 可借助RedisShake工具完成数据导入。 VPC内导入RDB文件，平均100w数据（每条数据20字节），大概4~10秒完成。 迁移后验证 数据迁移前如果目标Redis中数据为空，迁移完成后，可以通过以下方式确认数据的完整性： 1. 连接源Redis和目标Redis。连接Redis的方法请参考使用rediscli连接Redis实例。 2. 输入info keyspace，查看keys参数和expires参数的值。 3. 对比源Redis和目标Redis的keys参数分别减去expires参数的差值。如果差值一致，则表示数据完整，迁移正常。 如果导入不成功，请检查操作步骤，如果是导入命令不正确，建议使用flushall或者flushdb命令清理目标实例中的缓存数据，修改导入命令后重新导入。

本节主要介绍使用备份文件迁移不同Region/Redis版本的实例 DCS支持通过备份文件导入的方式离线迁移DCS实例间的数据。 前提条件 源Redis实例已执行数据备份并备份成功。 − 如果是通过Redis实例离线迁移，无需下载备份文件到本地，备份数据请参考手动备份实例。 − 如果是通过OBS桶离线迁移，需要下载备份文件到本地，请参考下载实例备份文件。 已准备目标Redis实例。如果您还没有目标Redis实例，请先创建Redis，参考创建实例。 目前Redis高版本支持兼容低版本，因此，同版本或低版本可以迁移到高版本Redis，目标端创建的实例版本不要低于源端Redis版本。 请确保目标Redis有足够的存储空间，迁移实例前建议清空目标Redis中的数据，清空实例数据的操作请参考清空实例数据。如果没有清空实例数据，数据迁移后，目标Redis与源Redis实例重复的数据会被覆盖，源Redis没有、目标Redis有的数据会保留。 使用备份文件离线迁移DCS Redis实例 如果您需要迁移的源Redis与目标Redis为DCS相同账号下相同Region的实例，且源Redis实例非单机实例时，离线迁移请参考通过Redis实例离线迁移。 如果您需要迁移的源Redis与目标Redis为DCS不同账号或不同Region的实例，或源Redis实例为单机实例时，离线迁移请参考通过OBS桶离线迁移。

本节介绍了使用RedisShake工具离线迁移自建Redis Cluster集群的相关内容。 RedisShake是一款开源的Redis迁移工具，支持Cluster集群的在线迁移与离线迁移（备份文件导入）。DCS Cluster集群与Redis Cluster集群设计一致，数据可平滑迁移。与在线迁移相比，离线迁移适用于源实例与目标实例的网络无法连通，或者源端实例部署在其他云厂商Redis服务中，无法实现在线迁移的场景。 本文以Linux系统环境为例，介绍如何使用RedisShake工具将自建的Redis Cluster离线迁移到DCS Cluster集群。 前提条件 已创建DCS Cluster集群Redis，创建Redis的方法，请参见创建实例。 创建的目标Redis内存规格不能小于源Redis。 已创建弹性云主机ECS。ECS请选择与DCS Cluster集群实例相同虚拟私有云、子网和安全组。 获取源Redis和目标Redis节点信息 1. 分别连接源端和目标端Redis。连接Redis的方法请参考使用rediscli连接Redis实例。 2. 在线迁移Cluster集群时需要将Cluster集群各个节点数据分别迁移。执行如下命令分别查询源端和目标Cluster集群的所有节点的IP地址与端口： rediscli h {redisaddress} p {redisport} a {redispassword} cluster nodes {redisaddress}为Redis的连接地址，{redisport}为Redis的端口，{redispassword}为Redis的连接密码。 在命令返回的结果中，获取所有master节点的IP端口。

配置RedisShake工具 1. 登录弹性云主机ECS。 2. 在ECS中执行以下命令下载RedisShake。本文以下载4.3.2版本为例，您可以根据实际需要下载其他RedisShake版本。 wget 3. 执行命令解压RedisShake文件。 mkdir redisshakev4.3.2 tar C redisshakev4.3.2 xzvf redisshakev4.3.2linuxamd64.tar.gz 4. 执行命令进入解压后的文件目录。 cd redisshakev4.3.2 5. 编辑RedisShake工具配置文件shake.toml，补充源端与目标端信息。 vim shake.toml 修改内容如下： [syncreader] 源端实例是Redis Cluster集群时，配置为true cluster true 源端Cluster集群任意一个节点的IP地址与端口 address {redisip}:{redisport} 如果无密码，本项不填 password {sourceredispassword} [rediswriter] 目标端实例是Redis Cluster集群时，配置为true cluster true 目标端Cluster集群任意一个节点的IP地址与端口 address {redisip}:{redisport} 如果无密码，本项不填 password {targetredispassword} 修改后按下Esc键退出编辑模式，输入:wq！按回车键保存配置并退出编辑界面。 在线迁移数据 使用如下命令同步源Redis集群和目标Redis集群数据： ./redisshake shake.toml 执行日志中出现如下信息，代表全量数据同步完成，进入增量同步阶段： syncing aof 执行日志出现如下信息时，代表增量同步无新增内容，可手动停止同步（Ctrl + C）： writeops[0.00], src, syncing aof, diff[0] 图 RedisShake在线迁移示意图

前提条件 在迁移之前，请先阅读迁移方案概览，选择正确的迁移方案，了解当前DCS支持的在线迁移能力，选择适当的目标实例。 如果您还没有目标Redis，请先创建，创建操作，请参考创建实例。 如果您已有目标Redis，则不需要重复创建，为了对比迁移前后数据及预留足够的内存空间，建议在数据迁移之前清空目标实例数据，清空操作请参考清空实例数据。 如果没有清空实例数据，数据迁移后，目标Redis与源Redis实例重复的数据会被覆盖，源Redis没有、目标Redis有的数据会保留。 创建在线迁移任务 注意 仅当在线迁移任务与源Redis为相同账号下相同区域时，在线迁移时选择的源端Redis会自动放通源Redis的SYNC和PSYNC命令。因此需要在源Redis相同账号和区域下创建在线迁移任务。否则无法进行在线迁移。 步骤 1 登录分布式缓存服务控制台。如果源Redis与目标Redis所属不同账号下，请使用源Redis所在的账号登录DCS。在管理控制台左上角单击 ，选择源Redis所在的区域。 步骤 2 单击左侧菜单栏的“数据迁移”。页面显示迁移任务列表页面。 步骤 3单击右上角的“创建在线迁移任务”。 步骤 4 设置迁移任务名称和描述。任务名称请以字母开头，长度不小于4位且不超过64位。任务名称只能包含字母、数字、中划线、下划线。 步骤 5 配置在线迁移任务虚拟机资源的VPC、子网和安全组。 请选择与源Redis或目标Redis相同的VPC。 创建的在线迁移任务会占用一个租户侧IP，即控制台上迁移任务对应的“迁移IP”。如果源端Redis或目标端Redis配置了白名单，需确保配置了迁移IP或关闭白名单限制。 迁移任务所选安全组的“出方向规则”需放通源端Redis和目标端Redis的IP和端口（安全组默认情况下为全部放通，则无需单独放通），以便迁移任务的虚拟机资源能访问源Redis和目标Redis。 结束

installation)。 wget b. 执行如下命令，解压Redis客户端源码包。 tar xzf redis5.0.8.tar.gz c. 进入Redis目录并编译Redis客户端源码。 cd redis5.0.8 cd src make 3. 执行如下命令开启缓存持久化，得到AOF持久化文件。 rediscli h {sourceredisaddress} p {port} a {password} config set appendonly yes {sourceredisaddress}为源Redis的连接地址，{port}为源Redis的端口，{password}为源Redis的连接密码。 − 开启持久化之后，如果AOF文件大小不再变化，说明AOF文件为全量缓存数据。 − 使用rediscli登录Redis实例，输入命令“config get dir”可以查找生成的AOF文件保存路径，文件名如果没有特殊指定，默认为：appendonly.aof。 − 生成AOF文件后如需关闭同步，可使用rediscli登录redis实例，输入命令“config set appendonly no”进行关闭。 上传AOF文件至ECS 为节省传输时间，建议先压缩AOF文件，再将压缩文件（如以SFTP方式）上传到ECS。 ECS需保证有足够的磁盘空间，供数据文件解压缩，同时要与缓存实例网络互通，通常要求相同VPC和相同子网，且安全组规则不限制访问端口。 导入数据 登录弹性云主机并执行如下命令导入数据。 rediscli h {dcsinstanceaddress} p {port} a {password} pipe < appendonly.aof {dcsinstanceaddress}为目标Redis连接地址，{port}为目标Redis的端口，{password}为目标Redis的连接密码。 VPC内导入AOF文件，平均100w数据（每条数据20字节），大概4~10秒完成。

实例类型 规格变更类型 实例规格变更的影响 单机、主备和读写分离实例 扩容/缩容 Redis 4.0及以上版本实例，扩容期间连接会有秒级中断，大约1分钟的只读，缩容期间连接不会中断。 Redis 3.0实例，规格变更期间连接会有秒级中断，5~30分钟只读。 如果是扩容，只扩大实例的内存，不会提升CPU处理能力。 单机实例不支持持久化，变更规格不能保证数据可靠性。在实例变更后，需要确认数据完整性以及是否需要再次填充数据。如果有重要数据，建议先把数据用迁移工具迁移到其他实例备份。 主备和读写分离实例缩容前的备份记录，缩容后不能使用。如有需要请提前下载备份文件，或缩容后重新备份。 Proxy和Cluster集群实例 扩容/缩容 水平扩容（分片数增加）： − 连接不中断，但会占用CPU，导致性能有20%以内的下降。 − 分片数增加时，会新增数据节点，数据自动负载均衡到新的数据节点，访问时延会增大。 水平缩容（分片数减少）： − 分片数减少时，会删除节点。Cluster集群实例缩容前，请确保应用中没有直接引用这些删除的节点，否则可能导致业务访问异常。 − 删除节点会导致连接闪断，请确保您的客户端应用具备重连机制和处理异常的能力，否则在变更规格后可能需要重启客户端应用。 垂直扩容（分片数不变，分片容量增加）： − 如果节点所在的虚拟机内存容量不足，会发生节点迁移，迁移时业务连接会有闪断和只读。 − 如果虚拟机内存容量充足，则直接扩大节点容量，对业务无影响。 垂直缩容（分片数不变，分片容量减少）：无影响。 实例缩容前，每个节点的已用内存要小于缩容后节点最大内存的70%，否则将不允许变更。 实例规格变更期间，可能会进行数据迁移，访问时延会增大。Cluster集群请确保客户端能正常处理MOVED和ASK命令，否则会导致请求失败。 实例规格变更期间，如果有大批量数据写入导致节点内存写满，将会导致变更失败。 在实例规格变更前，请先使用缓存分析中的大key分析，确保实例中没有大key存在，否则在规格改变后，节点间进行数据迁移的过程中，单个key过大（≥512MB）会触发Redis内核对于单key的迁移限制，造成数据迁移超时失败，进而导致规格变更失败，key越大失败的概率越高。 Cluster集群实例扩容或缩容时，请确保客户端开启集群拓扑自动刷新配置，否则在变更后需要重启客户端。Lettuce客户端开启集群拓扑自动刷新配置请参考 主备、读写分离和Cluster集群实例 副本数变更 Cluster集群实例增加或删除副本时，如果您使用的是Lettuce客户端，请确保开启集群拓扑自动刷新配置，否则在变更后需要重启客户端。开启集群拓扑自动刷新配置请参考

如果无密码，本项不填 target.passwordraw {targetredispassword} 目标Cluster集群所有master节点的IP地址与端口，以分号分隔 target.address {master1ip}:{master1port};{master2ip}:{master2port}…{masterNip}:{masterNport} 需要导入的rdb文件列表，用分号分隔 rdb.input {localdump.0};{localdump.1};{localdump.2};{localdump.3} 编辑完成后，按下Esc键退出编辑模式，输入:wq！按回车键保存配置并退出编辑界面。 c. 使用如下命令导入RDB文件到目标Cluster集群： ./redisshake type restore conf redisshake.conf 执行日志中出现如下信息时导入备份文件完成： Enabled http stats, set status (incr), and wait forever. 5. 迁移后验证。 数据迁移前如果目标Redis中数据为空，迁移完成后，可以通过以下方式确认数据的完整性： a. 连接源Redis和目标Redis。连接Redis的方法请参考使用rediscli连接Redis实例。 b. 输入info keyspace，查看keys参数和expires参数的值。 c. 对比源Redis和目标Redis的keys参数分别减去expires参数的差值。如果差值一致，则表示数据完整，迁移正常。

迁移后验证 数据迁移前如果目标Redis中数据为空，迁移完成后，可以通过以下方式确认数据的完整性： 1. 连接源Redis和目标Redis。连接Redis的方法请参考使用rediscli连接Redis实例。 2. 输入info keyspace，查看keys参数和expires参数的值。 3. 对比源Redis和目标Redis的keys参数分别减去expires参数的差值。如果差值一致，则表示数据完整，迁移正常。 注意 如果是全量迁移，迁移过程中源Redis更新的数据不会迁移到目标实例。

./rump from redis://127.0.0.1:6379/0 to redis://:@192.168.0.153:6379/0 .Sync done. [root@ecs ~]

本节主要介绍DCS实例迁移下云 场景介绍 您可以通过DCS控制台的在线迁移功能，将DCS实例迁移到自建Redis。另外，您也可以通过导出RDB文件，然后导入本地Redis实例或者自建Redis中。 推荐方案 DCS控制台在线迁移功能 在线迁移操作，操作可以参考使用在线迁移，选择目标Redis的数据源时，选择“自建Redis”，填写目标Redis地址。 使用Rediscli导出DCS实例RDB文件或者控制台导出实例数据文件，然后使用Redisshake导入。 关于Redisshake的安装和使用，请参考使用RedisShake工具迁移自建Redis Cluster集群及Redisshake配置说明。 Rump 支持在线迁移，网络条件允许的情况下，可以考虑使用此方式。指导说明请参考使用Rump在线迁移。

检查网络 步骤 1 检查源Redis、目标Redis、迁移任务资源所在VPC是否在同一个VPC内。 如果是，则执行配置在线迁移任务：创建在线迁移任务；如果不是，执行步骤2。 步骤 2 检查源Redis的VPC、目标Redis的VPC、迁移任务资源所在VPC的网络是否打通，确保迁移任务的虚拟机资源能访问源Redis和目标Redis。 如果已打通，则执行配置在线迁移任务；如果没打通，则执行步骤3。 步骤 3 执行相应操作，打通网络。 当源Redis和目标Redis都属于DCS同一region，请查看和创建对等连接，打通网络。 当源Redis和目标Redis属于不同的云厂商或不同Region，请打通网络。 结束 配置在线迁移任务 步骤 1 单击 “继续配置”，配置在线迁移的源Redis、目标Redis等信息。 如果还没准备好配置资源，可以单击“立即创建”创建迁移任务，等配置资源准备好后在数据迁移页面单击需要配置的迁移任务右侧的“配置”，继续配置在线迁移任务。 步骤 2 选择迁移方法。 支持“全量迁移”和“全量迁移＋增量迁移”两种，“全量迁移”和“全量迁移＋增量迁移”的功能及限制如下表所示。 表 在线迁移方法说明 迁移类型 描述 全量迁移 该模式为Redis的一次性迁移，适用于可中断业务的迁移场景。全量迁移过程中，如果源Redis有数据更新，这部分更新数据不会被迁移到目标Redis 。 全量迁移＋增量迁移 该模式为Redis的持续性迁移，适用于对业务中断敏感的迁移场景。增量迁移阶段通过解析日志等技术， 持续保持源Redis和目标端Redis的数据一致。增量迁移，迁移任务会在迁移开始后，一直保持迁移中状态，不会自动停止 。需要您在合适时间，在“操作”列单击“停止”，手动停止迁移。停止后，源端数据不会造成丢失，只是目标端不再写入数据。增量迁移在传输链路网络稳定情况下是秒级时延，具体的时延情况依赖于网络链路的传输质量。 图 选择迁移方法 步骤 3 仅当迁移方法选择“全量迁移+增量迁移”时，支持选择是否启用“带宽限制”。 如果启用带宽限制功能，当数据同步速度达到带宽限制时，将限制同步速度的继续增长。 步骤 4 选择是否“自动重连”。如开启自动重连模式，迁移过程中在遇到网络等异常情况时，会无限自动重连。 自动重连模式在无法进行增量同步时，会触发全量同步，增加带宽占用，请谨慎选择。 步骤 5 分别配置“源Redis”和“目标Redis”。 1. 配置“源Redis类型”和“源Redis实例”： “源Redis类型”请选择“自建Redis”，并在“源Redis实例”处输入源Redis的IP地址和端口。 如果源Redis为Cluster集群，需要输入集群所有主节点的IP端口，用英文逗号隔开。例如：192.168.1.1:6379,192.168.0.0:6379 2. 配置“目标Redis类型”和“目标Redis实例”： “目标Redis类型”请选择“云服务Redis”，并在“目标Redis实例”处选择需要迁移的目标Redis。 3. 分别配置“源Redis实例密码”和“目标Redis实例密码”：如果是密码访问模式实例，在输入连接实例密码后，单击密码右侧的“测试连接”，检查实例密码是否正确、网络是否连通。如果是免密访问的实例，请直接单击“测试连接”。如果测试连接失败，请检查输入的实例密码是否正确、Redis实例与迁移任务网络是否打通。 步骤 6 单击“提交”。 步骤 7 确认迁移信息，然后单击“提交”，开始创建迁移任务。 可返回迁移任务列表中，观察对应的迁移任务的状态，迁移成功后，任务状态显示“成功”。 如果出现迁移失败，建议单击迁移任务名称，进入迁移任务详情页面，通过“迁移日志”排查迁移失败的原因。 如果是增量迁移，全量迁移后会一直处于增量迁移中的状态。 如需手动停止迁移中的任务，勾选迁移任务左侧的方框，单击迁移任务上方的“停止”，即可停止迁移。 结束

本节说明云电脑3D模式的产品介绍。 云电脑3D模式 云电脑3D模式是通过AI实时算法，将任意2D内容（视频、游戏、网页、PPT等）一键转换为立体3D效果，无需专门片源和昂贵设备，即可获得沉浸式3D体验的功能。核心能力如下： 实时2D转3D：AI算法实时转换，无需预处理 任意内容支持：所有云电脑画面都能3D效果显示 多设备兼容：支持VR/AR眼镜、快门眼镜、3D投影仪等类型显示设备 技术亮点 实时2D转3D算法 采用先进的AI视觉技术（玄空视觉模型），通过海量视频数据训练，能够实时分析2D画面并转换为3D立体效果，转换速度快、延迟低。 云端渲染+终端呈现 基于AIGC云流传输技术4.0，云端实时生成3D画面，网络高效传输，终端保真呈现，形成端到端能力闭环。 支持设备 提供多类产品形态，满足多场景3D 使用需求 VR盒子模式 手机配合VR眼镜盒子和手柄使用，将手机放入VR盒子后即可获得沉浸式3D体验，支持鼠标操控，价格亲民，适合个人影音娱乐和科普教育场景。 AR眼镜模式 手机或笔记本连接AR眼镜，开启3D模式后呈现高清口袋巨屏效果，支持手机触屏操作，2D/3D随时切换，适用于个人办公娱乐、企业会议和培训场景。 快门眼镜+3D投影仪模式 投影仪搭配快门眼镜使用，支持多人共享观看，3D效果突出，可外接键鼠操作，适用于高端家庭影音、企业规模教学和公共服务机构展览展示场景。 红蓝眼镜模式 佩戴红蓝眼镜，在普通显示器上即可观看3D内容，无需特殊设备，适合入门级3D体验和个人尝鲜使用。

本节介绍3D模式的功能操作。 开启3D模式 AR眼镜连接指引 AR眼镜连接安卓客户端 AR眼镜连接IOS客户端 AR眼镜连接PC客户端 VR眼镜盒子连接指引 快门眼镜+3D投影仪连接指引 切换设备和退出3D模式 附录 VITURE品牌VR眼镜3D开启方式 雷鸟品牌VR眼镜3D开启方式 开启3D模式 1.登录天翼AI云电脑客户端； 2.开启3D模式，您可以通过以入口进 入3D模式： 云电脑客户端工具栏中【3D模式】按钮。 客户端设置面板中【3D模式】按钮。 移动端悬浮球右键菜单。 客户端在快捷应用中【3D模式】启动项（包括桌面内外快捷应用入口）。 客户端应用列表页面开启3D模式入口。 3.选择使用的3D设备。 说明 需要开通订购3D模式后使用，开通流程详见 功能订购。 不同客户端支持的设备不同，详情见 设备适配清单。 根据设备类型查看对应连接指引。

本节主要介绍使用Redisshake工具在线全量迁移其他云厂商Redis Redisshake是一款开源的Redis迁移工具，在Rump模式下，Redisshake可以以scan的方式从源端Redis获取全量数据，写入到目的端，实现数据迁移。这种迁移方式不依赖于SYNC和PSYNC，可以广泛应用于自建Redis、云Redis之间的迁移。 本文将介绍如何利用Redisshake的Rump模式，以在线全量的迁移方式，一次性将其他云厂商Redis迁移至DCS中。 本方案数据流向示意图 前提条件 已在目标端云服务创建Redis实例。 已在目标端云服务创建用于运行Redisshake的弹性云主机(ECS)。 创建的ECS需要选择与Redis实例相同的VPC，并且需要绑定弹性公网IP。 Rump模式不支持增量数据迁移，建议您先停止源端Redis的写入再进行迁移，防止数据不一致。 该方案配置只支持同DB映射迁移，异DB映射迁移该方案配置不适用。 源端为多DB使用（有非DB0的DB使用），DCS为Proxy集群时，DCS需要开启多DB模式，否则会迁移失败（单DB0的Proxy集群不支持select命令）。 源端为多DB使用（有非DB0的DB使用），DCS为Cluster集群时，该方案不支持（DCS Cluster集群只支持DB0模式）。 操作步骤 步骤 1 分别在ECS和源端转发服务器上安装Nginx，本文以ECS操作系统为Centos7.x为例进行安装，不同操作系统命令稍有不同。 1. 执行以下命令，添加Nginx到yum源。 sudo rpm Uvh 2. 添加完之后，执行以下命令，查看是否已经添加成功。 yum search nginx 3. 添加成功之后，执行以下命令，安装Nginx。 sudo yum install y nginx 4. 执行以下命令安装stream模块。 yum install nginxmodstream skipbroken 5. 启动Nginx并设置为开机自动运行。 sudo systemctl start nginx.service sudo systemctl enable nginx.service 6. 在本地浏览器中输入服务器地址（ECS公网IP地址），查看安装是否成功。 如果出现下面页面，则表示安装成功。 步骤 2 在源端Redis添加源端转发服务器的白名单。 步骤 3 在源端转发服务器配置安全组。 1. 获取ECS的公网IP地址。 2. 配置源端转发服务器安全组入方向，添加ECS的公网IP地址，并放开来自ECS访问请求的端口（以6379为例）。 步骤 4 配置源端转发服务器的Nginx转发配置。 1. 登录Linux源端转发服务器，执行命令打开并修改配置文件。 cd /etc/nginx vi nginx.conf 2. 转发配置示例如下： stream { server { listen 6379; proxypass {sourceinstanceaddress}:{port}; } } 其中，6379为源端转发服务器本机监听端口，{sourceinstanceaddress}和{port}为源端Redis实例的连接地址和端口。 配置目的：通过访问源端转发服务器本机监听端口6379，访问源端Redis。 注意：以上配置必须配置在如下图所示的位置。 配置位置要求 3. 重启Nginx服务。 service nginx restart 4. 验证启动是否成功。 netstat angrep 6379 端口在监听状态，Nginx启动成功。 验证结果 步骤 5 配置ECS的Nginx转发配置。 1. 登录LinuxECS，执行命令打开并修改配置文件。 cd /etc/nginx vi nginx.conf 2. 配置示例如下： stream { server { listen 6666; proxypass {sourceecsaddress}:6379; } } 其中，6666为ECS本机监听端口，{sourceecsaddress}为源端转发服务器公网IP地址，6379为源端转发服务器Nginx的监听端口。 配置目的：通过访问ECS本机监听端口6666，访问源端转发服务器。 注意：以上配置必须配置在如下图所示的位置。 配置位置要求 3. 重启Nginx服务。 service nginx restart 4. 验证启动是否成功。 netstat angrep 6666 端口在监听状态，Nginx启动成功。 验证结果 步骤 6 在ECS执行以下命令测试6666端口的网络连接。 rediscli h {targetecsaddress} p 6666 a {password} 其中，{targetecsaddress}为ECS公网IP地址，6666为ECS监听端口，{password}为源端Redis密码，如无密码可不填。 连接示例 步骤 7 准备迁移工具Redisshake。 1. 登录ECS。 2. 在ECS中执行以下命令下载Redisshake，本文以下载2.0.3版本为例进行说明。您可以根据实际需要下载其他RedisShake版本。 wget 3. 执行命令解压Redisshake文件。 tar xvf redisshakev2.0.3.tar.gz 步骤 7 配置Redisshake的配置文件。 1. 执行命令进入解压后的目录。 cd redisshakev2.0.3 2. 修改配置文件redisshake.conf。 vim redisshake.conf 修改源端Redis信息配置： − source.type 源端redis实例类型，单机、主备、proxy集群实例都选择standalone，cluster实例选择cluster。 − source.address ECS公网IP地址和映射源端转发服务器的端口(ECS监听端口 6666) ，用英文冒号隔开。 − source.passwordraw 源端待迁移Redis实例的密码，如未设置密码，无需填写。 修改目标端DCS信息配置： − target.type Redis实例类型，单机、主备、proxy集群实例都选择standalone，cluster实例选择cluster。 − target.address Redis实例的连接地址和端口，用英文冒号隔开。 − target.passwordraw Redis实例的密码，如未设置密码，无需填写。 3. 按下Esc键退出编辑模式，输入 :wq！ 按回车键保存配置并退出编辑界面。 步骤 9 执行命令启动Redisshake并使用rump（在线全量）模式开始数据迁移。 ./redisshake.linux conf redisshake.conf type rump 迁移过程 迁移结果 步骤 10 迁移完成后，请使用rediscli工具连接源Redis和目标Redis，确认数据的完整性。 1. 分别连接源Redis和目标Redis。 连接操作请参考使用rediscli连接Redis实例。 2. 输入 info keyspace ，查看keys参数和expires参数的值。 3. 对比源Redis和目标Redis的keys参数分别减去expires参数的差值。如果差值一致，表示数据完整，迁移正常。 步骤 11 删除Redisshake配置文件。

本节主要介绍使用在线迁移Redis实例 在满足DCS源Redis和目标Redis的网络相通、源Redis放通SYNC和PSYNC命令这两个前提下，支持使用在线迁移的方式，将DCS源Redis中的数据全量或增量迁移到目标Redis中。 约束与限制 在线迁移不支持公网方式直接迁移。 将高版本Redis实例数据迁移到低版本Redis实例可能失败。 较早建立的实例如果密码中包含单引号（'），则该实例不支持进行在线迁移，建议修改实例密码或使用其他迁移方式。 如果是单机/主备等多DB的源实例迁移到Proxy集群实例，Proxy集群默认仅有一个DB0，请先确保源实例DB0以外的DB是否有数据，如果有，请先参考开启多DB操作开启Proxy集群多DB。 如果是单机/主备等多DB的源端实例迁移到Cluster集群实例，Cluster集群不支持多DB，仅有一个DB0，请先确保源端实例DB0以外的DB是否有数据，如果有，请将数据转存到DB0，否则会出现迁移失败，将数据转存到DB0的操作请参考使用Rump在线迁移。 进行在线迁移时，建议将源端实例的参数repltimeout配置为300秒，clientoutputbufferslavehardlimit和clientoutputbufferslavesoftlimit配置为实例最大内存的20%。 在线迁移，相当于临时给源端Redis增加一个从节点并且做一次全量同步到迁移机，建议在业务低峰期执行迁移，否则可能导致源端实例CPU瞬时冲高，时延增大。

本节主要介绍DCS实例迁移下云 场景介绍 您可以通过DCS控制台的在线迁移功能，将DCS实例迁移到自建Redis。另外，您也可以通过导出RDB文件，然后导入本地Redis实例或者自建Redis中。 推荐方案 DCS控制台在线迁移功能 在线迁移操作，操作可以参考使用在线迁移，选择目标Redis的数据源时，选择“自建Redis”，填写目标Redis地址。 使用Rediscli导出DCS实例RDB文件或者控制台导出实例数据文件，然后使用Redisshake导入。 关于Redisshake的安装和使用，请参考使用RedisShake工具迁移自建Redis Cluster集群及Redisshake配置说明。 Rump 支持在线迁移，网络条件允许的情况下，可以考虑使用此方式。指导说明请参考使用Rump在线迁移。

工具/命令/服务 特点 说明 DCS控制台界面一键式迁移 操作简单，同时支持在线迁移和离线迁移（备份文件导入）两种方式，其中在线迁移支持增量数据迁移。 离线迁移，适用于源Redis和目标Redis网络不连通、源Redis不支持SYNC/PSYNC命令的场景。需要将数据备份文件导入到OBS，DCS从OBS桶中读取数据，将数据迁移到DCS的Redis中。 在线迁移，涉及到SYNC/PSYNC命令，适用于源Redis放通了SYNC/PSYNC命令的场景。支持将源Redis中的数据全量迁移或增量迁移到目标Redis中。 Rediscli Redis自带命令行工具，支持导出RDB文件，也支持将持久化的AOF文件整库导入。 AOF文件为所有数据更改命令的全量集合，数据文件稍大。 Rump 支持在线迁移，支持在同一个实例的不同数据库之间，以及不同实例的数据库之间迁移。 不支持增量迁移。建议停业务后迁移，避免出现Key丢失。详情参考 RedisShake 在线迁移和离线迁移均支持的一款开源工具。 适用于Cluster集群的数据迁移。 自行开发迁移脚本 灵活，根据实际情况适配。