02 会话管理与连接

WxTerm 支持 9 种连接协议。本章介绍如何通过会话管理器组织会话、使用快速连接临时连接、以及新建/编辑会话时各协议的配置项。

2.1 支持的协议一览

协议	用途	默认端口	认证方式
SSH	远程登录、SFTP、端口转发、X11	22	密码 / 私钥 / SSH Agent
Telnet	传统远程登录	23	无
Serial	串口设备通信	—	无
Local	本地终端	—	系统用户
TCP	原始 TCP 连接（客户端/服务端）	自定义	无
UDP	UDP 通信	自定义	无
WebSocket	WebSocket / WSS 连接	80 / 443	无 / TLS 证书
VNC	远程桌面（VNC 协议）	5900	密码
RDP	远程桌面（RDP 协议）	3389	用户名 + 密码

2.2 会话管理器（Session Sidebar）

会话管理器位于主窗口左侧，以树形结构组织会话。

界面元素

• 搜索框：顶部输入框，实时过滤会话名称与主机。
• 会话树：文件夹（📁）与会话（按协议显示不同图标）的树形列表。
  • 已连接的会话显示绿色连接标记。
  • 本地终端会话有专属图标。
• 工具按钮：底部提供新建会话、新建文件夹、快速连接等快捷按钮。

右键菜单

在空白处右键

• 新建文件夹
• 新建会话
• 快速连接
• 导入配置
• 导出配置
• 刷新

在文件夹上右键

• 新建文件夹（子文件夹）
• 新建会话
• 重命名
• 删除
• 导出（导出该文件夹下所有会话）

在会话上右键

• 连接
• 编辑
• 复制（创建副本）
• 删除
• 导出

拖拽组织

• 拖动会话到文件夹可移动该会话。
• 拖动会话到另一会话上方可调整顺序。
• 拖动文件夹可调整文件夹顺序。

导入与导出

• 导出：将选中的会话/文件夹导出为 .json 配置文件，便于备份或分享。
• 导入：从 .json 文件导入会话，可选择导入到根目录或指定文件夹。

导出的会话配置中密码已加密，但私钥文件本身不会被打包，需另行备份。

2.3 快速连接（Quick Connect）

快速连接用于临时连接一个主机，不会保存到会话管理器。适合一次性访问或调试。

打开方式

• 菜单「文件 → 快速连接」
• 工具栏「快速连接」按钮
• 欢迎屏「快速连接」卡片
• 快捷键 Ctrl+Q

配置项

字段	适用协议	说明
协议	全部	选择连接类型，切换后表单字段自动变化
主机	SSH/Telnet/TCP/UDP/WS/VNC/RDP	远程主机地址（IP 或域名）
端口	SSH/Telnet/TCP/UDP/WS/VNC/RDP	端口号，切换协议时自动填默认值
用户名	SSH	登录用户名
认证方式	SSH	密码 / 私钥 / SSH Agent
密码	SSH/VNC	登录密码（VNC 为连接密码）
私钥文件	SSH（私钥认证）	本地私钥路径
私钥口令	SSH（私钥认证）	私钥的 passphrase
串口设备	Serial	如 /dev/ttyUSB0（Linux）或 COM3（Windows）
波特率	Serial	300 ~ 921600，常用 115200
数据位	Serial	5 / 6 / 7 / 8
停止位	Serial	1 / 1.5 / 2
校验位	Serial	None / Odd / Even / Mark / Space
流控	Serial	串口流控方式
UDP 本地地址	UDP	监听的本地地址，默认 0.0.0.0
UDP 本地端口	UDP	监听的本地端口，0 表示随机
WebSocket 路径	WebSocket	如 /ws，默认 /
WebSocket 类型	WebSocket	ws（明文）或 wss（TLS）
跳过证书验证	WebSocket（wss）	自签名证书时勾选
RDP 用户名/密码	RDP	远程桌面登录凭据
RDP 域名	RDP	Active Directory 域名（可选）

填写完成后点击「连接」即可建立连接并打开新标签页。

2.4 新建/编辑会话（Session Edit Dialog）

新建会话与编辑会话使用同一个对话框，区别仅在于标题与是否显示「名称」「文件夹」字段。

打开方式

• 菜单「文件 → 新建会话」或 Ctrl+N
• 会话侧栏右键「新建会话」/「编辑」
• 工具栏「新建会话」按钮

通用字段

字段	说明
会话名称	显示在会话侧栏与标签页的名称
协议	选择连接类型
文件夹	选择保存到哪个文件夹（可新建文件夹）
主机 / 端口	远程主机地址与端口
编码	终端字符编码，默认 UTF-8，可选 GBK/GB2312/GB18030/Big5/Shift_JIS/EUC-JP/EUC-KR/ISO-8859-1/Windows-1252

SSH 专属字段

字段	说明
用户名	SSH 登录用户名
认证方式	密码 / 私钥 / SSH Agent
密码	密码认证时的密码（加密存储）
私钥文件	私钥认证时的本地私钥路径，可从密钥管理器选择
私钥口令	私钥的 passphrase（加密存储）

若服务器使用 PAM 键盘交互认证（拒绝普通 password 方法），WxTerm 会自动回退到 keyboard-interactive 认证方式。

Serial 专属字段

字段	说明
设备	串口设备路径
波特率	300 ~ 921600
数据位	5 / 6 / 7 / 8
停止位	1 / 1.5 / 2
校验位	None / Odd / Even
传输方向	串口文件传输的默认目录

TCP 专属字段

字段	说明
连接类型	TCP Client（主动连接）/ TCP Server（监听等待连接）

UDP 专属字段

字段	说明
本地地址	监听地址，默认 0.0.0.0
本地端口	监听端口，0 表示随机分配

WebSocket 专属字段

字段	说明
路径	WebSocket 路径，默认 /
类型	ws（明文）或 wss（TLS）
跳过证书验证	wss 时是否跳过 TLS 证书校验
CA 证书	wss 自签名 CA 证书路径
客户端证书	wss 双向认证的客户端证书
客户端密钥	wss 双向认证的客户端私钥

VNC 专属字段

字段	说明
密码	VNC 连接密码

RDP 专属字段

字段	说明
用户名 / 密码	RDP 登录凭据（密码加密存储）
域名	Active Directory 域名（可选）
分辨率	1920×1080 / 1280×720 / 1024×768 / 800×600 / 自定义
自定义宽高	选择「自定义」分辨率时填写
颜色深度	8-bit / 16-bit / 24-bit / 32-bit
全屏启动	连接后立即进入全屏模式
重定向剪贴板	启用本地与远程剪贴板同步
重定向打印机	将本地打印机映射到远程
重定向智能卡	将本地智能卡映射到远程
重定向音频	将远程音频重定向到本地
驱动器映射	将本地目录映射为远程驱动器（见下表）

RDP 驱动器映射

可将本地一个或多个目录映射为远程 Windows 的网络驱动器，实现双向文件访问。

字段	说明
驱动器名称	远程显示的驱动器名
本地路径	本地目录的绝对路径

点击「添加驱动器」可新增映射，「删除」移除选中映射。

RDP 驱动器映射需要远程 Windows 启用 RDPDR（重定向驱动器）支持。

日志记录

所有协议的会话均支持终端日志记录：

字段	说明
启用日志	开启后会将终端输出写入日志文件
日志路径	日志文件保存目录，留空则使用默认配置目录下的 logs 子目录（位置见 01 入门与界面概览）

保存与连接

对话框底部提供两个按钮：

• 保存：保存会话到会话管理器，不立即连接。
• 保存并连接：保存会话并立即建立连接。

2.5 连接与断开

连接

• 在会话侧栏双击会话节点。
• 右键会话 →「连接」。
• 编辑会话对话框 →「保存并连接」。

断开

• 菜单「文件 → 断开」。
• 工具栏「断开」按钮。
• 标签页右键 →「断开」。
• 在远程执行 exit / logout 登出后，WxTerm 会自动断开并关闭对应标签页。

重新连接

• 工具栏「重新连接」按钮。
• 标签页右键 →「重新连接」。

认证失败重试

当 SSH 连接因认证失败（密码错误、密钥错误、Agent 失败等）时，WxTerm 会弹出认证重试对话框，允许用户重新输入凭据后重连，无需重新打开新建会话对话框。

重试对话框中可重新选择认证方式并输入新的密码/私钥，确认后会自动重新连接。成功后新的凭据会同步到云端（若已开启云同步）。

2.6 会话侧栏搜索

在会话侧栏顶部的搜索框输入关键字，会实时过滤显示名称或主机包含该关键字的会话。搜索状态下文件夹结构会被扁平化显示匹配的会话。

2.7 多会话同时连接

WxTerm 支持同时打开多个会话（受套餐标签页上限限制，详见 13 版本功能矩阵）：

• 每个会话在独立的标签页中运行。
• SSH 会话可共享同一主机的多个连接（SFTP、端口转发等会复用连接）。
• 当同一 SSH 主机的所有标签页关闭后，关联的端口转发、X11 转发、Agent 转发会自动停止。