{{htmlmetatags>metatag-robots=(index, follow)}}
====== 新手教程：如何用 MobaXterm 登录服务器并上传下载文件 ======

<wrap em>本篇是专门写给完全没有用过终端工具的新手看的"保姆级"教程。如果你已经会用 xshell / MobaXterm / PuTTY 等工具登录服务器，可以直接跳过本篇。</wrap>

在整个 PWstudio 安装以及后续使用过程中，你都需要一个工具来做两件事：

  - **登录**到你的 Linux 服务器（工作站），执行安装文档里的各种命令
  - 在你自己的 Windows/Mac 电脑 和 服务器之间 **互相传文件**（比如把下载好的显卡驱动、Docker 安装包传到服务器上）

这两件事，用 **MobaXterm** 一个软件就能同时搞定，所以本教程以它为例。（如果你更习惯用 xshell + xftp，或者 PuTTY + WinSCP，原理是完全一样的，跳过本篇也没关系。）

----

===== 1. 下载安装 MobaXterm =====

  - 打开浏览器，访问官网下载页：[[https://mobaxterm.mobatek.net/download.html|MobaXterm 官网下载]]
  - 选择 **Home Edition（免费版）** 下的 **Installer edition**（安装版，双击直接装，比较省心；Portable 版是免安装绿色版，也可以用）
  - 下载完成后，双击安装包，一路点击"下一步/Next"，用默认选项安装即可

===== 2. 新建一个 SSH 连接（登录服务器） =====

打开 MobaXterm 后：

  - 点击左上角 **Session**（会话）按钮
  - 在弹出的窗口里选择 **SSH**
  - 在 **Remote host** 里填入服务器的 IP 地址（这个地址由你的安装文档或管理员提供，安装文档中一般写作 ''[宿主机ip]''，需要替换成实际的 IP，比如 ''192.168.1.100''）
  - 勾选 **Specify username**，并在后面填入用户名（比如 PWstudio 容器提供的用户名 ''pwmat'' 或 ''root''，具体见 [[pwstudio:quickstart_gpu#对容器登录、上传下载|对容器登录、上传下载]] 章节里的表格）
  - 如果文档中提到端口号不是默认的 22（比如 PWstudio 容器给出的端口是 ''2297''），点击 **Advanced SSH settings** 选项卡，把 **Port** 改成对应的端口号（比如 2297）
  - 点击 **OK**

第一次连接时，会弹出一个安全提示，大意是"无法验证此主机的真实性，是否继续连接？"，这是正常现象（每台服务器第一次连接都会有这个提示），直接点击 **Accept** / 或者输入 **yes** 即可。

接着会提示你输入密码，把安装文档里给的密码输入进去（**注意：密码输入时终端上通常不会显示任何字符，包括星号都不会显示，这不是电脑坏了，是正常的安全设计，正常输入完直接按回车即可**）。

登录成功后，你会看到左边出现一个文件浏览器面板（显示服务器上的文件目录），右边是命令行终端窗口，这就代表登录成功了。

<wrap tip>
小技巧：登录成功后，MobaXterm 会问你要不要保存这次的会话方便下次直接点开，建议保存，下次就不用重新填一遍地址、用户名、端口了。
</wrap>

===== 3. 在终端里执行命令（复制粘贴的方法） =====

登录成功后，右边的窗口就是一个标准的 Linux 命令行终端，安装文档里所有 ''<code bash>...</code>'' 框里的内容，都是要在这个终端里执行的命令。

推荐做法：

  - 用鼠标在网页文档上，选中你要执行的那一整行命令，按 ''Ctrl+C'' 复制（Mac 上是 ''Cmd+C''）
  - 切换到 MobaXterm 的终端窗口，**直接在终端窗口里点击鼠标右键**，MobaXterm 会自动把刚才复制的内容粘贴到光标位置（这是 MobaXterm 的默认设置）
  - 确认粘贴的内容正确后，按回车执行

<wrap important>
命令行最前面那一小段，形如 ''[pwmat@localhost ~]$''，叫"提示符"，**不是命令的一部分**，复制命令时不要把它也选进去，否则会报错。
</wrap>

===== 4. 上传 / 下载文件（图形化拖拽，最简单） =====

MobaXterm 登录成功后，左侧会出现一个文件浏览器面板（如果没看到，可以点击窗口左侧的小箭头把它展开），这个面板显示的就是服务器上当前目录的文件列表，操作方式跟 Windows 资源管理器很像：

  - **上传文件（从你的电脑传到服务器）**：直接把 Windows 上的文件（比如刚从 NVIDIA 官网下载好的驱动 ''.run'' 文件，或者 Docker 的离线安装包）用鼠标拖拽到左侧这个面板里，松开鼠标就会自动开始上传。也可以点击面板上方工具栏里的上传图标（一个向上的箭头），选择本地文件上传。
  - **下载文件（从服务器传到你的电脑）**：直接把左侧面板里的文件，用鼠标拖拽到你 Windows 桌面或任意文件夹，即可下载到本地。

<wrap tip>
如果你需要先切换到某个目录（比如文档里提到"先 cd 到某个目录"），可以直接在终端里输入对应的 ''cd'' 命令，左边的文件浏览器面板也会跟着自动跳转到相同目录，非常方便。
</wrap>

===== 5. 常见小问题 =====

  * **提示密码错误，但我确定密码是对的？** 检查有没有多复制了空格或换行符；也检查大小写是否输错；有些浏览器复制密码时会带上不可见字符，建议手动输入密码试试。
  * **窗口突然断开连接了？** 服务器重启（比如安装驱动过程中会要求 reboot）之后，MobaXterm 的连接会断开，这是正常的，等服务器重启完成后（一般 1-2 分钟），重新双击左侧保存的会话，重新登录一次即可（记得重新输入密码）。
  * **右键粘贴没反应？** 可以到 MobaXterm 菜单栏 **Settings → Configuration → Terminal**，确认"鼠标右键粘贴"的选项是开启的；或者直接使用键盘快捷键 ''Shift+Insert'' 粘贴。
  * **中文乱码？** 一般不影响命令执行，如果实在看着别扭，可以在 Settings → Configuration → Terminal 里把编码改成 UTF-8。

完成以上几步，你就已经具备了跟着后续安装文档、一步步操作 Linux 服务器的能力了。接下来可以回到 [[pwstudio:readme|PWstudio 安装前必看]]，按照文档继续安装。

~~DISCUSSION:off~~