tencent cloud

腾讯云分布式缓存数据库(兼容 Redis)

动态与公告
产品动态
公告
新手指引
产品简介
产品概述
产品优势
应用场景
存储引擎
产品系列
产品版本
规格与性能
读写分离
多可用区部署
地域和可用区
名词解释
购买指南
计费概述
定价中心
购买实例
续费说明(包年包月)
退费说明(包年包月)
欠费说明
按量转包年包月
快速入门
快速创建实例
连接 Redis 实例
操作指南
操作总览
连接数据库实例
管理实例
升级实例
管理节点(Redis/ValKey 版)
管理多可用区
备份与恢复
账号管理
参数配置
慢查询
访问管理
网络与安全
监控与告警
事件管理(Redis/ValKey 版)
数据迁移
Redis 版全球复制
数据库审计
诊断优化
Sentinel 模式
开发准则
命名规则
基本使用准则
Key 与 Value 设计原则
命令使用准则
客户端程序设计准则
连接池配置
命令参考
命令参考概览
Redis 版与 Valkey 版命令兼容性
大版本命令使用差异
Proxy 架构与直连模式的使用差异
命令更多操作(Redis/Valkey 版)
Memcached 版命令兼容性
实践教程
基于 Spring Boot 搭建 Redis 客户端监控
Redis 客户端连接配置策略与实践
集群架构全局 SCAN 使用指南
实例安全下线
热 Key 与 大 key
可用区迁移方案
故障处理
连接异常
Redisson 客户端超时重连异常分析及解决方案
性能排查与调优
API 文档
History
Introduction
API Category
Making API Requests
Instance APIs
Parameter Management APIs
Other APIs
Backup and Restoration APIs
Region APIs
Monitoring and Management APIs
Log APIs
Data Types
Error Codes
常见问题
使用常见问题
连接登录问题
购买相关问题
相关协议
服务等级协议
Terms of Service
词汇表
联系我们

连接 Redis 实例

PDF
聚焦模式
字号
最后更新时间: 2026-03-17 16:36:36

操作场景

实例创建完成,状态为运行中,您便可以访问数据库,进行数据库读写、查询等操作。本文介绍以下三种方式连接数据库。
客户端工具连接:使用云服务器 CVM 基于客户端通过自动分配给云数据库的内网地址连接数据库的方法,包括 Linux 云服务器与 Windows 云服务器。这种连接方式使用内网高速网络,延迟低。云服务器和数据库须是同一账号,且同一个 VPC 内(保障同一个地域),或同在基础网络内。
说明:
对于不同的 VPC 下(包括同账号/不同账号,同地域/不同地域)的云服务器和数据库,内网连接方式请参见 云联网
轻量应用服务器和云数据库内网默认不互通,若需内网连接,请参见 轻量应用服务器申请关联云联网
不同 VPC 下的云服务器和数据库,也可通过外网地址连接,外网地址连接方式请参见 配置外网地址
DMC 连接:通过腾讯云的一款数据库管理工具 DMC(Database Management Center)登录数据库,可便捷地访问实例、查看实例的关键指标信息、运行 Redis 命令等。
多语言 SDK 连接:即通过多语言 SDK 配置腾讯云自动分配给云数据库的内网 IP 地址、端口、实例 ID 和密码连接数据库实例,并进行数据库操作,设置 key、获取 key 等。

准备工作

准备腾讯云分布式缓存数据库实例,请参见 创建实例
准备数据库账号及密码,请参见 管理账号,您可以使用默认账号或自定义账号。
配置云服务器 CVM 和分布式缓存数据库的安全组出入站规则,请参见 管理云数据库安全组
已在 腾讯云分布式缓存数据库控制台实例详情页面的网络信息区域获取连接数据库内网IPv4地址

通过客户端工具连接

说明:
当前 Redis 6.2 版本不支持 RESP3 协议。

Linux 云服务器连接

步骤1:准备环境

1. 登录到 Linux 云服务器,请参见 快速配置 Linux 云服务器
2. 以 CentOS 系统的云服务器为例,执行如下命令安装 Redis 协议客户端:
yum install redis -y
提示 Complete! 说明客户端安装完成。

步骤2:连接实例

免密码认证实例 如果您的实例为免密码认证,则连接命令如下:
redis-cli -h IP地址 -p 端口
其中,IP 地址和端口指在 腾讯云分布式缓存数据库控制台实例详情页面的网络信息区域获取的内网IPv4地址端口

默认账号访问
默认账号指系统默认分配的账号。您购买并创建腾讯云分布式缓存数据库实例时,设置的访问实例的密码即为默认账号对应的数据库密码。如果需通过默认账号访问数据库,仅需配置访问密码,则支持开源格式类型的连接方式如下所示。
redis-cli -h IP地址 -p 端口 -a 密码
其中,IP 地址和端口指在 腾讯云分布式缓存数据库控制台实例详情页面的网络信息区域获取的内网IPv4地址端口。例如您设置的密码是 abcd1234,则连接命令如下:
redis-cli -h IP地址 -p 端口 -a abcd1234
说明:
2018年1月之前购买的实例,需将“密码”替换为“实例 ID:密码”的格式才能访问。连接示例如下所示。redis-cli -h IP地址 -p 端口 -a crs-bkuza6i3:abcd1234
自定义账号访问 若连接时使用的是 自定义账号。自定义账号的鉴权方式为账号名@密码,作为访问 Redis 的密码参数。
redis-cli -h IP地址 -p 端口 -a 账号名@密码

Windows 服务器连接

1. 配置并登录 Windows 云服务器,请参见 快速配置 Windows 云服务器
2. 在 Windows 云服务器,通过 Internet 下载 Redis 客户端并进行安装。
3. 打开 Redis 客户端,配置实例内网 IP 地址,单击测试连接,连接数据库实例。
参数名称
参数解释
名字
连接数据库实例的连接名称。
地址
请输入数据库实例的内网 IPv4 地址,请在控制台实例详情页面的网络信息区域获取。
验证
输入数据库实例的连接密码。

4. 单击

, 在右下方输入框执行 Redis 命令。

DMC 连接

说明:
Memcached 版实例暂不支持 DMC 连接。
2. 在实例列表页面上方,选择地域
3. 在实例列表中,找到目标实例。
4. 在其操作列,单击登录
5. 跳转至云数据库管理工具 DMC 控制台 登录页面,在密码的输入框输入目标实例默认账户的密码,或者使用自定义账号,在密码的输入框输入自定义账号@自定义账号的密码,单击登录

6. 数据库管理页面的实例信息页签,可查看实例的监控信息。

7. 单击命令行页签,在下方的输入框输入并执行 Redis 命令,使用示例如下图所示。

8. 如果您对 Redis 的命令参数不是很熟悉,可以在页面左侧的对象列表区域,选择键值存放的 Slot 区间以及 DB,单击新建,并选择键的数据类型,单击确定,在键名输入框编辑键名称,单击新建元素并创建key,在新建元素对话框,输入键对应的键值,单击确定。系统将根据设置的键与键值的信息运行命令。


多语言 SDK 连接

腾讯云分布式缓存数据库支持多语言 SDK 访问,包括:PHP、Java、Node.js、Python、C、Go、.Net 等。具体示例,请参见 多语言 SDK 连接。请根据示例,下载多语言 SDK 对应客户端,并参考代码配置实例的内网 IP、端口号、实例 ID 和密码,即可连接数据库。

常见问题

如果连接失败,请参见 无法连接实例 逐一排查。
更多常见的问题,请参见 连接登录问题

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈