// 免費工具

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 的說明: 適用於 Redis 的 SQLly.

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 會在背景持續重試,而不是在連線時就擲出例外。
connectTimeout - 5000 毫秒。
syncTimeout - 5000 同步操作的毫秒數。
asyncTimeout - syncTimeout 非同步操作的毫秒數。
connectRetry - 3 連線嘗試次數。
defaultDatabase - - 資料庫索引。
name - - 客戶端名稱(CLIENT SETNAME)。
allowAdmin - 假 允許 FLUSHALL、CONFIG 及其他管理命令。
keepAlive - -1(60 秒) 保持連線心跳之間的秒數。
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。