Tüm Ürünler
Search
Belge Merkezi

Elastic Compute Service:Connect to an instance with a temporary key pair with Session Manager CLI

Son Güncelleme:Sep 30, 2026

ali-instance-cli ile 60 saniyelik geçici bir genel anahtar kaydedin ve parola yerine özel anahtarı kullanarak bir ECS örneğine bağlanın.

Geçici genel anahtarlar

Geçici genel anahtarlar, örnekler üzerinde anahtar çiftleri yapılandırmadan SSH üzerinden örneklere bağlanmanızı sağlar. Her bağlantı denemesinde 60 saniye geçerli olan geçici bir genel anahtar kaydedin ve parola yerine ilgili özel anahtarı kullanın.

Not

Geçici genel anahtarlar Cloud Assistant sunucusunda saklanır.

Önkoşullar

Oturum Yöneticisi hizmetini etkinleştirme

Konsolda Alibaba Cloud hesabınız için Oturum Yöneticisi hizmetini etkinleştirin:

  1. ECS konsolu - Örnekler sayfasına gidin.

  2. Üst gezinme çubuğunda, örnek için bölgeyi ve kaynak grubunu seçin.

  3. Instance sayfasında hedef örneği bulun ve Actions sütununda Connect öğesini tıklayın.

  4. Show Other Logon Methods seçeneğini tıklayın. Session Manager bölümünü bulun. Session Management closed yanındaki anahtarı açın. Ardından, hizmeti etkinleştirmek için ekrandaki talimatları izleyin.

    image

    image

Örneğin Çalışır durumda olup olmadığını kontrol etme

Oturum Yöneticisi, örneğin Running durumunda olmasını gerektirir.

Konsol

ECS konsolundaki Instance sayfasında örnek durumunu görüntüleyin.

Bkz. Örnek bilgilerini görüntüleme .

Sol gezinme bölmesinde Instances & Images > Instances yolunu izleyin.

Örnek listesinde, SessionManager-example örneğinin durumunun Running olduğunu doğrulayın.

Alibaba Cloud CLI

Alibaba Cloud CLI yapılandırıldıysa, örnek durumunu sorgulamak için aşağıdaki komutu çalıştırın. Parametre ayrıntıları için bkz. DescribeInstanceStatus.

Bu konuda örnek olarak Çin (Hangzhou) bölgesindeki i-bp1****** kimliğine sahip bir örnek kullanılmıştır.
aliyun ecs DescribeInstanceStatus --region cn-hangzhou --RegionId 'cn-hangzhou' --InstanceId.1 'i-bp1******'

Status değeri Running ise örnek çalışıyor demektir.

{
  "TotalCount": 1,
  "RequestId": "A413****-****-****-****-****611B",
  "PageSize": 1,
  "PageNumber": 1,
  "InstanceStatuses": {
    "InstanceStatus": [
      {
        "Status": "Running",
        "InstanceId": "i-bp1******"
      }
    ]
  }
}

Örnek durumunu sorgulamak için DescribeInstances API'sini de kullanabilirsiniz.

API

Bkz. DescribeInstanceStatus veya DescribeInstances.

**Cloud Assistant Agent** yüklü olup olmadığını kontrol etme

Oturum Yöneticisi Cloud Assistant gerektirir. Cloud Assistant Agent öğesinin örnekte yüklü olup olmadığını kontrol etmek için aşağıdaki yöntemlerden birini kullanın.

1 Aralık 2017 tarihinden sonra resmi genel görüntülerden oluşturulan ECS örneklerinde Cloud Assistant Agent önceden yüklenmiş olarak gelir . Bu tarihten önce oluşturulan veya karşıya yüklenen özel görüntülerden oluşturulan örnekler için Cloud Assistant Agent'ı yükleyin .

Konsol

Oturum Yöneticisi Cloud Assistant'a bağlıdır. Örneğe Cloud Assistant Agent yükleyin ve ECS konsolundaki ECS Cloud Assistant sayfasında durumunu kontrol edin.

Cloud Assistant Agent , 1 Aralık 2017 tarihinden sonra Alibaba Cloud genel görüntülerinden oluşturulan ECS örneklerinde önceden yüklüdür . Daha eski örnekler için Cloud Assistant Agent öğesini manuel olarak yükleyin. Bkz. Cloud Assistant Agent'ı yükleme .

ECS konsolunun sol gezinme bölmesinde, O&M altında Cloud Assistant seçeneğini tıklayın.

Hedef örnek için Cloud Assistant Status sütununun Normal değerini gösterdiğini doğrulayın.

Bkz. Cloud Assistant durumunu kontrol etme ve istisnaları giderme.

Alibaba Cloud CLI

Alibaba Cloud CLI yapılandırıldıysa, Cloud Assistant Agent kurulumunu ve Oturum Yöneticisi desteğini kontrol etmek için aşağıdaki komutu çalıştırın. Parametre ayrıntıları için bkz. DescribeCloudAssistantStatus.

Bu konuda örnek olarak Çin (Hangzhou) bölgesindeki i-bp1****** kimliğine sahip bir örnek kullanılmıştır.
aliyun ecs DescribeCloudAssistantStatus --region cn-hangzhou --RegionId 'cn-hangzhou' --InstanceId.1 'i-bp1******'

CloudAssistantStatus değeri true ve SupportSessionManager değeri true ise örnek Oturum Yöneticisi bağlantılarını destekler.

{
  "TotalCount": 1,
  "PageSize": 1,
  "RequestId": "DB34****-****-****-****-****A749",
  "NextToken": "",
  "PageNumber": 1,
  "InstanceCloudAssistantStatusSet": {
    "InstanceCloudAssistantStatus": [
      {
        "CloudAssistantVersion": "2.2.3.857",
        "SupportSessionManager": true,
        "InstanceId": "i-bp1******",
        "InvocationCount": 4,
        "OSType": "Linux",
        "CloudAssistantStatus": "true",
        "LastHeartbeatTime": "2024-12-10T02:38:04Z",
        "LastInvokedTime": "2024-12-08T16:02:45Z",
        "ActiveTaskCount": 0
      }
    ]
  }
}

API

Bkz. DescribeCloudAssistantStatus.

Oturum Yöneticisi için bir RAM kullanıcısının kimlik bilgilerini hazırlama

ali-instance-cli kullanırken RAM kullanıcısının AccessKey çiftini ve Güvenlik Belirteci Hizmeti (STS) belirtecini belirtmeniz gerekir. Oturum Yöneticisi kullanarak bir örneğe bağlandığınızda sistem, kimlik bilgilerine sahip RAM kullanıcısının ecs:StartTerminalSession iznine sahip olup olmadığını doğrular.

Özel bir ilke yapılandırırken, bir RAM kullanıcısının Oturum Yöneticisi kullanarak bağlanabileceği ECS örneklerini belirtmek için Resource parametresini yapılandırabilirsiniz. Örnek ilke:

{
  "Version": "1",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "ecs:StartTerminalSession",
      "Resource": "*"
    }
  ]
}

CredentialsURI ve STS Belirteci parametreleri hakkında bilgi için bkz. AccessKey çifti oluşturma ve STS'ye genel bakış

Bir RAM kullanıcısına izin verme hakkında bilgi için bkz. RAM kullanıcı izinlerini yönetme.

1. Oturum Yöneticisi CLI'yı yükleme ve yapılandırma

Not

Oturum Yöneticisi CLI'yı zaten yüklediyseniz ve yapılandırdıysanız bu adımı atlayın.

1.1 Yükleme

Oturum Yöneticisi CLI'yı (ali-instance-cli) bilgisayarınıza yükleyin. Yükleme yöntemi işletim sistemine göre değişir.

Windows

Windows için ali-instance-cli öğesini indirmek için tıklayın ve yerel bir klasöre kaydedin.

Bu konuda örnek olarak C:\Users\test klasörü kullanılmıştır.

macOS

macOS terminalinde, macOS için ali-instance-cli öğesini indirin:

curl -O https://aliyun-client-assist.oss-accelerate.aliyuncs.com/session-manager/mac/ali-instance-cli

Çalıştırma izinleri verin:

chmod a+x ali-instance-cli

Linux

Linux için ali-instance-cli yükleyin:

x86 mimarisi

curl -O https://aliyun-client-assist.oss-accelerate.aliyuncs.com/session-manager/linux/ali-instance-cli

arm mimarisi

curl -O https://aliyun-client-assist.oss-cn-beijing.aliyuncs.com/session-manager/linux_arm/ali-instance-cli

Çalıştırma izinleri verin:

chmod a+x ali-instance-cli

1.2 Yapılandırma

ali-instance-cli ile bir ECS örneğine bağlanmak için AccessKey gibi kimlik kimlik bilgilerini yapılandırın. Bkz. Oturum Yöneticisi için bir RAM kullanıcısının kimlik bilgilerini hazırlama.

Windows

  1. Start > Run yolunu izleyin, cmd girin ve komut istemi penceresini açmak için Enter tuşuna basın.

  2. ali-instance-cli.exe dizinine gidin. Bu örnekte C:\Users\test kullanılmaktadır.

    cd C:\Users\test
  3. Kimlik bilgilerini aşağıdaki yöntemlerden birini kullanarak yapılandırın:

    AccessKey

    İstem üzerine AccessKey ID, AccessKey gizli anahtarını ve Bölge Kimliğini yapılandırın:

    ali-instance-cli.exe configure --mode AK

    STS Belirteci

    Yapılandırmayı tamamlayın:

    ali-instance-cli.exe configure set --mode StsToken --region "<region>" --access-key-id "<ak>"  --access-key-secret "<sk>"   --sts-token "<sts_token>"

    <region>, <ak>, <sk> ve <sts_token> değerlerini gerçek bölge kimliğiniz, AccessKey ID'niz, AccessKey gizli anahtarınız ve STS belirteciniz ile değiştirin.

    CredentialsURI

    İstem üzerine Kimlik Bilgileri URI'sini ve Bölge Kimliğini girin:

    ali-instance-cli.exe configure --mode=CredentialsURI

    Aşağıdaki çıktı, yapılandırmanın başarılı olduğunu gösterir.

    image

macOS/Linux

  1. ali-instance-cli dizinine gidin. Bu örnekte ana dizin ~ kullanılmaktadır.

    cd ~
  2. Kimlik bilgilerini yapılandırın:

    AccessKey

    İstem üzerine AccessKey ID, AccessKey gizli anahtarını ve Bölge Kimliğini yapılandırın:

    ./ali-instance-cli configure --mode AK

    STS Belirteci

    Yapılandırmayı tamamlayın:

    ./ali-instance-cli configure set --mode StsToken --region "<region>" --access-key-id "<ak>"  --access-key-secret "<sk>"   --sts-token "<sts_token>"

    <region>, <ak>, <sk> ve <sts_token> değerlerini gerçek bölge kimliğiniz, AccessKey ID'niz, AccessKey gizli anahtarınız ve STS belirteciniz ile değiştirin.

    CredentialsURI

    İstem üzerine Kimlik Bilgileri URI'sini ve Bölge Kimliğini yapılandırın:

    ./ali-instance-cli configure --mode=CredentialsURI

    Aşağıdaki çıktı, yapılandırmanın başarılı olduğunu gösterir.

    image

2. Örnekle geçici bir genel anahtar kaydetme

2.1 Örneğin kimliğini alma

Hedef örneğin kimliğini alın.

ECS konsolunu kullanma

  1. Go to ECS console - Instances.

  2. Üst gezinme çubuğunda, yönetmek istediğiniz kaynağın bölgesini ve kaynak grubunu seçin.

  3. Instance sayfasında, bağlanmak istediğiniz örneği bulun ve örnek kimliğini tıklayın.

image

Alibaba Cloud CLI'yı kullanma

Alibaba Cloud CLI'yı yapılandırdıysanız, bağlanmak istediğiniz örneğin kimliğini sorgulamak için DescribeInstances işlemine çağrı yapan bir komut çalıştırın. DescribeInstances işlemi parametreleri hakkında bilgi için bkz. DescribeInstances.

Örneğin, Çin (Hangzhou) bölgesinde bulunan SessionManager-example adlı bir örneğin kimliğini sorgulamak için aşağıdaki komutu çalıştırın:
aliyun ecs DescribeInstances --region cn-hangzhou --RegionId 'cn-hangzhou' --InstanceName 'SessionManager-example'

Komut çıktısındaki InstanceId parametresinin değeri, örneğin kimliğidir.

image

API işlemlerini çağırma

Bağlanmak istediğiniz örneğin kimliğini sorgulamak için DescribeInstances işlemine çağrı yapın. Daha fazla bilgi için bkz. DescribeInstances.

2.2 Anahtar çifti oluşturma

Bilgisayarınızda bir anahtar çifti oluşturun. Genel anahtar dosyası, 2.3 adımında geçici genel anahtar olarak kullanılır.

Windows bilgisayarı

Komut İstemi'ni açın ve bir anahtar çifti oluşturmak için aşağıdaki komutu çalıştırın.

Bu örnekte, OpenSSH istemcisi kullanılarak C:\Users\test dizininde bir anahtar çifti oluşturulmaktadır.
ssh-keygen -t rsa -b 2048 -f id_rsa
  • -t rsa: Rivest-Shamir-Adleman (RSA) anahtar türü.

  • -b 2048: 2.048 bit anahtar uzunluğu.

  • -f id_rsa: id_rsa adlı anahtar dosyalarını çalışma dizinine çıkarır.

Önemli

Parola girmeniz istenir. Ayarlarsanız, özel anahtar her kullanıldığında bu parola gerekir.

Parolaya ihtiyacınız yoksa atlamak için Enter tuşuna basın.

Genel anahtar dosyası id_rsa.pub ve özel anahtar dosyası id_rsa, çalışma dizininde oluşturulur. Bu örnekte çalışma dizini C:\Users\test'tir.

macOS veya Linux bilgisayarı

Terminal'i açın ve bir anahtar çifti oluşturmak için aşağıdaki komutu çalıştırın.

Bu örnekte, OpenSSH istemcisi kullanılarak bir anahtar çifti oluşturulmaktadır.
ssh-keygen -t rsa -b 2048 -f id_rsa
  • -t rsa: RSA anahtar türü.

  • -b 2048: 2.048 bit anahtar uzunluğu.

  • -f id_rsa: id_rsa adlı anahtar dosyalarını çalışma dizinine çıkarır.

Önemli

Parola girmeniz istenir. Ayarlarsanız, özel anahtar her kullanıldığında bu parola gerekir.

Parolaya ihtiyacınız yoksa atlamak için Enter tuşuna basın.

Genel anahtar dosyası id_rsa.pub ve özel anahtar dosyası id_rsa, çalışma dizininde oluşturulur.

2.3 Genel anahtarı örneğe geçici genel anahtar olarak gönderme

Windows bilgisayarı

Komut İstemi'ni açın, ali-instance-cli.exe dizinine gidin ve geçici genel anahtarı bir örnekle kaydetmek için aşağıdaki komutu çalıştırın.

<instance_id> değerini örnek kimliğiyle, <public_key_path> değerini 2.2 adımında oluşturulan genel anahtar dosyasının yoluyla ve <ecs_username> değerini geçici genel anahtarı atamak istediğiniz kullanıcı adıyla değiştirin:
ali-instance-cli.exe send_public_key --instance <instance_id> --public-key <public_key_path> --user-name <ecs_username>

Örnek: C:\Users\test\id_rsa.pub konumundaki genel anahtarı i-bp1****** örneğiyle kaydedin ve ecs-user kullanıcısına atayın:

ali-instance-cli.exe send_public_key --instance i-bp1****** --public-key C:\Users\test\id_rsa.pub --user-name ecs-user
Önemli

Komut başarıyla tamamlandıktan sonra, ilgili özel anahtarı kullanarak 60 saniye içinde örneğe bağlanın.

macOS veya Linux bilgisayarı

Terminal'i açın, ali-instance-cli dizinine gidin ve geçici genel anahtarı bir örnekle kaydetmek için aşağıdaki komutu çalıştırın.

<instance_id> değerini örnek kimliğiyle, <public_key_path> değerini 2.2 adımında oluşturulan genel anahtar dosyasının yoluyla ve <ecs_username> değerini geçici genel anahtarı atamak istediğiniz kullanıcı adıyla değiştirin:
./ali-instance-cli send_public_key --instance <instance_id> --public-key <public_key_path> --user-name <ecs_username>

Örnek: ~/id_rsa.pub konumundaki genel anahtarı i-bp1****** örneğiyle kaydedin ve ecs-user kullanıcısına atayın:

./ali-instance-cli send_public_key --instance i-bp1****** --public-key ~/id_rsa.pub --user-name ecs-user
Önemli
  • Komut başarıyla tamamlandıktan sonra, ilgili özel anahtarı kullanarak 60 saniye içinde örneğe bağlanın.

Komutu çalıştırdıktan sonra **ERROR: 'install config_ecs_instance_connect' command failed hata iletisi görünür

Bu hata görünürse, config_ecs_instance_connect Cloud Assistant eklentisi yüklenemedi demektir. Komutu yeniden çalıştırın. Hata devam ederse eklentiyi manuel olarak yükleyin:

ECS konsolunu kullanma

config_ecs_instance_connect eklentisini yüklemek ve başlatmak için Cloud Assistant kullanarak örneğe aşağıdaki komutu gönderin.

Bkz. Komut oluşturma ve çalıştırma.

acs-plugin-manager -e -P config_ecs_instance_connect --params --install

CLI'yı kullanma

Not

Bu örnekte i-bp15vhvt43ciprqkxxxx örnek kimliği olarak kullanılmıştır. Kendi gerçek örnek kimliğinizle değiştirin.

aliyun ecs RunCommand --RegionId 'cn-hangzhou' \
 --Type 'RunShellScript' \
 --CommandContent 'acs-plugin-manager -e -P config_ecs_instance_connect --params --install' \
 --InstanceId.1 'i-bp15vhvt43ciprqkxxxx'    

3. SSH üzerinden örneğe bağlanma

Önemli

Parolanın veya genel anahtarın yanlış olduğu bildirilirse genel anahtarın süresi dolmuş olabilir. Geçici bir genel anahtar 60 saniye geçerlidir.

Komut İstemi'ni veya Terminal'i açın ve örneğe bağlanmak için aşağıdaki komutu çalıştırın.

<private_key_path> değerini 2.2 adımında oluşturulan özel anahtar dosyasının yoluyla, <ecs-username> değerini 2.3 adımında belirtilen kullanıcı adıyla ve <ecs_ip> değerini örneğin genel IP adresiyle değiştirin.
ssh -i <private_key_path> <ecs-username>@<ecs_ip>

Örnek: 223...187 örneğine ecs-user olarak ~/id_rsa özel anahtarıyla bağlanın:

ssh -i ~/id_rsa ecs-user@223.***.***.187

Genel IP adresi olmayan bir örneğe bağlanmak için ali-instance-cli bağlantı noktası yönlendirme özelliğini de kullanabilirsiniz. Bkz. Genel IP adresi olmayan bir örneğe bağlanmak için Oturum Yöneticisi CLI'nın bağlantı noktası yönlendirme özelliğini kullanma.

SSS

Bir komut çalıştırdıktan sonra komut satırı yanıt vermiyor (Örnek Çalışır durumda değil)

Bir ali-instance-cli komutu çalıştırdıktan sonra komut satırı yanıt vermiyorsa örnek Çalışıyor durumunda olmayabilir. Örnek durumunu görüntülemek için bu konudaki Örneğin Çalışır durumda olup olmadığını kontrol etme bölümüne bakın.

Bir komut çalıştırdıktan sonra komut satırı yanıt vermiyor (Güvenlik grubu yapılandırma sorunu)

Bir ali-instance-cli komutu çalıştırdıktan sonra komut satırı yanıt vermiyorsa güvenlik grubunda gerekli giden bağlantı noktaları açık olmayabilir. Varsayılan olarak temel güvenlik grupları tüm giden trafiğe izin verir. Giden kurallarını değiştirdiyseniz veya gelişmiş bir güvenlik grubu kullanıyorsanız bu sorun oluşabilir.

Oturum Yöneticisi kullanarak bir ECS örneğine bağlanırken, ECS örneğinde çalışan Cloud Assistant Agent öğesinin Cloud Assistant sunucusuna bağlı olduğundan emin olmak için bir giden güvenlik grubuna aşağıdaki kuralları ekleyin:

SSH ve Uzak Masaüstü Protokolü (RDP) gibi bağlantı yöntemlerine kıyasla Cloud Assistant Agent , Oturum Yöneticisi sunucusuna aktif olarak bir WebSocket bağlantısı kurar. Bir güvenlik kuralında yalnızca Cloud Assistant sunucusunun giden WebSocket bağlantı noktasını açmanız gerekir. Oturum Yöneticisi'nin nasıl çalıştığı hakkında bilgi için bu konunun Oturum Yöneticisi'nin çalışma şekli bölümüne bakın.
Önemli
  • Varsayılan güvenlik grubu dahil olmak üzere temel güvenlik grupları kullanıyorsanız tüm giden trafiğe izin verilir. Ek yapılandırma gerekmez.

  • Gelişmiş bir güvenlik grubu kullanıyorsanız tüm giden trafik reddedilir. İlgili kuralları yapılandırmanız gerekir. Aşağıdaki tabloda kurallar açıklanmaktadır. Güvenlik grupları hakkında bilgi için bkz. Temel ve gelişmiş güvenlik grupları.

Bir güvenlik grubuna kural ekleme hakkında bilgi için bkz. Güvenlik grubu kuralı ekleme.


Eylem


Öncelik


Protokol türü


Bağlantı noktası aralığı


Yetkilendirme nesnesi


Açıklama


Allow


1


Custom TCP


443


100.100.0.0/16


Bu bağlantı noktası, Cloud Assistant sunucusuna erişmek için kullanılır.


Allow


1


Custom TCP


443


100.0.0.0/8


Cloud Assistant Agent yüklemek veya güncellemek istediğinizde Cloud Assistant Agent yükleme paketinin depolandığı sunucuya erişmek için bu bağlantı noktası kullanılır.


Allow


1


Custom UDP


53


0.0.0.0/0


Bu bağlantı noktası, etki alanı adlarını çözümlemek için kullanılır.

Bir örneğe yalnızca Oturum Yöneticisi kullanarak bağlanmak istiyorsanız, ECS örneğinin güvenliğini artırmak için bir güvenlik grubundan SSH bağlantı noktasına (varsayılan 22) ve RDP bağlantı noktasına (varsayılan 3389) izin veren gelen kurallarını silin.

Bir komut çalıştırdıktan sonra DeliveryTimeout hatası bildiriliyor (Cloud Assistant Agent çevrimdışı)

Bir ali-instance-cli komutu çalıştırdığınızda DeliveryTimeout hatası oluşursa Cloud Assistant Agent kullanılamıyor olabilir. Cloud Assistant Agent'ın örnekte yüklü olup olmadığını kontrol etme bölümüne bakın.

image

image

Bir komut çalıştırdıktan sonra "session manager is disabled, please enable first" hatası bildiriliyor

Bir ali-instance-cli komutu çalıştırdıktan sonra session manager is disabled, please enable first hatası oluşursa konsolda Oturum Yöneticisi'ni etkinleştirin

Uzun süreli hareketsizlik nedeniyle bağlantı otomatik olarak kapatılıyor

Oturum Yöneticisi bağlantıları boşta kalma zaman aşımından sonra kapanır. Varsayılan süre 3 dakikadır. Saniye cinsinden özel bir boşta kalma zaman aşımı ayarlamak için --idle-timeout parametresini kullanın.

Örnek: 10 dakikalık bir boşta kalma zaman aşımıyla bağlanma:

./ali-instance-cli session --instance instance-id --idle-timeout 600
Not

Bu özellik ali-instance-cli sürümünü gerektirir:

  • Linux: 1.2.0.48

  • Windows: 1.1.0.48

  • macOS: 1.3.0.48

ali-instance-cli günlükleri nasıl analiz edilir

Sorunları belirlemek için ali-instance-cli günlüklerini analiz edin.

  • Oturum Yöneticisi CLI günlükleri: ali-instance-cli kullanırken aracın dizininde bir günlük klasörü (ör. ~/log/aliyun_ecs_session_log.2022XXXX) oluşturulur.

  • Cloud Assistant Agent günlükleri:

    • Linux

      /usr/local/share/aliyun-assist/<Cloud Assistant Agent version>/log/
    • Windows

      C:\ProgramData\aliyun\assist\<Cloud Assistant Agent version>\log