Xshell会话日志保存教程：如何录制终端输出并自动存档

在Xshell中保存会话输出，核心是使用“日志”功能。它会将终端屏幕上显示的文字实时写入本地文件，方便事后回顾操作步骤或排查问题。需要明确的是，这记录的是“显示内容”，而非服务器上配置文件的原始二进制数据；若需备份服务器配置原件，应使用文件传输工具下载原文件。

下面以Windows版Xshell为例，演示如何在已有会话中记录一段测试输出，并将其保存到本地指定文件夹。

Xshell主界面，鼠标选中特定的会话标签，准备开始日志记录

1. 准备记录环境与选中会话

首先在Windows资源管理器中建立一个专用文件夹，例如“D:\XshellLogs”，用于集中存放日志文件。回到Xshell主界面，点击选中需要记录的会话标签。务必核对标签对应的目标主机，避免在多标签工作时将日志记错对象。

日志记录从启动时刻开始，此前已经滚动出屏幕的历史内容不会被补录。因此，建议在需要保留的关键操作开始前启动日志。为验证效果，本例将使用一段无敏感信息的测试文字，正式工作中请根据合规要求处理包含业务数据的日志。

1. 准备记录环境与选中会话

2. 手动启动日志记录

在当前会话窗口中，点击顶部菜单栏的【文件】，选择【日志】，然后点击【开始】。如果是英文界面，路径为 File > Log > Start。

系统会弹出“另存为”对话框。定位到之前建立的“XshellLogs”文件夹，将文件命名为“session-check-01.log”。建议每次记录使用新文件名或带时间戳的名称，避免覆盖旧数据。

点击文件菜单下的日志开始选项，弹出保存对话框

在保存前，注意查看对话框中的选项。如果只需阅读纯文本内容，建议取消勾选“包含终端控制代码”或类似选项。控制代码主要用于终端颜色和高亮显示，开启后会导致日志文件中出现大量乱码字符，不利于直接查看。

保存成功后，日志记录即已开始。此时在终端中输入以下测试命令（适用于Linux环境），以便后续验证日志完整性：

printf 'LOG_CHECK_START\n'
pwd
printf 'LOG_CHECK_END\n'

这些命令仅用于生成易于识别的标记，实际环境中可替换为任何无敏感信息的查看操作。

3. 停止记录并验证文件

完成需要记录的操作后，再次进入【文件】>【日志】>【停止】。停止日志不会断开会话连接，你可以继续使用终端。主动停止有助于明确日志的时间范围。

打开Windows中的“XshellLogs”文件夹，用记事本或代码编辑器打开“session-check-01.log”。搜索“LOG_CHECK_START”和“LOG_CHECK_END”，确认两者之间包含了你刚才执行的命令及返回结果。

如果文件为空或内容缺失，请检查启动日志时是否选对了会话标签，以及保存路径是否正确。若发现中文显示为乱码，需核对Xshell会话的字符编码设置（通常为UTF-8）与查看器编码是否一致。

4. 设置连接后自动记录

对于需要长期审计或频繁回溯的会话，可以设置自动日志。右键点击会话列表中的目标会话，选择【属性】。在左侧类别中找到【高级】下的【日志记录】（Logging）。

勾选“连接时开始日志记录”选项，并指定保存目录和文件名规则。Xshell支持变量命名，如添加时间戳，以防止多次连接覆盖同一文件。

在会话属性的高级选项中启用自动日志记录

保存属性后，重新连接该会话并执行少量操作，检查指定目录下是否自动生成了新的日志文件。注意检查文件命名策略，确保新日志不会静默覆盖重要的历史记录。

5. 区分日志、脚本与配置备份

最后需明确概念边界：Xshell的“日志”记录的是屏幕输出；“脚本录制”生成的是可重复执行的自动化指令；而“配置备份”指的是服务器上的文件原件。

如果需要保存服务器的配置文件（如nginx.conf），不能依赖终端日志，因为分页、截断或终端宽度限制可能导致内容不全。应使用Xftp等工具直接下载原文件，并校验其完整性。会话本身的连接参数（如IP、端口）则通过Xshell的【导出】功能进行备份。

通过导出功能备份会话连接参数

完成上述步骤后，保留好本地日志文件及对应的操作说明，即完成了本次会话日志的保存工作。