TermX 使用说明
绿色免安装 · 零外部依赖 · 不写注册表 · 运行目录由用户指定(除该目录外不创建任何文件夹)
一、怎么用
- 把
TermX_绿色免安装包.zip解压到任意目录(U 盘也可以)。 - 双击
TermX/TermX.exe即可运行,无需安装、无需联网、无需下载任何组件。 - 想换电脑:直接把整个 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 |
| 字体 | 系统字体 | 随包字体,缺省自动注册 |
仍然属于「操作系统本身」、不属于外部组件的:
- ConPTY / DPAPI / Win32 API(Windows 10 1809+ 内核提供)
- 本地 Shell 标签使用的 cmd.exe / PowerShell(就是操作本机自身)
- 远端 Linux 上的 rz/sz 命令(Zmodem 是双端协议,对端必须有发送方)
四、常用操作
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(添加时必须填账号和密码;编辑时密码留空表示不修改)。共有三处可以直接调用账号:
- 新建会话 / 会话属性:「连接」页顶部新增「账号(选择)」下拉,选中后自动填入用户名和密码;保存会话后自动登录直接生效。
- 快速连接:表单顶部同样有账号下拉(串口 / 本地 Shell 不显示),选中即填好凭据,点「连接」即可。
- 登录时:标签右键 →「选择账号登录...」(或工具菜单同名项),选账号后立即应答屏幕上当前的
login:/Password:提示,并接管后续提示(含 sudo 二次密码);凭据同时写回会话,下次连接自动使用。
下拉旁均有「管理账号...」按钮,可在不关闭当前窗口的情况下增删改账号并即时刷新列表。
模板、账号、会话等设置都会立即写入运行目录。若运行目录被删除、移动或没有写入权限,保存时会弹出明确错误提示并可直接重新选择运行目录(不再出现「提示已保存、重启却丢失」的静默失败)。用 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 验证。
六、两个版本怎么选
- 绿色免安装包 .zip(推荐):解压后是一个完整目录,TermX_Bin/ 里 5 组组件齐全(含 89 MB 的完整 VcXsrv 字体与键盘数据)。双击即用,冷启动约 0.6 秒。
- 单文件版 .exe(备用):同样的组件压进一个约 70 MB 的 exe,方便放 U 盘或发给同事;代价是每次启动都要把约 100 MB 组件展开到临时目录,实测冷启动约 25 秒。日常使用请用目录版,单文件版只适合偶尔分发。
两个版本都不写注册表,不需要 .NET / VC++ 运行库 / Python / OpenSSH / X Server / WSH 的任何系统安装。
七、注意事项
- SSH-1 是已废弃的不安全协议,仅在对接老旧设备时使用;PuTTY 私钥需 .ppk 格式。
- X11 转发首次启用会自动启动随包 X Server(任务栏托盘图标),关闭会话不会强制结束它;若系统已有 X Server 在 6000 端口则直接复用。防火墙首次弹窗选「允许访问」(仅本机回环显示用)。X Server 以 -ac 启动以便 ssh -X 直接连接;在不可信网络环境建议不用 X11。
- 生成 SSH 密钥默认落在 D:\TermX\keys,不污染用户 .ssh 目录。
- 内置 VBScript/JScript 引擎覆盖 SecureCRT 常用语法与 crt API;极冷门语言特性可在全局选项切到系统 WSH 引擎执行。
- 请勿删除 TermX_Bin 目录,删除后 SSH/X11/SSH-1 功能将不可用。
- 个别电脑若曾遇到启动报「Item s:xxx already exists」,是旧版本 sessions.json 里存在重复会话 ID;v1.4.8 起启动时会自动去重修复并写回,无需手工删除数据文件。
陕公网安备61012402000320号