redis-cli是Redis自帶的命令行工具,您可以在ECS實例或本地設備上通過redis-cli連接、管理云數據庫Tair(兼容 Redis)實例。本文介紹安裝redis-cli以及連接實例的操作步驟和常見的連接報錯。
免費試用
阿里云免費試用面向符合條件的新用戶,提供一定時間段的免費試用阿里云產品的權益,更多信息請參見免費試用。
快速了解連接實例流程
操作流程 | 說明 |
1. 設置實例賬號密碼。 | 選擇以下任意方式: |
2. 添加白名單。 | 根據不同設備確定連接的網絡類型,并將對應網絡IP地址添加至實例白名單中。
關于添加白名單的具體操作,請參見設置IP白名單。 |
3. 獲取實例的連接信息。 |
具體操作,請參見查看連接地址。 |
4. 使用redis-cli連接實例。 | 在redis-cli解壓目錄下執行相關命令。
具體操作,請參見本文連接操作。 |
準備工作
如果您的設備未安裝redis-cli,請參考下述安裝說明進行安裝。
在ECS實例或本地設備上,安裝Redis會同步安裝redis-cli。通過redis-cli連接時,redis-cli的版本無需與云數據庫Tair(兼容 Redis)實例版本相同。
登錄待安裝redis-cli的設備,例如ECS實例或本地設備。
下載、安裝redis-cli。
Windows系統
目前僅支持64位的Windows系統。
- 說明
本文以redis-3.2版本為例演示操作流程,您也可以安裝其他版本。更多信息,請參見MicrosoftArchive-Redis。
將Redis-x64-3.2.100.zip解壓至待安裝的目錄。
macOS系統
在Mac上安裝Redis客戶端的一個常用且簡便的方法是通過Homebrew,Homebrew是一個mac OS的包管理器。下面是詳細的步驟:
安裝Homebrew(如果尚未安裝)
打開終端(Terminal)。
復制并粘貼以下命令到終端,然后按回車鍵。這個命令會下載并運行Homebrew的安裝腳本。
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
按照屏幕提示操作,可能需要輸入密碼。
使用Homebrew安裝Redis
在終端中,輸入以下命令來安裝Redis服務器:
brew install redis
這個命令會下載Redis的最新穩定版本并安裝到你的系統中。安裝成功后可在終端輸入命令
which redis-cli
獲取redis-cli的位置。Linux系統
執行下述命令,安裝gcc依賴環境。
sudo yum -y install gcc
執行下述命令下載Redis源碼文件。
wget https://download.redis.io/releases/redis-7.0.0.tar.gz
說明本文以redis-7.0.0版本為例演示操作流程,您也可以安裝其他版本。具體操作,請參見Redis官網。
執行下述命令解壓Redis源碼文件。
tar xzf redis-7.0.0.tar.gz
執行下述命令進入解壓后的目錄并編譯安裝Redis源碼文件:
cd redis-7.0.0&&make
說明編譯安裝需要一段時間(通常為2分鐘~3分鐘)。
連接操作
進入redis-cli安裝目錄下。
Windows系統
打開命令行窗口,進入redis-cli所屬的目錄。
macOS系統
進入../redis-cli所屬的目錄,例如
cd /opt/homebrew/bin
。Linux系統
進入..\redis-7.0.0\src所屬的目錄,例如
cd /home/redis-7.0.0/src
。執行下述命令通過redis-cli連接實例:
./redis-cli -h hostname -p port [-c]
說明在Windows中使用PowerShell啟動redis-cli的命令為
.\redis-cli -h hostname -p port [-c]
。表 1. 參數說明
參數
說明
獲取方式
hostname
實例的連接地址
通過專有網絡連接:需獲取實例的專有網絡連接地址。
通過公網連接:需獲取實例的公網連接地址。
具體操作,請參見查看連接地址。
port
實例的端口號
端口號默認為6379,您也可以自定義端口號。具體操作,請參見修改連接地址或端口。
-c
啟用集群模式
連接示例:
默認地址(適用于通過默認地址連接的場景,例如標準架構實例的連接地址或集群架構實例的代理地址):
./redis-cli -h r-bp1zxszhcgatnx****.redis.rds.aliyuncs.com -p 6379
集群架構直連地址(適用于集群架構通過直連地址連接的場景):
./redis-cli -h r-bp1zxszhcgatnx****.redis.rds.aliyuncs.com -p 6379 -c
執行下述命令完成密碼驗證:
AUTH password
表 2. 參數說明
參數
說明
password
示例:
AUTH testaccount:Rp829dlwa
常見報錯
如果實例的小版本過低,報錯信息可能與下表不一致,建議將實例升級至最新的小版本。具體操作,請參見升級小版本與代理版本。
報錯信息 | 原因及解決方法 |
| 未添加正確的白名單,請參見快速了解連接實例流程中第2步添加正確的白名單。 |
| |
| 密碼錯誤,請使用正確的密碼和密碼格式。根據選取賬號類型的不同,密碼格式有一定區別。
說明
|