全部产品
Search

搜索本产品

    Tair (Redis® OSS-Compatible)：Gunakan redis-cli untuk terhubung ke suatu instance

    文档中心

    Tair (Redis® OSS-Compatible)：Gunakan redis-cli untuk terhubung ke suatu instance

    更新时间：Nov 10, 2025

    redis-cli adalah alat baris perintah yang disertakan dengan Redis. Anda dapat menggunakan redis-cli untuk terhubung dan mengelola instance Tair dan Redis dari Instance ECS atau perangkat lokal. Topik ini menjelaskan cara menginstal redis-cli, terhubung ke instance, serta menyelesaikan kesalahan koneksi umum.

    Uji coba gratis

    Alibaba Cloud menawarkan uji coba gratis yang memungkinkan pengguna baru yang memenuhi syarat untuk mencoba produk Alibaba Cloud dalam jangka waktu terbatas. Untuk informasi lebih lanjut, lihat Uji Coba Gratis.

    Alur kerja koneksi

    Prosedur

    Deskripsi

    1. Atur kata sandi untuk akun instance.

    Anda dapat memilih salah satu metode berikut:

    2. Tambahkan alamat IP ke daftar putih.

    Hanya alamat IP dalam daftar putih yang dapat terhubung ke instance. Anda harus menentukan jenis jaringan berdasarkan perangkat Anda dan menambahkan alamat IP yang sesuai ke daftar putih instance.

    • ECS (direkomendasikan): Gunakan virtual private cloud (VPC).

      Pastikan bahwa instance ECS dan instance Anda berada di VPC yang sama. Kemudian, tambahkan alamat IP pribadi instance ECS ke daftar putih instance.

      Catatan

      Jika instance ECS dan instance Anda berada di VPC yang berbeda, seperti di wilayah yang berbeda, Anda harus menambahkan alamat IP publik instance ECS ke daftar putih. Anda kemudian dapat terhubung dari instance ECS ke titik akhir publik instance Anda.

    • Perangkat lokal: Gunakan internet.

      Tambahkan alamat IP publik perangkat lokal ke daftar putih instance.

    Untuk informasi lebih lanjut tentang cara menambahkan alamat IP ke daftar putih, lihat Setel Daftar Putih IP.

    3. Dapatkan informasi koneksi instance.

    • Saat terhubung melalui VPC: Dapatkan Proprietary Network titik akhir instance di Konsol.

    • Saat terhubung melalui internet: Ajukan permohonan dan dapatkan titik akhir publik untuk instance di Konsol.

      Catatan

      Secara default, instance hanya memiliki Proprietary Network titik akhir. Untuk terhubung melalui internet, Anda harus mengajukan permohonan untuk titik akhir publik.

    Untuk informasi lebih lanjut, lihat Lihat Endpoint.

    4. Gunakan redis-cli untuk terhubung ke instance.

    Di direktori tempat Anda membongkar redis-cli, jalankan perintah yang relevan.

    • Perintah koneksi: redis-cli -h hostname -p port

      Contoh perintah koneksi: redis-cli -h r-bp1zxszhcgatnx****.redis.rds.aliyuncs.com -p 6379

    • Perintah kata sandi: AUTH user:password

      Contoh perintah kata sandi: AUTH testaccount:Rp829dlwa

    Untuk informasi lebih lanjut, lihat Terhubung ke Instance Redis atau Tair dalam topik ini.

    Instal redis-cli

    Jika redis-cli belum diinstal pada perangkat Anda, Anda dapat mengikuti petunjuk ini untuk menginstalnya.

    Petunjuk Instalasi redis-cli

    Saat Anda menginstal Redis pada instance ECS atau perangkat lokal, redis-cli juga akan diinstal. Versi redis-cli tidak perlu cocok dengan versi instance Tair (Kompatibel dengan Redis OSS) Anda.

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

    2. Unduh dan instal redis-cli.

      Linux

      Jalankan perintah berikut untuk menginstal dependensi GCC.

      sudo yum -y install gcc

      Jalankan perintah berikut untuk mengunduh file sumber Redis.

      wget https://download.redis.io/releases/redis-7.2.0.tar.gz
      Catatan

      Topik ini menggunakan Redis 7.2.0 sebagai contoh. Anda juga dapat menginstal versi lain. Untuk informasi lebih lanjut, lihat Situs Resmi Redis.

      Jalankan perintah berikut untuk membongkar file sumber Redis.

      tar xzf redis-7.2.0.tar.gz

      Jalankan perintah berikut untuk masuk ke direktori yang telah dibongkar. Lalu, kompilasi dan instal file sumber Redis:

      cd redis-7.2.0&&make
      Catatan

      Kompilasi dan instalasi memerlukan waktu, biasanya 2 hingga 3 menit.

      macOS

      Di macOS, Anda dapat menggunakan manajer paket Homebrew untuk menginstal klien Redis.

      Instal Homebrew (jika belum diinstal)

      1. Buka Terminal.

      2. Salin dan tempel perintah berikut ke Terminal, lalu tekan Enter. Perintah ini mengunduh dan menjalankan skrip instalasi Homebrew.

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

      1. Ikuti instruksi di layar. Anda mungkin perlu memasukkan kata sandi Anda.

      Gunakan Homebrew untuk menginstal Redis

      Di Terminal, jalankan perintah berikut untuk menginstal toolset Redis, yang mencakup redis-cli:

      brew install redis

      Perintah ini mengunduh dan menginstal versi stabil terbaru Redis di sistem Anda. Setelah instalasi selesai, Anda dapat menjalankan perintah which redis-cli di Terminal untuk menemukan lokasi redis-cli.

      Windows

      Hanya sistem Windows 64-bit yang didukung.

      1. Unduh file Redis-x64-3.2.100.zip.

        Catatan

        Topik ini menggunakan Redis 3.2 sebagai contoh. Anda juga dapat menginstal versi lain. Untuk informasi lebih lanjut, lihat MicrosoftArchive-Redis.

      2. Bongkar file Redis-x64-3.2.100.zip ke direktori instalasi target Anda.

    Terhubung ke instance Redis atau Tair

    1. Pergi ke direktori tempat redis-cli diinstal.

      Linux

      Pergi ke direktori ..\redis-7.2.0\src. Sebagai contoh, jalankan cd /home/redis-7.2.0/src.

      macOS

      Pergi ke direktori ../redis-cli. Sebagai contoh, jalankan cd /opt/homebrew/bin.

      Windows

      Buka jendela baris perintah dan pergi ke direktori tempat redis-cli berada.

    2. Jalankan perintah berikut untuk terhubung ke instance menggunakan redis-cli:

      ./redis-cli -h <hostname> -p <port> [-c]
      Catatan

      Untuk memulai redis-cli di Windows PowerShell, Anda dapat menjalankan perintah .\redis-cli -h hostname -p port [-c].

      Tabel 1. Parameter

      Parameter

      Deskripsi

      Cara mendapatkan

      hostname

      Endpoint instance.

      • Saat terhubung melalui VPC: Dapatkan titik akhir VPC instans.

      • Saat terhubung melalui internet: Dapatkan titik akhir publik instans.

      Untuk informasi lebih lanjut, lihat Lihat endpoint.

      port

      Nomor port instance.

      Nomor port default adalah 6379. Anda juga dapat menyesuaikan nomor port. Untuk informasi lebih lanjut, lihat Ubah titik akhir atau port.

      -c

      Aktifkan mode kluster.

      Mode ini hanya tersedia untuk instans arsitektur kluster saat Anda terhubung menggunakan alamat koneksi langsung.

      Contoh koneksi:

      • Titik akhir default (untuk titik akhir instance arsitektur standar atau titik akhir proxy instance arsitektur kluster):

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

      • Titik akhir koneksi langsung untuk instance arsitektur kluster:

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

    3. Jalankan perintah berikut untuk menyelesaikan autentikasi kata sandi:

      AUTH <password>

      Tabel 2. Parameter

      Parameter

      Deskripsi

      password

      Masukkan akun dan kata sandi berdasarkan tipe akun:

      • Akun default (biasanya bernama default atau dengan ID instans): Masukkan hanya kata sandi.

      • Akun standar: Format kata sandi adalah user:kata sandi. Sebagai contoh, jika akun kustom adalah testaccount dan kata sandinya adalah Rp829dlwa, Anda harus memasukkan kata sandi sebagai testaccount:Rp829dlwa.

      Catatan

      • Jika Anda lupa kata sandi atau belum menyetelnya, atur ulang. Untuk informasi lebih lanjut, lihat Ubah atau atur ulang kata sandi.

      • Jika akses tanpa kata sandi melalui VPC diaktifkan untuk instans, autentikasi kata sandi tidak diperlukan saat Anda terhubung ke instans melalui VPC. Anda dapat menjalankan perintah secara langsung.

      Contoh:

      AUTH testaccount:Rp829dlwa

      Tanggapan OK menunjukkan bahwa koneksi berhasil dan Anda dapat menjalankan perintah.

    Kesalahan umum

    Catatan

    Jika versi minor instance Anda sudah usang, pesan kesalahan yang dikembalikan mungkin berbeda dari yang ada di tabel berikut. Anda dapat meningkatkan instance ke versi minor terbaru. Untuk informasi lebih lanjut, lihat Perbarui Versi Minor dan Versi Proxy.

    Pesan Kesalahan

    Penyebab dan Solusi

    (error) ERR illegal address

    Alamat IP yang benar tidak ditambahkan ke daftar putih. Anda dapat menambahkan alamat IP yang benar ke daftar putih seperti yang dijelaskan di Langkah 2 bagian Alur Kerja Koneksi.

    (error) ERR client ip is not in whitelist

    • (error) ERR invalid password

    • (error) WRONGPASS invalid username-password pair

    Kata sandi salah. Gunakan kata sandi dan format yang benar. Format kata sandi bervariasi berdasarkan tipe akun.

    • Akun default (biasanya bernama default atau dengan ID instance): Masukkan hanya kata sandi.

    • Akun standar: Format kata sandi adalah user:kata sandi. Sebagai contoh, jika akun kustom adalah testaccount dan kata sandinya adalah Rp829dlwa, Anda harus memasukkan kata sandi sebagai testaccount:Rp829dlwa.

    Catatan

    • Jika Anda menggunakan alat manajemen database pihak ketiga, seperti RDM, untuk terhubung ke instance, Anda harus memasukkan kata sandi dalam format user:kata sandi di bidang kata sandi.

    • Jika Anda lupa kata sandi, Anda dapat mengatur ulang. Untuk informasi lebih lanjut, lihat Ubah atau Atur Ulang Kata Sandi.