Tüm Ürünler
Search
Belge Merkezi

Tair (Redis® OSS-Compatible):Bir örneğe redis-cli ile bağlanma

Son Güncelleme:Oct 03, 2026

redis-cli, Redis ile birlikte gelen komut satırı aracıdır. Bu aracı, bir Elastic Compute Service (ECS) örneğinden veya yerel bir cihazdan ApsaraDB for Redis ve Tair örneklerine bağlanmak ve bu örnekleri yönetmek için kullanın.

Önkoşullar

Başlamadan önce aşağıdakileri yaptığınızdan emin olun:

Hangi uç nokta ve IP adresinin kullanılacağı:

Cihaz Ağ İzin listesine eklenecek IP Kullanılacak uç nokta
Örnek ile aynı sanal özel cloud (VPC) içindeki ECS örneği VPC (önerilir) ECS örneğinin özel IP adresi VPC uç noktası
Farklı bir VPC'deki (örneğin farklı bir bölgedeki) ECS örneği İnternet ECS örneğinin genel IP adresi Genel uç nokta
Yerel cihaz İnternet Cihazın genel IP adresi Genel uç nokta
Varsayılan olarak örneklerin yalnızca bir VPC uç noktası vardır. İnternet üzerinden bağlanmak için öncelikle genel uç nokta başvurusu yapın.

redis-cli yükleme

redis-cli, Redis paketinin bir parçası olarak yüklenir. redis-cli sürümünün örnek sürümünüzle eşleşmesi gerekmez.

redis-cli kurulum talimatları

  1. redis-cli yüklemek istediğiniz cihaza (örneğin bir ECS örneğine veya yerel bir cihaza) giriş yapın.

  2. redis-cli indirin ve yükleyin.

    Linux

    RHEL/CentOS/Alibaba Cloud Linux (yum tabanlı):

    # Install GCC dependencies
    sudo yum -y install gcc
    
    # Download and extract the Redis source (uses Redis 7.2.0 as an example)
    wget https://download.redis.io/releases/redis-7.2.0.tar.gz
    tar xzf redis-7.2.0.tar.gz
    
    # Compile (takes 2-3 minutes)
    cd redis-7.2.0 && make
    Farklı bir sürüm yüklemek için Redis indirme sayfasına bakın.

    Derleme işleminden sonra redis-cli şu konumda bulunur: redis-7.2.0/src/redis-cli.

    macOS

    redis-cli içeren Redis'i yüklemek için Homebrew kullanın.

    Homebrew yükleme (henüz yüklü değilse):

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

    Ekrandaki talimatları izleyin. Parolanızı girmeniz gerekebilir.

    Redis yükleme:

    brew install redis

    Yüklemeden sonra redis-cli konumunu bulmak için which redis-cli komutunu çalıştırın.

    Windows

    Yalnızca 64 bit Windows desteklenir.

    1. Redis-x64-3.2.100.zip dosyasını indirin.

      Bu örnekte Redis 3.2 kullanılmaktadır. Diğer sürümler için MicrosoftArchive-Redis sayfasına bakın.
    2. Zip dosyasını hedef kurulum dizininize çıkarın.

Bir örneğe bağlanma

  1. redis-cli kurulu olduğu dizine gidin.

    Linux

    Redis kaynak klasöründeki src dizinine gidin. Örneğin, cd /home/redis-7.2.0/src komutunu çalıştırın.

    macOS

    Homebrew bin dizinine gidin. Örneğin, cd /opt/homebrew/bin komutunu çalıştırın.

    Windows

    Komut satırı penceresini açın ve redis-cli konumuna gidin.

  2. Bağlantı komutunuzu seçin

    Komutu çalıştırmadan önce iki şeyi doğrulayın:

    • Örnek mimariniz — standart veya küme. Konsoldaki örnek ayrıntıları sayfasını kontrol edin.

    • Bağlantı türünüz — VPC uç noktası veya genel uç nokta. Hangi ana bilgisayar adının kullanılacağını belirler.

    Kurulumunuzla eşleşen komutu seçin:

    Senaryo Komut
    Standart mimari veya proxy uç noktası üzerinden küme mimarisi ./redis-cli -h <hostname> -p <port>
    Doğrudan bağlantı adresi üzerinden küme mimarisi ./redis-cli -h <hostname> -p <port> -c
    Windows PowerShell'de ./redis-cli ifadesini .\redis-cli ile değiştirin.

    Parametreler:

    Parametre Açıklama Nasıl alınır
    <hostname> Örnek uç noktası Konsoldan VPC uç noktasını veya genel uç noktasını alın. Bkz. Uç noktaları görüntüleme.
    <port> Örnek bağlantı noktası Varsayılan değer 6379 şeklindedir. Özel bir bağlantı noktası için bkz. Uç noktasını veya bağlantı noktasını değiştirme.
    -c Küme modunu etkinleştir Yalnızca küme mimarisine sahip örneklerde ve doğrudan bağlantı adresi kullanılırken gereklidir.

    Örnek:

    ./redis-cli -h r-bp1zxszhcgatnx****.redis.rds.aliyuncs.com -p 6379
  3. Kimlik doğrulaması yapın

    Bağlandıktan sonra AUTH komutunu çalıştırın:

    AUTH <password>

    Parola formatı hesap türünüze bağlıdır:

    Hesap türü Parola formatı Örnek
    Varsayılan hesap (adı default veya örnek kimliği) Yalnızca parola AUTH Rp829dlwa
    Standart hesap user:password AUTH testaccount:Rp829dlwa
    VPC üzerinden parolasız erişim etkinleştirilmişse kimlik doğrulama adımını atlayın ve komutları doğrudan çalıştırın.
  4. Bağlantıyı doğrulayın

    AUTH komutundan OK yanıtı almanız bağlantının başarılı olduğunu gösterir. Okuma ve yazma erişimini doğrulamak için hızlı bir test çalıştırın:

    set testkey "hello"    # Write a test value
    OK
    get testkey            # Read it back
    "hello"
    set tempkey "bye" EX 5 # Write with a 5-second expiration
    get tempkey
    "bye"
                           # Wait 5 seconds
    get tempkey
    (nil)                  # Key has expired

    Desteklenen komutların listesi için bkz. Komutlara genel bakış.

Sorun giderme

Örneğinizin küçük sürümü güncel değilse hata mesajları aşağıdakilerden farklı olabilir. En son hata mesajlarını almak için küçük sürümü güncelleyin.
Hata Neden ve çözüm
(error) ERR illegal address Bağlanan IP adresi izin listesinde yok. Önkoşullarda açıklandığı gibi adresi ekleyin.
(error) ERR client ip is not in whitelist
(error) ERR invalid password Parola veya format yanlış. Standart bir hesap için user:password formatını kullanın. Parolanızı unuttuysanız parolayı sıfırlayın.
(error) WRONGPASS invalid username-password pair Yukarıdakiyle aynı.
RDM gibi üçüncü taraf araçlar kullanırken parola alanına user:password formatında parola girin.

İlgili konular