XShell

XShell是一款Windows平台上的SSH客户端，适合通过图形化界面管理多个远程实例。本文以登录OLA Cloud实例为例，介绍XShell的安装、SSH连接、会话保存、文件传输和长时间运行程序的方法。
警告： 如果通过SSH登录后执行训练程序，请使用screen或tmux开守护进程，确保程序不受SSH连接中断影响。具体使用方法请参考守护进程文档。

1.下载并安装XShell

XShell是付费版软件，但是有免费的家庭及学校版本。

官方链接

下载后打开根据指示安装即可。启动后XShell提示输入名称和邮箱，可以点击右下角按钮跳过。

2.获取OLA Cloud实例的SSH登录信息

登录OLA Cloud，进入“容器管理”，启动需要使用的实例。

在实例详情或连接信息中找到SSH登录指令，并复制完整命令。下面以以下命令为例：

这条命令中各个参数的含义如下：

用户名：root

主机（host）：123.xxx.xxx.32

端口号：30220

注意： 每个实例的SSH主机和端口都可能不同，请以当前实例页面显示的登录指令为准，不要直接照抄示例中的地址和端口。

3.在XShell中新建SSH会话

打开XShell，点击左上角的“文件”菜单，选择“新建”，打开新建会话窗口。

在“连接”选项中填写以下内容：

名称：自定义，例如OLA Cloud-训练实例

协议：选择SSH

主机：填写SSH登录指令中root@后面的地址，例如123.xxx.xxx.32

端口号：填写SSH登录指令中-p后面的端口，例如30220

填写完成后，点击“确定”或“连接”。

例如，命令ssh -p 30220 root@123.xxx.xxx.32对应的XShell配置为：主机123.xxx.xxx.32，端口30220，协议SSH。

4.配置用户名并登录实例

首次连接某台服务器时，XShell可能会弹出服务器主机密钥确认窗口。确认主机地址和端口无误后，查看指纹信息并选择接受；如果希望下次不再提示，可以选择接受并保存。

首次连接时，XShell可能会弹出“SSH用户身份验证”窗口。在“用户名”中填写SSH登录指令中@前面的用户名，通常为root。

在身份验证方式中选择“Password”，然后输入实例SSH密码。为方便下次登录，可以勾选“记住密码”，也可以出于安全考虑不保存密码。

登录成功后，XShell窗口中会出现远程服务器的命令提示符，此时输入的命令将在OLA Cloud实例中执行。

可以使用以下命令确认当前所在的服务器和目录：

如果需要上传或下载文件，可以使用XShell配套的Xftp，也可以使用OLA Cloud提供的JupyterLab或其他支持SCP的工具。XShell主要用于SSH终端操作。

5.保存和再次使用会话

XShell会将新建的连接保存到会话列表中。下次登录时，打开XShell，在左侧会话列表中双击之前保存的会话即可连接，无需重新填写主机和端口。

如果实例重启后SSH登录地址或端口发生变化，请打开会话属性，更新“连接”页面中的主机和端口，再重新连接。

不建议在会话名称中保存密码或其他敏感信息。共享电脑上使用XShell后，请及时退出账号并删除不需要的会话记录。

6.长时间运行程序时使用screen

如果直接在SSH终端中运行训练程序，SSH连接断开后，程序可能会被一并终止。因此，调试完成后，强烈建议使用screen或tmux运行需要长时间执行的程序。

详情见：守护进程

7.常见问题

输入密码时没有任何显示

这是SSH的正常行为。XShell输入密码时通常不会显示密码字符或星号，直接输入密码后按回车即可。

出现`Permission denied`

请检查以下内容：

用户名是否为实例页面提供的用户名，通常为root

SSH密码或密钥是否正确

XShell中选择的认证方式是否与当前配置一致

主机和端口是否填写完整

出现`Connection refused`或连接超时

请确认：

实例已经开机并处于运行状态

使用的是当前实例最新的SSH登录信息

XShell中的主机地址和端口没有填写错误

本地网络或代理没有拦截SSH连接

关闭XShell后程序停止

如果程序是在普通SSH终端中直接执行的，断开连接后程序可能会终止。请使用screen或tmux重新启动程序，并通过日志文件查看运行情况。

终端中文显示乱码

可以检查XShell会话属性中的“终端”设置，确认终端类型和编码设置与远程服务器一致。通常可以尝试将编码设置为UTF-8。

如果只是程序日志乱码，还需要检查远程服务器的Locale配置以及程序本身的文本编码设置。

1.下载并安装XShell#

2.获取OLA Cloud实例的SSH登录信息#

3.在XShell中新建SSH会话#

4.配置用户名并登录实例#

5.保存和再次使用会话#

6.长时间运行程序时使用screen#

7.常见问题#

输入密码时没有任何显示#

出现Permission denied#

出现Connection refused或连接超时#

关闭XShell后程序停止#

终端中文显示乱码#