All Products
Search

This Product

    Tair (Redis® OSS-Compatible):Gunakan redis-cli untuk menghubungkan ke instans

    Document Center

    Tair (Redis® OSS-Compatible):Gunakan redis-cli untuk menghubungkan ke instans

    Last Updated:Aug 27, 2026

    redis-cli adalah alat baris perintah yang disertakan bersama Redis. Gunakan alat ini untuk menghubungkan dan mengelola instans ApsaraDB for Redis dan Tair dari instance Elastic Compute Service (ECS) atau perangkat on-premises.

    Prasyarat

    Sebelum memulai, pastikan Anda telah:

    Titik akhir dan alamat IP yang harus digunakan:

    Perangkat Jaringan IP yang harus dimasukkan ke daftar putih Titik akhir yang digunakan
    Instance ECS dalam virtual private cloud (VPC) yang sama dengan instans VPC (disarankan) Alamat IP privat instance ECS Titik akhir VPC
    Instance ECS di VPC berbeda (misalnya, wilayah berbeda) Internet Alamat IP publik instance ECS Titik akhir publik
    Perangkat on-premises Internet Alamat IP publik perangkat Titik akhir publik
    Secara default, instans hanya memiliki titik akhir VPC. Untuk menghubungkan melalui Internet, ajukan permohonan titik akhir publik terlebih dahulu.

    Instal redis-cli

    redis-cli diinstal sebagai bagian dari paket Redis. Versi redis-cli tidak perlu sesuai dengan versi instans Anda.

    Instruksi instalasi redis-cli

    1. Masuk ke perangkat tempat Anda ingin menginstal redis-cli, seperti instance ECS atau perangkat on-premises.

    2. Unduh dan instal redis-cli.

      Linux

      RHEL/CentOS/Alibaba Cloud Linux (berbasis yum):

      # Instal dependensi GCC
sudo yum -y install gcc

# Unduh dan ekstrak source Redis (contoh menggunakan Redis 7.2.0)
wget https://download.redis.io/releases/redis-7.2.0.tar.gz
tar xzf redis-7.2.0.tar.gz

# Kompilasi (memerlukan waktu 2–3 menit)
cd redis-7.2.0 && make
      Untuk menginstal versi lain, lihat halaman unduhan Redis.

      Setelah dikompilasi, redis-cli berada di redis-7.2.0/src/redis-cli.

      macOS

      Gunakan Homebrew untuk menginstal Redis, yang mencakup redis-cli.

      Instal Homebrew (jika belum terinstal):

      /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

      Ikuti petunjuk di layar. Anda mungkin perlu memasukkan password.

      Instal Redis:

      brew install redis

      Untuk mengetahui lokasi redis-cli setelah instalasi, jalankan which redis-cli.

      Windows

      Hanya Windows 64-bit yang didukung.

      1. Unduh Redis-x64-3.2.100.zip.

        Contoh ini menggunakan Redis 3.2. Untuk versi lain, lihat MicrosoftArchive-Redis.

      2. Ekstrak file zip ke direktori instalasi target Anda.

    Menghubungkan ke instans

    1. Buka direktori tempat redis-cli diinstal.

      Linux

      Buka direktori src di dalam folder source Redis. Misalnya, jalankan cd /home/redis-7.2.0/src.

      macOS

      Buka direktori bin Homebrew. Misalnya, jalankan cd /opt/homebrew/bin.

      Windows

      Buka jendela command-line dan arahkan ke direktori tempat redis-cli berada.

    2. Pilih perintah koneksi Anda

      Sebelum menjalankan perintah, pastikan dua hal berikut:

      • Arsitektur instans Anda — standar atau kluster. Periksa halaman detail instans di Konsol.

      • Jenis koneksi Anda — titik akhir VPC atau titik akhir publik. Menentukan hostname yang akan digunakan.

      Pilih perintah yang sesuai dengan konfigurasi Anda:

      Skenario Perintah
      Arsitektur standar, atau arsitektur kluster melalui titik akhir proxy ./redis-cli -h <hostname> -p <port>
      Arsitektur kluster melalui alamat koneksi langsung ./redis-cli -h <hostname> -p <port> -c
      Di Windows PowerShell, ganti ./redis-cli dengan .\redis-cli.

      Parameter:

      Parameter Deskripsi Cara mendapatkannya
      <hostname> Titik akhir instans Dapatkan titik akhir VPC atau titik akhir publik dari Konsol. Lihat Melihat titik akhir.
      <port> Port instans Default adalah 6379. Untuk port kustom, lihat Mengubah titik akhir atau port.
      -c Aktifkan Mode kluster Hanya diperlukan untuk instans dengan arsitektur kluster yang menggunakan alamat koneksi langsung.

      Contoh:

      ./redis-cli -h r-bp1zxszhcgatnx****.redis.rds.aliyuncs.com -p 6379

    3. Lakukan otentikasi

      Jalankan perintah AUTH setelah terhubung:

      AUTH <password>

      Format password bergantung pada jenis akun Anda:

      Jenis akun Format password Contoh
      Akun default (bernama default atau ID instans) Hanya password AUTH Rp829dlwa
      Akun standar user:password AUTH testaccount:Rp829dlwa
      Jika akses tanpa password melalui VPC diaktifkan, lewati otentikasi dan jalankan perintah secara langsung.

    4. Verifikasi koneksi

      Tanggapan OK dari perintah AUTH menandakan Anda telah terhubung. Jalankan pengujian singkat untuk memverifikasi akses baca dan tulis:

      set testkey "hello"    # Tulis nilai uji
OK
get testkey            # Baca kembali
"hello"
set tempkey "bye" EX 5 # Tulis dengan masa berlaku 5 detik
get tempkey
"bye"
                       # Tunggu 5 detik
get tempkey
(nil)                  # Kunci telah kedaluwarsa

      Untuk daftar perintah yang didukung, lihat Ikhtisar perintah.

    Pemecahan masalah

    Jika versi minor instans Anda sudah usang, pesan error mungkin berbeda dari contoh di bawah. Perbarui versi minor untuk mendapatkan pesan error terbaru.
    Error Penyebab dan solusi
    (error) ERR illegal address Alamat IP yang menghubungkan tidak ada di daftar putih. Tambahkan sesuai penjelasan pada prasyarat.
    (error) ERR client ip is not in whitelist
    (error) ERR invalid password Password atau format salah. Untuk akun standar, gunakan format user:password. Jika lupa password, reset password tersebut.
    (error) WRONGPASS invalid username-password pair Sama seperti di atas.
    Saat menggunakan tool pihak ketiga seperti RDM, masukkan password dalam format user:password di bidang password.

    Topik terkait