Skip to content

Windows

The server interacts with commands via SSH and transfers files via SFTP. Different SSH and SFTP clients are recommended for different operating systems.

It is recommended to use Xshell and Xftp to connect to the server. The free version can be downloaded via this link. The user interface is relatively user-friendly and easy to use.

However, since Xshell and Xftp are paid software with limited features in the free version, you can consider using VS Code with an SSH plugin as an SSH client and WinSCP as an SFTP client after you are familiar with SSH and SFTP operations.

IP Whitelist

Since the server may be configured to prevent access from external networks (all servers in this center have external network access disabled), please first declare up to 3 commonly used IP addresses to the administrator to exempt the requirement for internal network login.

How to obtain a public IP address: ip4.me

Please do not query while using a proxy or VPN. Otherwise, you may not be able to find the IP address, or it may return the IP address of a public data center.

Some teams can use a jump server to bypass the restrictions. Please consult the IT administrator of your team for details.

SSH

  1. Create a new session.
xshell-new-connect
  1. Enter the connection configuration.
xshell-config-1
  1. Enter the username and password.
xshell-passwd
  1. Click "OK" to save the configuration to the session manager. Double-click the configuration in the session manager to log in to the server. The appearance of <username>@<host> indicates successful login.
xshell-login-success
Cannot connect to 'http://xxx.xxx.xxx'

The connection for SSH and SFTP does not use the HTTP protocol. Simply enter xxx.xxx.xxx in the Host field; no additional protocol needs to be added (unless your server administrator explicitly tells you that you need one).

WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED!

This error message indicates that the remote server's key has been changed (e.g., the system was reinstalled, or a new key was generated). In this case, you need to delete the public key of this server from your system's known_hosts file.

SFTP

  1. Start Xftp. Enter the configuration and click "Connect" to enter the file management interface.
xftp-config
Cannot connect to 'http://xxx.xxx.xxx'

The connection for SSH and SFTP does not use the HTTP protocol. Simply enter xxx.xxx.xxx in the Host field; no additional protocol needs to be added (unless your server administrator explicitly tells you that you need one).

  1. You can then view and log in to the saved configurations here.
xftp-all-config
  1. Set to display hidden files.
xftp-show-all-file-1
xftp-show-all-file-2
  1. Right-click on a file to transfer it between the local machine and the server.
xftp-transfer

Port Listening

Why is port listening necessary?

This setting is crucial for using Jupyter Lab. Please complete this step before configuring Jupyter Lab. Please apply for a port number from the administrator, and you can choose any number between 10000-65535. This example uses port 22222.

  1. Right-click in the session manager and go to the properties of the session configuration.
xshell-config-more
  1. Add a port listening rule.

xshell-tunnel

xshell-port

  1. Reconnect the session to activate port listening.