Skip to content

Terminal

The terminal module provides a Web-based SSH terminal, allowing you to connect to servers and execute commands directly in the browser.

Terminal Page

Terminal Page

Create Host

Click the Create Host button to add an SSH connection:

Configuration Items

  • Name: Connection name for identification (defaults to the host when left empty)
  • Host: Server IP address or domain name
  • Port: SSH port, default 22
  • Authentication Method: Password or private key
  • Username: SSH username
  • Password: Login password (shown only when using password authentication)
  • Private Key: SSH private key content (shown only when using private key authentication)
  • Passphrase: Passphrase protecting the private key, leave empty if the key has none (shown only when using private key authentication)
  • Remarks: Optional remarks

Authentication Methods

MethodDescription
PasswordAuthenticate using username and password
Private KeyAuthenticate using an SSH private key

Recommendation

Production environments are recommended to use key authentication for better security.

Connect to Server

  1. Click the server icon in the top-right toolbar to open the Hosts drawer
  2. Click a host card to open a terminal tab for it
  3. Alternatively, click the + button in the tab bar and pick a host from the dropdown
  4. Start executing commands

Each connected tab shows a status indicator and the current connection latency (in milliseconds).

Terminal Features

Multiple Tabs

Supports opening multiple terminal tabs simultaneously for easy switching between sessions.

Copy and Paste

  • Copy: Automatically copies when text is selected, or use Ctrl+Shift+C (Cmd+C on macOS)
  • Paste: Right-click to paste, or use Ctrl+Shift+V (Cmd+V on macOS)

TIP

In a non-HTTPS context the clipboard API is unavailable, so use Ctrl+V to paste instead.

Fullscreen Mode

Click the fullscreen button to enter fullscreen mode for more terminal space.

Font Settings

You can adjust the terminal font size from the settings popover (10–32), or hold Ctrl and scroll the mouse wheel over the terminal to zoom in and out.

Local Terminal

By default, a Local tab opens a Bash session on the current server, allowing you to operate it directly without configuring a host.

Remote Hosts

You can add multiple remote hosts for convenient management of multiple servers:

  1. Open the Hosts drawer and click Create Host
  2. Fill in the remote server information
  3. After saving, click the host card to connect

Security Recommendations

  1. Use strong passwords or key authentication
  2. Change the default SSH port
  3. Restrict IP addresses that can access SSH
  4. Regularly change passwords or keys
  5. Log in with a non-root user

FAQ

Connection Timeout

  • Check if the server IP and port are correct
  • Check if the firewall allows SSH connections
  • Check if the SSH service is running normally

Authentication Failed

  • Check if the username and password are correct
  • Check if the key format is correct
  • Check if the user has SSH login permissions

Chinese Character Garbled

  • Check the server's locale settings
  • Ensure the server encoding is UTF-8