xshell导出文件 远程文件保存到本地

在 Xshell 终端里看到远程服务器的文件列表，并不等于文件已经保存到了你的 Windows 电脑上。要把日志、配置文件或备份数据可靠地取回本地，必须通过专门的文件传输通道，而不是简单复制终端里的文字。使用 Xshell 配合 Xftp 是最稳妥的方式，若环境受限也可选择 SFTP 或 ZMODEM。下面按实际操作顺序，演示如何确认文件、执行传输并验证结果。

在终端确认文件路径，并在本地建立专用保存目录

1. 先确认远程文件和本地保存位置

在开始传输前，先在 Xshell 终端中确认目标文件是否存在，并记录其完整路径。输入以下命令查看当前目录和文件详情：

pwd
ls -lh /var/log/your-app.log

ls -lh 能显示文件大小、修改时间和权限。注意，能看到文件名不代表当前账号一定有读取权限。如果是敏感配置或私钥文件，请先向管理员确认是否允许下载。同时，在 Windows 资源管理器中创建一个专门的文件夹用于存放下载文件，建议按“服务器名_日期”命名，避免后续混淆。

如果文件正在被程序持续写入（如实时日志），直接下载可能导致文件不完整。此时建议在服务器端先压缩或复制一份静态副本，再对副本进行传输。

2. 通过 Xftp 传输远程文件

Xftp 是与 Xshell 配套的文件传输工具，两者会话信息通常可以互通。保持 Xshell 的 SSH 连接处于活动状态，在 Xshell 窗口顶部菜单栏点击【工具】，选择【新建文件传输】或直接点击工具栏上的 Xftp 图标。

通过Xftp集成界面将远程文件拖拽至本地目录

系统会自动启动 Xftp 并尝试使用当前会话的认证信息连接服务器。Xftp 界面分为左右两栏：左侧是本地 Windows 目录，右侧是远程服务器目录。

1. 在左侧窗口导航到之前创建的本地保存文件夹。
2. 在右侧窗口输入或逐级打开远程文件所在的路径。
3. 选中目标文件，将其拖拽到左侧窗口，或右键选择【下载】。

等待进度条走完。传输完成后，不要只看提示框，建议在左侧窗口右键点击文件，选择【属性】核对文件大小和修改时间是否与服务器端一致。如果服务器使用了非默认 SSH 端口（如 2222），请确保 Xftp 会话属性中的端口设置与 Xshell 完全一致，否则会导致连接失败。

3. 用 SFTP 客户端连接同一服务器

如果没有安装 Xftp，或者需要更独立的文件管理环境，可以使用支持 SFTP 协议的第三方客户端（如 WinSCP、FileZilla）。SFTP 是通过 SSH 通道加密传输文件，与 Xshell 的登录凭证通用。

新建站点连接时，协议选择 SFTP，主机名、端口、用户名和密码（或密钥）填写与 Xshell 会话相同的信息。连接成功后，界面布局与 Xftp 类似。先在远程面板找到文件，再下载到本地面板指定的目录。建议先下载一个小文件测试权限和路径是否正确，再进行大批量传输。若提示“Permission denied”，说明当前用户无权读取该文件，需联系管理员调整权限或将文件复制到临时目录。

3. 用 SFTP 客户端连接同一服务器

4. 服务器支持时使用 ZMODEM

部分轻量级服务器或特定运维场景下，管理员可能安装了 lrzsz 工具包，支持 ZMODEM 协议。这种方式无需额外开启文件传输服务，直接在终端交互即可。

在 Xshell 终端中输入发送命令：

sz /path/to/file.log

执行后，Xshell 会检测到 ZMODEM 请求并弹出【浏览文件夹】对话框，让你选择本地保存路径。选择目录后点击确定，文件即开始传输。

执行sz命令后Xshell自动弹出本地文件保存对话框

注意，如果终端只输出一堆乱码字符而没有弹出保存窗口，说明服务器未安装 sz 命令或 Xshell 未启用 ZMODEM 接收功能。此时不要在终端里手动复制乱码内容保存为文件，那是无效的控制字符。ZMODEM 适合传输中小文件，大文件或断点续传建议使用 SFTP。

5. 下载后核对文件是否完整

文件传输结束后，必须验证完整性，尤其是对于配置文件和二进制备份。最简单的方法是比对文件大小。更严谨的方式是计算哈希值。

在服务器端执行：

sha256sum /path/to/file.log

在 Windows 本地 PowerShell 中执行：

Get-FileHash .\file.log -Algorithm SHA256

对比两端输出的 SHA-256 字符串。如果完全一致，说明文件在传输过程中没有发生字节丢失或损坏。如果文本文件打开出现乱码，但哈希值一致，通常是编辑器编码识别错误，尝试用 UTF-8 或 ANSI 重新打开即可；如果哈希值不同，则文件已损坏，需重新下载。

6. 传输失败时按阶段排查

如果遇到传输问题，可按以下逻辑排查：

• Xftp 无法连接：检查主机 IP、端口、用户名是否与 Xshell 一致；若使用密钥登录，确认 Xftp 是否加载了正确的私钥文件。
• 单个文件下载失败：检查远程文件权限（ls -l 查看），确认当前用户是否有读权限；检查服务器磁盘空间是否已满。
• 传输中断：检查网络连接稳定性，或增加 SFTP 客户端的超时设置。

传输完成后，记得关闭临时的文件传输会话，并按公司安全规定清理本地不再需要的敏感文件副本。记录好“远程路径—本地目录—传输方式”的对应关系，方便下次快速操作。

6. 传输失败时按阶段排查