Xshell日志自动保存与会话记录方法

你是否也遇到过这种情况：Xshell 连上服务器一顿操作猛如虎，第二天想复盘时，却发现忘了手动点击“开始记录”，关键命令全部丢失？或者日志文件打开后忘记关闭，体积膨胀到几个 G，打开都异常卡顿？实际上，只需一次配置，即可让 Xshell 每次连接时自动将所有命令和返回结果保存为文件，既省心又安全。

以下分几个步骤详细说明，从单个会话到全局默认设置，再到手动应急和验证，一次完成配置。

设置单个会话自动记录日志

右键点击已保存的会话，选择【属性】。

在左侧导航栏点击【终端】→【高级】→【日志记录】。

勾选【连接时开始日志记录】，此时下方的控件全部变为可设置状态。

在“日志文件”区域，选择“使用以下文件”，然后输入路径和带变量的文件名，例如：D:\Xshell_Logs\%n_%d_%t.log。其中 %n 代表会话名，%d 代表日期（YYYYMMDD 格式），%t 代表时间（HHMMSS）。这样每次连接都会生成独一无二的文件名，不会互相覆盖。

务必勾选【覆盖已存在的文件】——否则同一时间重连时，Xshell 会弹出提示“文件已存在，是否覆盖？”，导致连接流程中断，非常不便。

全局默认自动记录（所有新会话生效）

通过菜单栏操作：工具 → 选项 → 全局选项 → 默认会话 → 编辑默认设置。

左侧点击【日志记录】，勾选【连接时开始日志记录】。

设置日志路径，推荐使用：E:\Xshell_Default_Logs\%S_%Y%M%D_%h%m%s.log。%S 表示会话名，%Y%M%D 表示年月日，%h%m%s 表示时分秒，比基础变量更直观，便于快速识别每次操作。

编码必须设置为Unicode (UTF-8)，否则中文命令或报错信息会变成乱码，后期搜索关键字将无法进行。

手动启动/停止当前会话日志（应急补救）

方法一：顶部菜单栏 → 文件 → 日志记录 → 开始（或停止）。

方法二：在会话窗口空白处右键 → 日志 → 启动（或停止）。

此操作仅对当前已连接的会话生效，不会修改会话属性。适合临时需要记录某次调试过程——例如突然想捕获一个操作步骤，又不想改动全局配置。

注意：如果该会话已配置自动记录，菜单中的“启动”项会变为灰色不可点击。这属于正常现象，说明日志已经在后台自动运行。

验证与查看日志文件

① 连接目标服务器后，立即打开设定的日志路径，检查对应的 .log 文件是否已经生成，并且文件大小会随着命令执行而增长。

② 在 Xshell 中执行一条简单命令，例如 pwd，然后立刻在日志文件中搜索该字符串，确认内容是实时写入的，没有延迟。

③ 查看大日志文件时，不要双击用记事本打开——文件过大会直接卡死。直接在 Xshell 中运行：tail -n 200 "D:\Xshell_Logs\test_20260530_172401.log"，快速读取末尾 200 行，效率更高。

最后，需要高度警惕：敏感操作（如输入密码、密钥内容）一旦被记录，日志文件中就会包含高危信息。【切勿将日志目录设置在共享盘或上传至公共平台】。安全无小事，日志文件同样需要妥善保护。