Redis

在连接器的 访问内容 → 添加访问 中，在 原生资源 里选择 Redis。保存后，ZAI 可以通过 redis-cli 或程序使用这个实例，支持 RESP2 / RESP3、pipeline、事务、阻塞命令和 Pub/Sub，不支持 RESET。

服务地址

目标地址 填写单实例或云 Redis 的固定代理 host，例如 <实例域名>，不要粘贴带密码的连接串。端口 默认为 6379，实际端口以数据库管理员或云服务控制台提供的信息为准。

只支持单实例地址，或云服务商提供、对外隐藏内部节点的代理地址。不支持 Redis Cluster 或 Sentinel 的节点发现，也不会跟随 MOVED / ASK 重定向；遇到重定向错误时，改用服务商提供的代理入口。

内网实例可以沿用连接器指定的网络隧道，或匹配沙箱配置的内网路由。隧道不可用时访问失败。

账号与密码

• 密码（默认用户）：使用实例密码，连接到 Redis 的 default 用户，兼容只用密码认证的实例。
• ACL 用户名与密码：填写专用于此用途的 ACL 用户和密码，适用于 Redis 6 及以上版本。

向数据库管理员申请需要的命令、Key 和 Pub/Sub Channel 权限。只读用途应使用 Redis 侧的只读 ACL；连接器不会自动把高权限账号变成只读账号。避免使用可以读取服务配置或管理其他账号的凭证。

实例的真实密码只由平台使用，不会交给 ZAI。编辑配置时保留原密码；替换凭证 用于更新密码，并会断开已有连接。需要另一个账号时，以该账号另建一份凭证。

官方说明：Redis ACL。

初始逻辑库编号

填写非负整数，默认 0。实例必须支持该编号；不要假定所有服务都有相同数量的逻辑库。

编号用于建立连接时选择初始逻辑库，不是权限隔离。后续 SELECT 是否可用取决于 Redis ACL 和实例能力。需要隔离的应用应使用专用 ACL 或独立实例。

TLS

默认 验证服务器证书，填写的 host 应与证书匹配。仅在实例明确不支持 TLS 且网络条件允许时选择 不使用 TLS；此时到实例的连接不加密，CA 证书字段会隐藏，填过的 CA 也不会提交。

CA 证书

公有受信任 CA 通常可以留空。私有 CA 或云数据库专用 CA，从数据库管理员或服务商处取得，填写 PEM 证书链。证书链只保留 BEGIN CERTIFICATE / END CERTIFICATE 证书块，证书之间只留换行，块外的说明文字会导致保存失败。证书验证失败时，检查 host、证书有效期和 CA。

使用与验证

保存后，请 ZAI 先对这个实例执行 PING，再读取一个已授权的 Key。保存成功只表示配置已保存，不代表连接可用。权限错误应调整 Redis 侧的 ACL；逻辑库编号错误应核对实例配置。其余排查见验证与排错。

ZAI 每次连接的时长有上限，见常用限制。修改配置、替换凭证或撤销凭证都会断开已有连接。连接中断不能证明写入没有执行；结果不明的写操作，请先核对数据，再决定是否重试。