xshell上传文件夹 批量传输目录方法

要把一个包含多层子目录的文件夹传到服务器，最稳妥的方式不是逐个拖拽文件，而是利用 Xshell 联动 Xftp 的文件夹同步功能。这种方法能在传输前清晰对比本地与服务器端的差异，明确检查子目录甚至空目录是否保留，从而避免文件散落或层级混乱。

Xshell 联动 Xftp 进行文件夹批量上传的操作逻辑

下面以 Windows 版 Xshell 8 配合 Xftp 8 为主线，演示如何将本地 C:\UploadDemo\project-demo 完整上传到 Linux 服务器的 /home/demo/uploads/project-demo。请根据实际账号权限替换示例中的路径和文件名。前提条件是电脑已安装 Xftp，且服务器允许该账号使用 SFTP 协议。

1. 准备同一份示例目录

在 Windows 文件资源管理器中建立测试目录 C:\UploadDemo\project-demo。为了验证传输效果，放入一个 readme.txt，并在子文件夹 docs 中放入 notes.txt；同时建立一个空的 empty 文件夹，用于后续检查空目录是否被正确传输。

project-demo
  readme.txt
  docs
    notes.txt
  empty

在 readme.txt 中写入“目录上传检查”，notes.txt 中写入“子目录检查”，保存并关闭所有编辑器。上传过程中请勿修改这些文件，以免干扰同步比较的结果。

本例的目标是保留 project-demo 这一层目录结构。也就是说，远端最终路径应为 /home/demo/uploads/project-demo/readme.txt，而不是把文件直接散落在 uploads 根目录下。明确这一层级关系，能防止多套一层同名文件夹或文件错位。

1. 准备同一份示例目录

2. 从 Xshell 的当前 SSH 会话打开 Xftp

在 Xshell 中选中已经登录目标服务器的 SSH 会话，确认连接的是准备上传的主机。点击菜单栏【窗口（Window）】→【新建文件传输（New File Transfer）】，或直接点击工具栏上的绿色 Xftp 图标。

在 Xshell 中通过菜单启动 Xftp

这个操作会直接调用 Xftp 程序。由于当前 Xshell 会话基于 SSH，Xftp 会自动尝试使用 SFTP 协议连接，无需在终端中运行 rz 命令，也不依赖服务器安装 lrzsz 包。

如果提示找不到 Xftp，请先安装与 Xshell 版本匹配的官方 Xftp。连接时若弹出主机密钥指纹提示，请与管理员核对信息后再接受。若 SSH 终端能登录但 SFTP 连接失败，通常是因为服务器禁用了 SFTP 子系统或账号受限，此时应联系管理员核实，不要强行切换为不安全的 FTP 协议。

3. 将本地和远端都定位到 project-demo

在 Xftp 界面中，左侧窗格代表本地 Windows 文件，右侧窗格代表远程服务器文件。在左侧定位到 C:\UploadDemo\project-demo，确认能看到 readme.txt、docs 和 empty。

在右侧窗格定位到父目录 /home/demo/uploads。如果服务器上尚无 project-demo 文件夹，请在右侧空白处右击，选择【新建文件夹（New Folder）】，输入 project-demo 并进入该目录。若已有同名目录，请先查看内容，确认其为本次目标位置，避免误覆盖重要数据。

务必核对两侧当前路径：左侧已进入本地 project-demo，右侧已进入远端 project-demo。为确保二进制文件（如图片、压缩包）不被错误转换换行符，建议在【命令（Commands）】→【传输类型（Transfer Type）】中选择【二进制（Binary）】。

4. 比较子目录后，只向远端传输

确认左右两侧窗格均处于 project-demo 目录下后，点击工具栏上的【同步文件夹（Synchronize Folders）】按钮。

配置同步方向及包含子目录选项

在弹出的同步对话框中，再次核对【Left】和【Right】的路径。将【同步方向（Synchronization Direction）】设置为【Left to Right (Single)】，即从本地单向传输到远端。

点击【更多选项（More Options）】，务必勾选以下两项：

1. Include Subdirectories：确保递归处理 docs 等子目录。
2. Synchronize empty folders：确保 empty 这样的空文件夹也能被创建到服务器上。

点击【比较（Compare）】，系统会列出待传输的文件列表。首次上传时，应看到 readme.txt 和 docs/notes.txt 出现在列表中。确认无误后，点击【传输（Transfer）】开始执行。如果点击的是【队列（Queue）】，任务仅会加入列表，需手动在传输队列窗口中点击【全部恢复（Resume All）】才会开始传输。

注意不要选择【Mirror (Left Base)】镜像模式，该模式会删除远端存在但本地没有的文件，风险较高。单向传输虽不会删除远端额外文件，但若存在同名文件，仍会根据设置进行覆盖，操作前请仔细确认。

5. 检查整批状态和实际目录层级

传输开始后，观察 Xftp底部的传输队列窗口，关注文件状态从 Ready 变为 Transferring 最终到 Finished。

监控文件传输状态及处理异常

若有文件显示失败，右击任务选择【状态（Status）】查看具体错误原因，如权限不足或连接中断。处理问题后，可单独恢复失败任务，无需重新同步整个目录。

传输完成后，在右侧远端窗格刷新目录，确认 project-demo 下存在 readme.txt、docs 和 empty。进入 docs 检查 notes.txt 是否存在。同时检查是否出现了 project-demo/project-demo 的重复嵌套错误。

如需进一步验证内容，可将远端的文本文件下载到本地另一个临时文件夹，用记事本打开核对内容。确认无误后，即可保留本地源文件，后续更新时只需再次执行同步比较，即可高效增量上传。