tencent cloud

Feedback

Logging in to Linux Instance via WebShell

Last updated: 2022-09-26 11:28:02

    Overview

    WebShell is a login method recommended by Tencent Cloud. You can use it to directly log in to a Linux instance quickly. It has the following strengths:

    • Supports copy and paste.
    • Supports scrolling with mouse wheel.
    Note
    • When you create a Linux Lighthouse instance, it will be bound to a key by default. The username of the key is lighthouse, which has the root privileges.
    • When you use WebShell to log in to a Linux instance, the system will use the key of the lighthouse username for login by default.

    Supported Systems

    Windows, Linux, or macOS.

    Prerequisites

    • Before login, confirm that the firewall of the instance has passed port 22 (which has been enabled by default when the instance was created).

    Directions

    1. Log in to the Lighthouse console.
    2. Find the target instance in the server list and select a login method as desired.
    • Click Log in in the instance card in the server list.
    • Click the instance card to enter the instance details page and click Log In in Remote Login or in the top-right corner of the page.
    • For an instance created by using an application image, select Pre-installed application on the instance details page and click Log in in the top-right corner of the page.

      The page for successful login is as shown below:
      • After successful login, you can set up low-load lightweight applications with a moderate number of access requests, such as small and middle-sized websites, web applications, blogs, forums, mini games, ecommerce, cloud storage, image hosting, and cloud-based development, testing, and learning environments as instructed in Best Practices.
      • The WebShell UI has a variety of features. You can use the virtual keyboard on the mobile client to change the WebShell appearance, upload/download files, start self-service instance detection, enable multi-session, split the screen, and get the prompts as instructed in More WebShell features.

    Enabling/Disabling WebShell-based quick login

    Note

    After a Lighthouse instance is created successfully, the WebShell-based quick login feature will be enabled by default. You can disable or enable it again in the following steps:

    1. Log in to the Lighthouse console.
    2. Find the target instance in the server list and enter the instance details page.
    3. In Quick login in Remote login, you can enable or disable WebShell-based quick login as needed:
    • Close: If you don't need to use quick login, you can disable it.
      Note
      • After quick login is disabled, you can still use the local SSH client to remotely log in to the instance. You can also enable quick login again.
      • After quick login is disabled, the public key (stored under the lighthouse user of the operating system by default) of the default system key won't be deleted at the same time. You can delete the public key by yourself. However, if it is deleted, quick login will not take effect after being enabled again.
    • Enable: After quick login is enabled, you can use the default system key to quickly log in to the instance through WebShell in a browser.
      Note

      Confirm that the public key (stored under the lighthouse user of the operating system by default) of the default system private key is not deleted; otherwise, the quick login feature won't work after being enabled.

    More WebShell features

    WebShell offers a variety of features to ensure a satisfactory user experience.

    WebShell features are described as follows:

    Multiple keyboard shortcuts

    展开&收起

    WebShell supports multiple keyboard shortcuts, which can be viewed on the UI as instructed below:

    1. Log in to the instance as instructed in Logging in to Linux Instance via WebShell.
    2. On the WebShell UI, open the Keyboard shortcuts window to view the supported shortcuts.
    • If your local computer uses macOS: Press ⌘ + /.
    • If your local computer uses Windows: Press Ctrl + /.

    Viewing instance monitoring data

    展开&收起

    You can view the instance monitoring data in real time on the WebShell UI as instructed below. Currently, the data is refreshed once every 10 seconds.

    1. Log in to the instance as instructed in Logging in to Linux Instance via WebShell.
    2. At the bottom of the WebShell UI, view the instance monitoring data.

    Changing the username

    展开&收起

    You can specify the user to log in via WebShell as instructed below:

    1. Log in to the instance as instructed in Logging in to Linux Instance via WebShell.
    2. In the Log in pop-up window, the default username is lighthouse, which can be changed as needed.
    3. Then click Log in

    Quickly installing TencentCloud Automation Tools

    展开&收起

    You need to use TencentCloud Automation Tools to implement quick passwordless login via WebShell. If the tool is not installed for your instance, you can install it upon login as instructed below:

    1. Log in to the instance as instructed in Logging in to Linux Instance via WebShell.
    2. In the Log in pop-up window, select the installation method as needed if you are prompted that TencentCloud Automation Tools is not installed for your instance.
    • Quick installation (reboot required): Read the notes, select Installation requires your agreement to a forced shutdown, and click Quickly install TencentCloud Automation Tools.
    • Manual installation (no reboot required): Perform the installation as instructed in Installing TAT Agent.
    1. After the installation is completed, the instance can be quickly logged in to via WebShell.

    Using the command block mode

    展开&收起

    You can use the command block mode on the WebShell UI. After the mode is enabled, every executed command will be displayed as a module for easy use of WebShell. You can also disable the mode as needed as instructed below:

    1. Log in to the instance as instructed in Logging in to Linux Instance via WebShell.
    2. On the WebShell UI, enable or disable the command line mode.
    • Enable the command line mode: Select on the toolbar of the WebShell UI to enable the command block mode. After it is enabled, a command will be executed as follows:
    • Disable the command line mode: Select on the toolbar of the WebShell UI to disable the command block mode. After it is disabled, a command will be executed as follows:

      Note

      If the command block mode is disabled and enabled again, you need to reconnect to WebShell.

    Viewing the release note

    展开&收起

    You can view the latest release note of WebShell, including the new features, bugfixes, and features coming soon, as instructed below:

    1. Log in to the instance as instructed in Logging in to Linux Instance via WebShell.
    2. Select in the bottom-right corner of the WebShell UI.
    3. View the latest release note in the pop-up window.

    Selecting an instance to log in

    展开&收起

    You can select any instance to log in on the WebShell UI as instructed below:

    1. Log in to the instance as instructed in Logging in to Linux Instance via WebShell.
    2. Select on the toolbar of the WebShell UI.
    3. For the first time, the Select the instance to be displayed window will pop up. Select the target instance and click OK.
    4. Select > Add instance to add instances as needed.
      Note

      Currently, up to ten instances can be added.

    5. After the instances are added successfully, you can select any instance to log in.

    Uploading/Downloading files

    展开&收起

    You can upload local files to the instance or download files from the instance to your local file system as instructed below:

    1. Log in to the instance as instructed in Logging in to Linux Instance via WebShell.
    2. Select on the toolbar of the WebShell UI.
    3. In the pop-up menu, select Upload or Download.
      The detailed steps are as follows:
    • Upload a file:
      1. In the Select the file and directory for upload pop-up window, select Local upload or Upload via URL as needed.
      2. If you select Local upload, click Click to upload and then select a local file. If you select Upload via URL, enter the file URL in URL.
      3. Select the target upload directory and click OK.
        Note

        Currently, files can be uploaded only to the home > lighthouse directory.


        Click in the bottom-right corner of the page and view the operation result in the pop-up window. If the file is uploaded successfully, the result will be displayed.
    • Download a file:
      1. In the Download file pop-up window, open the directories and select the target file.
      2. Click OK and select the local directory in the pop-up window.
      3. Click in the bottom-right corner of the page and view the operation result in the pop-up window. If the file is downloaded successfully, the result will be displayed.

    Using self-service instance detection

    展开&收起

    If you encounter any problem when logging in to or using the instance, you can perform self-service instance detection as instructed below:

    1. Log in to the instance as instructed in Logging in to Linux Instance via WebShell.
    2. Select on the toolbar of the WebShell UI.
    3. In the Self-service instance detection pop-up window, click OK.

    Enabling the multi-tag window

    展开&收起

    You can open multiple instance connection pages in the form of tags on the WebShell UI as instructed below:

    1. Log in to the instance as instructed in Logging in to Linux Instance via WebShell.
    2. Select at the top of the WebShell UI.
    3. You can see that the (1) instance ID tag has been created.
      Note
      • Up to five tags can be opened at the same time.
      • A tag will be named in the format of (Incrementing number) instance ID.

    Enabling screen splitting

    展开&收起

    You can split the screen on the WebShell UI to view and execute multiple operation tasks at the same time as instructed below:

    1. Log in to the instance as instructed in Logging in to Linux Instance via WebShell.
    2. Select at the top of the WebShell UI.
    3. You can see that the screen has been split into three sections named in the format of (Incrementing number) instance ID:
      Note
      • The screen can be split into up to four sections.
      • A section will be named in the format of (Incrementing number) instance ID.

    Changing the skin

    展开&收起

    You can change the text size, font, and color on the WedShell UI as instructed below:

    1. Log in to the instance as instructed in Logging in to Linux Instance via WebShell.
    2. Select on the toolbar of the WebShell UI.
    3. In the pop-up window, change the text size, font, or color of the WebShell as you like.
    Contact Us

    Contact our sales team or business advisors to help your business.

    Technical Support

    Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

    7x24 Phone Support