SSH / SFTP / rz/sz

SSH resources can be opened as a terminal or as an SFTP file manager.

Basic Configuration

Field	Description
Name	Resource display name
Host	SSH server address
Port	SSH port, default 22
Username	SSH username
Authentication Method	Enter each time, saved password, or private key

Authentication Methods

Enter Each Time

A password input dialog appears when opening the resource. Suitable for scenarios where you don't want to save the password.

Saved Password

The password is saved in the resource configuration. Suitable for low-risk internal network services.

Private Key

First, add a private key in Settings > Resources > SSH, then select that key in the SSH resource.

Private keys can be added in two ways:

• Paste an existing private key.
• Generate a new Ed25519 private key.

If the private key has a passphrase and the passphrase is not saved in settings, you will be prompted to enter it when connecting.

SSH Terminal

The terminal supports:

• Theme configuration.
• Font size configuration.
• Pinch-to-zoom for font size.
• Quick input bar.
• Ctrl / Alt sticky keys.
• Arrow keys, PageUp, PageDown, Home, End.
• F1 through F12.

When running on macOS, the mobile quick input bar is typically hidden because a physical keyboard is more suitable for terminal input.

Ctrl and Alt Sticky Keys

Tapping Ctrl or Alt puts them into a held state. Pressing another key sends a key combination, for example:

• Tapping Ctrl then C is equivalent to Ctrl+C.
• Tapping Alt then an arrow key can trigger combined actions in terminal programs.

After sending a key combination, the sticky state is automatically released.

SFTP Mode

Enable "Open as SFTP file manager" on the SSH resource edit page. The resource will then appear as SFTP in the resource list and open the file management interface.

SFTP default directory policy:

• Username is root: defaults to /
• Other usernames: defaults to /home/<username>
• If a default directory is manually specified, the manual value is used.

rz/sz File Transfer

When SFTP mode is disabled, you can enable rz/sz file transfer. This is suitable for SSH jump server scenarios because it transmits through the terminal session and does not rely on a separate SFTP channel.

Usage:

• After running rz on the remote side, the app shows a file picker for upload.
• After running sz <file> on the remote side, the app receives and saves the file.

Notes:

• rz/sz requires lrzsz or a compatible tool to be installed on the remote side.
• Do not close the SSH page during transfer.
• If the terminal prints abnormal control characters, it may be due to the remote shell, terminal program, or zmodem tool output mixing with the protocol stream.