TermX 使用说明

绿色免安装 · 零外部依赖 · 不写注册表 · 运行目录由用户指定(除该目录外不创建任何文件夹)

一、怎么用

  1. 把 TermX_绿色免安装包.zip 解压到任意目录(U 盘也可以)。
  2. 双击 TermX/TermX.exe 即可运行,无需安装、无需联网、无需下载任何组件。
  3. 想换电脑:直接把整个 TermX 目录拷走即可;会话/配置/日志统一保存在 D:\TermX,换机自动沿用。
运行目录策略:首次运行时由用户选择数据保存位置(默认建议 D:\TermX),之后可在 全局选项 → 常规 → 运行目录 随时修改;除该目录外,软件不会在任何其他位置创建文件夹。覆盖安装时可选「关联已有数据目录」,目标已有文件优先保留、缺失文件自动迁入,会话与配置无缝沿用。命令行可用 TermX.exe --data-dir-set 路径 指定(留空恢复自动)。

二、目录结构

TermX/
  TermX.exe                 主程序(启动约 0.6 秒)
  TermX_Bin/                ★ 全部外部组件,已随包携带
    openssh/                OpenSSH 9.5p1:ssh / scp / sftp / ssh-keygen /
                            ssh-add / ssh-agent / ssh-keyscan 等
    runtime/                VC++ 运行库:msvcp140 / vcruntime140 / ...
    ssh1/                   plink 0.67(SSH-1 协议客户端)
    x11/                    便携 X Server(VcXsrv),X11 转发时自动启动
    fonts/                  开源等宽字体(私有加载,不写系统字体表)

运行目录(用户指定)/        用户数据(首次运行弹窗选择,默认建议 D:\TermX)
  settings.json             全局选项(含运行目录设置)
  sessions.json             会话库
  accounts.json             账号库(名称/用户名/DPAPI 加密密码,v1.4.6 新增)
  device_templates.json     (随 settings.json 保存)自建设备模板
  ssh/config                SSH 配置(自动 Include 用户已有 ~/.ssh/config)
  ssh/known_hosts           主机指纹
  keys/                     生成的密钥对
  downloads/                Zmodem / SFTP 接收文件
  logs/  scripts/           日志与脚本

三、「不需要下载任何东西」具体指什么

功能以前依赖现在
SSH / SFTP / SCP系统自带 OpenSSH随包 TermX_Bin/openssh
SSH 运行库VC++ Redistributable随包 TermX_Bin/runtime
SSH-1需另找支持 SSH1 的客户端随包 plink 0.67
X11 转发需另装 VcXsrv / Xming随包 X Server,勾选 -X 自动拉起
Zmodem 收发本地 rz.exe / sz.exe软件内置纯 Python 协议栈
VBScript/JScript系统 WSH (cscript)软件内置脚本引擎(可切回 WSH)
Telnet/Rlogin/Raw/串口—纯 Python / Win32 实现
终端仿真/界面Python + Tcl/Tk已静态打进 exe
字体系统字体随包字体,缺省自动注册

仍然属于「操作系统本身」、不属于外部组件的:

四、常用操作

Ctrl+T            快速连接 / 新建会话(分组支持模糊查询,输入新分组名自动创建)
左侧会话树双击     打开已保存会话(保存过密码的会话自动登录,无需重复输入)
左侧会话树拖拽     拖动会话到分组调整归属(拖动过程中目标行实时高亮)
F11               批量下发脚本(按分组筛选/全选、变量替换、并发、Excel 导入设备、结果导出)
F10               脚本编辑器(Python / VBScript / JScript / 命令脚本)
                  · 设备模板:内置华为/华三/锐捷/思科模板,全部模板均支持新建/重命名/删除
                  · 保存模板(v1.4.7):选中模板后改脚本内容,点它即可写回该模板
                  · 运行目标:可选具体会话、按分组多选、全部会话,或输入网段(如 10.36.36.0/24)
文件传输窗口       scp 上传下载、交互式 SFTP 标签、Zmodem 上传
全局选项 → SSH    可指定自己的 ssh.exe;默认 auto = 用随包内置版本
全局选项 → 自动化  VBScript/JScript 引擎:builtin(内置) / wsh(系统)
查看 → 界面主题    6 套主题单选,切换即时生效
 F9 / 查看 → 切换主题  卡片式主题选择器,点一张卡片就换肤(可连续对比)
鼠标滚轮          终端区域或右侧滚动条上滚动 = 逐行回滚(v1.4.10)
Ctrl+Home/End     回到最早历史 / 回到底部;PgUp/PgDn 翻页
自定义(高亮/按钮栏/宏/键位)窗口内置「使用说明」页,含每个功能的详细设置教程

串口连接

Ctrl+T 打开快速连接,协议选 Serial,表单切换为专用串口界面:串口(COM) / 波特率 / 数据位 / 校验位 / 停止位 / 流控 / 编码,另有「检测串口」按钮自动枚举本机 COM 口。也可在会话属性 →「串口」页为已保存会话配置同样参数。串口由内置 Win32 驱动直接打开(CreateFileW + DCB),支持 COM1-COM32;USB 转串口只要系统装好芯片驱动、设备管理器里出现 COM 编号即可用。

老旧网络设备(ssh-rsa 主机密钥)

连接部分老交换机/路由器时,若终端显示 Unable to negotiate ... no matching host key type found. Their offer: ssh-rsa,是 OpenSSH 8.8+ 默认禁用了 SHA-1 签名的 ssh-rsa。v1.4.9 起默认开启「全局选项 → SSH → 兼容老旧设备算法」,用 + 追加 ssh-rsa 主机密钥、SHA-1 KEX 与 CBC 加密(不是覆盖默认列表,现代设备仍优先 ed25519 / rsa-sha2,安全性不降低),SSH / SFTP / SCP 同时生效。若只想用现代算法,可在该选项关闭。

会话标签

标签默认左对齐;会话数量多时自动压缩标题宽度保证全部可见,拉宽窗口或关闭标签后自动恢复完整名称。每个标签右侧有独立的 × 关闭按钮。

账号库(v1.4.6)

工具 → 账号管理 可添加 / 编辑 / 删除账号:每个账号包含名称、用户名和密码,密码用 Windows DPAPI 加密保存在运行目录 accounts.json(添加时必须填账号和密码;编辑时密码留空表示不修改)。共有三处可以直接调用账号:

下拉旁均有「管理账号...」按钮,可在不关闭当前窗口的情况下增删改账号并即时刷新列表。

模板、账号、会话等设置都会立即写入运行目录。若运行目录被删除、移动或没有写入权限,保存时会弹出明确错误提示并可直接重新选择运行目录(不再出现「提示已保存、重启却丢失」的静默失败)。用 TermX.exe --data-dir 可查看当前运行目录。

回滚查看历史(v1.4.10)

鼠标滚轮在终端区域或右侧滚动条上都能逐行回滚,向上 = 更早的输出;拖动右侧滚动条滑块可直接跳到任意位置,拖到底部 = 回到最新输出。快捷键:Ctrl+Home 回到最早历史、Ctrl+End 回到底部、PgUp/PgDn 翻页,标签右键还有「滚到底部」。

v1.4.10 修正了滚动条滑块位置与拖动反算不一致的问题(此前拖动会跳行、甚至看起来完全滚不动),并给右侧滚动条补上了滚轮绑定;查看历史期间新输出不会把画面拉走。程序开启鼠标模式(vim / less 等全屏程序)时,滚轮默认仍优先回滚;若要让滚轮交给程序翻页,可在 全局选项 → 外观 关闭「鼠标滚轮优先回滚」。

左侧时间戳与行号(v1.4.10 引入,v1.4.11 语义修正)

终端左侧显示 [HH:MM:SS] 时间戳与全局递增行号:时间 = 执行这一行命令的时刻(同一条命令的命令行与它的输出行共用同一时刻),行号随输出全局递增,当前所在行高亮显示;回滚查看历史时,行号与时间跟着一起回滚,方便对照日志定位。可在 全局选项 → 外观 关闭「终端左侧显示时间戳与行号」。

v1.4.11 修正了两处语义:① Windows ConPTY 采用整屏重绘模式,PowerShell 每输出一行都会把整个屏幕重写一遍,此前按「内容变化即刷新时间」处理,导致屏幕上几十行的时间戳全部变成同一时刻;现改为时间戳只在「该行第一次产生内容」时确定,之后永不因重绘而刷新。② 没有任何内容的空白行整行留空(只保留一条竖线对齐),不显示行号与时间;行号在内部保持稳定,擦除后重写不会乱跳。行号栏只在真正执行过命令后才出现——刚打开终端、还没有任何命令时左侧不再是一片无意义的占位序号,清屏后同样不再残留旧行号。

五、自检(不需要联网)

在 TermX.exe 所在目录打开命令行:

TermX.exe --selftest --out 自检结果.txt
TermX.exe --smoke    --out 冒烟结果.txt     (会短暂弹出窗口再自动关闭)

自检包含「内置组件清单」与「隔离 PATH 下 OpenSSH 独立运行」两项,后者会在完全排除系统 OpenSSH 的环境里运行随包 ssh.exe -V 验证。

六、两个版本怎么选

两个版本都不写注册表,不需要 .NET / VC++ 运行库 / Python / OpenSSH / X Server / WSH 的任何系统安装。

七、注意事项

陕ICP备2022004754号-4
公安备案图标陕公网安备61012402000320号