Logging in to Windows Instance Using RDP

Last updated: 2022-01-07 10:16:50


    Remote Desktop Protocol (RDP) is a multiple-channel protocol developed by Microsoft that allows a local computer to connect to a remote computer. We recommend you use RDP to log in to your Windows CVMs. This document describes how to log in to Windows instances using RDP files.

    Supported Systems

    You can log in to your CVMs from Windows, Linux, and MacOS using RDP.


    • You must have the admin account and password for logging in to a Windows instance remotely.
    • You have purchased public IPs for your CVM instance and port 3389 is open. (this port is open by default for a CVM purchased with quick configuration).


    Logging in to your CVM on Windows using RDP

    1. Log in to the CVM Console.
    2. On the Instances page, locate the Windows CVM you want to log in to and click Log In as shown below.
    3. In the Log into Windows instance pop-up window, select Log in with RDP file and click Download RDP file to download the RDP file to your local computer.

      If you have changed the remote login port, append the IP address with :port in the RDP file.

    4. Double-click the downloaded RDP file, enter the password, and click OK to remotely connect to your Windows CVM.

    Logging in to your CVM on Linux using RDP


    We recommend you use rdesktop as the remote desktop client. For more information, see the official introduction to rdesktop.

    1. Run the following command to check whether rdesktop has been installed.
      • If yes, perform step 4.
      • If no, you will be prompted with "command not found". In this case, perform step 2.
    2. Open a terminal window and run the following command to download rdesktop. This step uses rdesktop v1.8.3 as an example.
      wget https://github.com/rdesktop/rdesktop/releases/download/v1.8.3/rdesktop-1.8.3.tar.gz
      If you want to install the latest version, visit the rdesktop page on GitHub to find it. Then replace the path in the command with that of the latest version.
    3. In the directory where rdesktop will be installed, run the following commands to decompress and install rdesktop.
      tar xvzf rdesktop-<x.x.x>.tar.gz ## Replace x.x.x with the version number of the downloaded rdesktop. 
      cd rdesktop-1.8.3
      make install
    4. Run the following command to connect to the remote Windows instance.

      Replace the parameters in the example with your own parameters.

      rdesktop -u Administrator -p <your-password> <hostname or IP address>
      • Administrator refers to the admin account mentioned in the prerequisites section.
      • <your-password> refers to the login password that you set.
        If you use a system default password to log in to the instance, you can obtain the password at the Message Center. If you forgot your password, please reset the instance password.
      • <hostname or="" ip="" address=""> refers to the public IP address or custom domain name of your Windows instance.

    Logging in to your CVM on MacOS using RDP


    • The following operations use Microsoft Remote Desktop for Mac as an example. Microsoft stopped providing a link to download the Remote Desktop client in 2017. Currently, its subsidiary HockeyApp is responsible for releasing the beta client.Go to Microsoft Remote Desktop Beta to download a Beta version.
    • The following operations use a CVM on Windows Server 2012 R2 as an example.
    1. Download and install Microsoft Remote Desktop for Mac on your local computer.
    2. Start MRD and click Add Desktop, as shown below:
    3. In the Add Desktop pop-up window, follow the steps illustrated in the following image to establish a connection to your Windows CVM.
      1. In the PC name text field, enter the public IP address of your CVM.
      2. Click Add.
      3. Retain the default settings for the other options and establish the connection.
        Your entry has now been saved, as shown below:
    4. Double-click the new entry. Input your username and password for CVM and click Continue.
    5. In the pop-up window, click Continue to establish the connection, as shown below:

      If the connection is successful, the following page will appear: