// 免费工具

Redis 连接字符串生成器

在一个表单里构建 Redis 或 Valkey 连接 URI、StackExchange.Redis 配置字符串或 redis-cli 命令;也可以粘贴一个,看看每个选项的作用,以及密码是否会以明文走过网络。 所有操作都在你的浏览器中运行:你输入的内容不会被发送到任何地方。

在 SQLly 中打开此连接

打开 SQLly 的连接编辑器并自动填入内容。

从设计上保护隐私。 构建器和解码器是运行在此标签页中的纯 JavaScript。页面不会把你输入的内容发送给任何服务器,不存储任何内容(甚至不存入浏览器),一旦加载完毕即可离线继续工作。“在 SQLly 中打开”链接会直接从浏览器跳转到你电脑上的应用。

Redis 连接字符串格式

几乎每个 Redis 客户端都接受 URI: redis://[[user]:password@]host[:port][/db],或 rediss:// 用于 TLS。唯一的例外是 .NET 客户端 StackExchange.Redis:它使用逗号分隔的配置字符串,例如 host:6380,password=...,ssl=true.

redis:// 是明文,连 AUTH 密码也一并包含。托管服务(Azure Cache for Redis、带传输中加密的 ElastiCache、Upstash)则要求 rediss://.

带 TLS 的 URI redis-py、node-redis、ioredis、go-redis、Lettuce、Jedis、SQLly

rediss://:[email protected]/0

带有 ACL 用户的 URI(Redis 6+) 相同

rediss://app_user:[email protected]:6380/0

StackExchange.Redis .NET

cache.example.com:6380,password=your_password,ssl=true,abortConnect=false

redis-cli 命令行

redis-cli -h cache.example.com -p 6380 --tls --askpass

占位符,例如 your_password 就是这样:用上面的表单自己拼一个连接字符串即可。更多关于将 SQLly 连接到 Redis 的信息: SQLly 适用于 Redis.

Redis URI 的组成部分

redis 和 rediss 是 IANA 的暂定 URI 方案。用户名和密码中的特殊字符要做百分号编码。只有密码没有用户名时(redis://:pw@host)的登录身份是 default 用户。

关键字同义词默认作用
scheme - redis redis:// 普通 TCP, rediss:// TLS。Valkey 客户端接受相同的写法;有些还接受 valkey://.
user - 默认 ACL 用户名(Redis 6+)。
password - - AUTH 密码。
host:port - localhost:6379 服务器地址。
/db ?db= 0 数据库索引,默认从 0 到 15。

StackExchange.Redis 配置选项

格式: host:port[,host2:port2],option=value,...。选项名不区分大小写。包含逗号的密码无法写进字符串;请改用 ConfigurationOptions.Password 在代码中。

关键字同义词默认作用
password - - AUTH 密码。
user - - ACL 用户名。
ssl - 假的 使用 TLS。搭配 ssl=true 且未指定端口时,默认端口为 6380。
sslHost - - 证书必须匹配的主机名。
abortConnect - true(对于 Azure Cache for Redis 为 false) false 会在后台持续重试,而不是在 Connect 时直接抛出异常。
connectTimeout - 5000 毫秒。
syncTimeout - 5000 等待连接的毫秒数。
asyncTimeout - syncTimeout 异步操作的毫秒数。
connectRetry - 3 连接方式
defaultDatabase - - 数据库索引。
name - - 客户端名称(CLIENT SETNAME)。
allowAdmin - 假的 允许执行 FLUSHALL、CONFIG 及其他管理命令。
keepAlive - -1(60 秒) keepalive ping 之间的秒数。
serviceName - - Sentinel 主节点名称。

redis-cli 连接标志

redis-cli 也接受 -u redis://....

关键字同义词默认作用
-h - 127.0.0.1 主机。
-p - 6379 端口。
--user - - ACL 用户(带密码)。
-a / --pass - - 命令行上的密码;在 shell 历史记录和进程列表中可见。首选 --askpass 或者 REDISCLI_AUTH 环境变量。
-n - 0 数据库索引。
--tls - - 使用 TLS;添加 --cacert 用于私有 CA。

常见的 Redis 连接错误

NOAUTH Authentication required.

原因: 服务器设置了密码(requirepass 或 ACL 用户),而客户端在未认证的情况下发送了命令,通常是因为 URI 中缺少密码。

修复: 添加密码: redis://:password@host:6379,或 redis://user:password@host 对于 ACL 用户。

WRONGPASS invalid username-password pair or user is disabled.

原因: Redis 6+ 拒绝了凭据。常见情形是把密码当成了用户名:一些客户端会读取 redis://secret@host 作为用户 secret 没有密码。

修复: 写入 redis://:secret@host (注意冒号)或者提供用户名和密码。

It was not possible to connect to the redis server(s).

原因: StackExchange.Redis 无法连接:主机或端口错误,需要 TLS,但 ssl=true 缺失(或反过来),或者有防火墙。使用 abortConnect=true (默认)会立即抛出异常。

修复: 检查 ssl 以及端口(TLS 端点通常是 6380),并设置 abortConnect=false 这样多路复用器就会一直重试。

DENIED Redis is running in protected mode because protected mode is enabled

原因: 既没设密码也没显式绑定地址的 Redis 会拒绝来自其他机器的连接。

修复: 设置密码(或 ACL 用户)以及一个 bind 地址,而不是关闭受保护模式。

Redis 连接字符串常见问题解答

什么是 Redis 连接字符串格式?

redis://[[user]:password@]host[:port][/db],或 rediss:// 用于 TLS。例如 rediss://:[email protected]:6380/0。StackExchange.Redis 使用 host:port,password=...,ssl=true 代替。

Redis 的默认端口是多少?

6379。许多托管服务在 6380 上提供 TLS,而 StackExchange.Redis 在 ssl=true 且未指定端口时。

如何在 Redis URI 中写入用户名?

Redis 6 引入了 ACL 用户: redis://user:password@host:6379。只提供密码时,写入 redis://:password@host;服务器会让你以 default 用户。

这些字符串适用于 Valkey 吗?

是的。Valkey 与 Redis 协议兼容,因此相同的 URI、配置字符串和 redis-cli 标志(或 valkey-cli)都可以使用。SQLly 也可以读取 valkey:// 和 valkeys://.

// 完全跳过这些字符串

连接一次。之后只管写 SQL。

SQLly 是适用于 macOS、Windows 和 Linux 的原生 SQL 工作台。在连接编辑器中粘贴连接字符串,把密码保存在系统钥匙串里,并在 Redis 等引擎上获得模式感知的 IntelliSense。