通過redis-cli串連並操作Tair,Redis開源版資料庫 - Tair (Redis® OSS-Compatible)

redis-cli是Redis內建的命令列工具，您可以在ECS執行個體或本地裝置上通過redis-cli串連、管理雲資料庫Tair（相容 Redis）執行個體。本文介紹安裝redis-cli以及串連執行個體的操作步驟和常見的串連報錯。

免費試用

阿里雲免費試用面向合格新使用者，提供一定時間段的免費試用阿里雲產品的權益，更多資訊請參見免費試用。

快速瞭解串連執行個體流程

串連執行個體的流程

操作流程	說明
1. 設定執行個體帳號密碼。	選擇以下任意方式：設定執行個體預設帳號的密碼，具體操作，請參見修改或重設密碼。建立新的帳號密碼，具體操作，請參見建立與管理帳號。
2. 添加白名單。	根據不同裝置確定串連的網路類型，並將對應網路IP地址添加至執行個體白名單中。 ECS（推薦）：推薦使用專用網路。請確保ECS與執行個體屬於同一專用網路，並將ECS的私網IP地址添加至執行個體的白名單中。說明若ECS與執行個體不屬於同一專用網路（例如ECS與執行個體為不同地區），可將ECS的公網IP地址添加至執行個體的白名單中，並通過ECS公網串連執行個體的公網串連地址。本地裝置：可使用公網。將本地裝置的公網IP地址添加至執行個體的白名單中。關於添加白名單的具體操作，請參見設定IP白名單。
3. 擷取執行個體的串連資訊。	使用專用網路串連時：在控制台擷取該執行個體的專用網路串連地址。使用公網串連時：在控制台申請並擷取該執行個體的公網串連地址。說明執行個體預設僅提供專用網路串連地址，通過公網串連時您需要手動申請公網串連地址。具體操作，請參見查看串連地址。
4. 使用redis-cli串連執行個體。	在redis-cli解壓目錄下執行相關命令。串連命令：`redis-cli -h hostname -p port` 串連命令樣本：`redis-cli -h r-bp1zxszhcgatnx****.redis.rds.aliyuncs.com -p 6379` 密碼命令：`AUTH user:password` 密碼命令樣本：`AUTH testaccount:Rp829dlwa` 具體操作，請參見本文串連操作。

準備工作

如果您的裝置未安裝redis-cli，請參考下述安裝說明進行安裝。

redis-cli安裝說明

在ECS執行個體或本地裝置上，安裝Redis會同步安裝redis-cli。通過redis-cli串連時，redis-cli的版本無需與雲資料庫Tair（相容 Redis）執行個體版本相同。

登入待安裝redis-cli的裝置，例如ECS執行個體或本地裝置。
下載、安裝redis-cli。
Windows系統
目前僅支援64位的Windows系統。
1. 下載Redis-x64-3.2.100.zip檔案。
  說明
  本文以redis-3.2版本為例示範操作流程，您也可以安裝其他版本。更多資訊，請參見MicrosoftArchive-Redis。
2. 將Redis-x64-3.2.100.zip解壓至待安裝的目錄。
macOS系統
在Mac上安裝Redis用戶端的一個常用且簡便的方法是通過Homebrew，Homebrew是一個mac OS的包管理器。下面是詳細的步驟：
安裝Homebrew（如果尚未安裝）
1. 開啟終端（Terminal）。
2. 複製並粘貼以下命令到終端，然後按斷行符號鍵。這個命令會下載並運行Homebrew的安裝指令碼。
```
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```
1. 按照工具提示操作，可能需要輸入密碼。
使用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	啟用叢集模式	該模式僅當執行個體為叢集架構，且使用直連地址串連時可用。

串連樣本：

預設地址（適用於通過預設地址串連的情境，例如標準架構執行個體的串連地址或叢集架構執行個體的Proxy 位址）：
```
./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

根據選取帳號類型，填寫帳號、密碼：

預設帳號（通常為default或以執行個體ID命名的帳號）：直接填寫密碼即可。
普通帳號：密碼格式為user:password。例如自訂帳號為testaccount，密碼為Rp829dlwa，密碼需填寫為testaccount:Rp829dlwa。

說明

如果忘記或未設定密碼，您可以重設密碼。具體操作，請參見修改或重設密碼。
如果執行個體已開啟專用網路免密訪問，通過專用網路串連執行個體時無需執行本步驟即可執行命令。

樣本：

AUTH testaccount:Rp829dlwa

顯示OK表示已成功串連執行個體，可執行命令。

如果出現報錯，請參見常見報錯。
關於執行個體支援的命令，請參見命令概覽。

常見報錯

說明

如果執行個體的小版本過低，報錯資訊可能與下表不一致，建議將執行個體升級至最新的小版本。具體操作，請參見升級小版本與代理版本。

報錯資訊	原因及解決方案
`(error) ERR illegal address`	未添加正確的白名單，請參見快速瞭解串連執行個體流程中第2步添加正確的白名單。
`(error) ERR client ip is not in whitelist`	未添加正確的白名單，請參見快速瞭解串連執行個體流程中第2步添加正確的白名單。
`(error) ERR invalid password` `(error) WRONGPASS invalid username-password pair`	密碼錯誤，請使用正確的密碼和密碼格式。根據選取帳號類型的不同，密碼格式有一定區別。預設帳號（通常為`default`或以執行個體ID命名的帳號）：直接填寫密碼即可。普通帳號：密碼格式為`user:password`。例如自訂帳號為`testaccount`，密碼為`Rp829dlwa`，密碼需填寫為`testaccount:Rp829dlwa`。說明如果通過第三方資料庫管理工具（例如RDM等）串連執行個體，請在密碼框中輸入`user:password`進行串連。如果忘記密碼，您可以重設密碼。具體操作，請參見修改或重設密碼。