PuTTY:展厅串口与SSH应急连接工具
- 分类
- 协议调试
- 平台
- Windows、Linux
- 许可证
- MIT
- 许可证说明
- 源码以 MIT 许可发布,官方仓库自建托管在 git.tartarus.org,不在 GitHub 一类平台上,取源码的方式是直接 git clone 官方地址,没有可供浏览的网页仓库界面,因此本页不填 repo 字段、不参与本站的版本自动跟踪。
- 是否开源
- 开源
- 收费模式
- 免费
- 适用工序
- 中控与协议、系统集成与交付、运维与商业
- 支持协议
- SSH、Telnet、串口、Rlogin
它到底解决什么
PuTTY 是一个自由软件性质的终端连接工具,官方给自己的定性很直白:一个 SSH 和 Telnet 的免费实现,外加一个终端窗口。翻译成工程话就是:它是一扇"命令行窗口",能连到远端设备或系统的调试口,让你在上面敲指令、看返回。
它能连的方式不止网络协议这一种。除了 SSH(加密的远程终端连接,展厅里最常见的是连播控主机、边缘计算盒子)、Telnet(比 SSH 更老的一种远程终端方式,不加密,一些老设备只支持这个)、Rlogin(更老的一种同类协议,现在基本只在个别老设备上才会遇到),它还能直接连本机的串口——也就是电脑上那个 USB 转出来的 COM 口。这一点很多人不知道,但对展厅工程来说恰恰是它最常被用到的地方。
这几种连接方式背后各自的协议原理、加密机制,本文不展开,站内已经有专门讲透的文章,本文只讲"拿它连上、连不上怎么查"这两件事,原理留给下一节的链接。
对展厅工程来说,PuTTY 的定位很清楚:它不是功能最全的那一个,是到处都有、体积最小、随便借一台电脑就能跑起来的那一个。现场设备一堆,各家协议五花八门,真正决定"这次调试能不能开工"的,往往不是工具功能强不强,而是它在不在、装不装得上。PuTTY 常年占着这个位置。
展厅哪道工序会用到它
矩阵、视频处理器、中控模块的调试口联调。 这类设备出厂大多留了一个 RS232 调试口,说明书上写着一串出厂参数和指令格式。设备到货、上柜前后,拿一根 USB 转串口线接上去,开个终端窗口手动敲几条指令核对返回,是最直接的验证方式——不用等中控程序写完,也不用依赖任何图形化上位机。
播控盒子、边缘计算盒子里跑的 Linux 系统。 这类设备在机柜里常年不接显示器和键盘,出了问题只能远程进去看。SSH 是这条路上最基本的一步:连进去看日志、改一行配置、重启一个服务,都靠这个窗口。
交换机的 Console 口初始化。 弱电间刚布完线,交换机还是出厂状态,没有管理 IP,网线连不上去,只能靠一根 Console 线接串口口,先把管理地址配出来,后面才谈得上用网页或者其它工具管理它。
老设备只开了 Telnet 的场合。 一些年头比较久的设备(老款视频矩阵、门禁一体机之类)压根没做 SSH,管理端口就只开了 Telnet 这一条路,遇到这种设备没得选。
以及一个不太写进方案但天天在用的场景:现场借甲方一台电脑救急。 自己的笔记本没带、或者电量告急,甲方工位上随便一台 Windows 电脑,PuTTY 单文件几百 KB,拷过去就能用,不用装、不用等安装向导跑完,这种时候它往往是唯一能立刻用上的东西。
怎么获取,该下哪个包
PuTTY 只有一个官方发布地址:https://www.chiark.greenend.org.uk/~sgtatham/putty/,作者本人在英国维护,页面朴素到几乎没有排版,但这恰恰是判断真伪的一个信号——官方从来没有花哨的落地页,也没有国内代理站、没有微信公众号、没有"中文官网"这回事。
这一点必须重点提醒:PuTTY 是国内假冒下载站的重灾区。 搜索引擎上搜"PuTTY 下载",排在前面的经常不是官方地址,而是各种打包了广告插件、甚至捆绑了恶意程序的第三方下载站,还有一些自称"官方中文版""功能增强整合包"之类的软件站——这类自我包装的说法一旦出现,基本可以断定不是官方渠道。真正的官方发布至今都是纯英文界面,官方也从没有发布过任何形式的中文本地化版本。
这件事在展厅工程机上尤其要紧,原因是两条叠加在一起:工程机常年在线,机柜里的机器往往一装好就是常年通电、几乎不重启;又装在甲方场地,网络环境是甲方的内网,机器上还留着能连接总线设备、连接播控主机的凭证和权限。如果这台机器上装的是从假冒下载站拿到的"PuTTY",捆绑的东西会跟着这台机器一起在甲方内网里长期潜伏——它不是装完用一次就删的临时工具,是常驻在工程机上的连接软件。一旦被甲方的 IT 安全巡查发现问题,追责追到的是负责部署这台机器的工程公司,这笔账不比一次线缆走线出错轻。所以但凡涉及要在甲方场地、要长期驻留的机器上装东西,官方地址这一条线不能省。
具体下哪个包,官方给了两条路:一条是安装包(MSI 格式),双击装完会把几个常用的配套小工具一起装上;另一条是单独下载 putty.exe 这一个可执行文件,不需要安装,双击就能跑。展厅救急场景更适合后者——拷进随身带的 U 盘工具箱,遇事直接拿出来用,不占安装时间,也不在借来的电脑上留下安装记录。架构上默认选 64 位版本即可,只有遇到特别老旧的 32 位系统或者少见的 ARM 架构设备时才需要挑对应版本。
最短可用路径
连串口
- 打开
putty.exe,在最上面的"Connection type"(连接类型)里,把默认选中的 SSH 改选成 Serial(串口)。 - 选完之后,原本填地址的那个输入框会变成"Serial line",填这台电脑上对应设备的串口号,比如
COM3——具体是哪个编号,去系统的设备管理器里查,能看到实际接的是哪一个。 - 旁边"Speed"框填波特率。现场设备的说明书上一般会写死这个数,照抄就行;实在找不到说明书,先按常见档位挨个试,9600、19200、38400、57600 这几档覆盖了大多数场合。
- 点"Open",弹出一个黑底窗口,这就是连接建立了。
- 如果窗口弹出来之后什么都没显示,先别急着断定没连上——不少设备是"你先出声它才理你"的类型,按几次回车试试,静默不代表没接通。
- 看到设备返回任何字符(哪怕暂时是乱码),就说明这条物理链路已经通了;如果是乱码,那是参数没对齐的问题,不是没连上,下一节和排错清单里都会讲怎么查。
连 SSH
- "Connection type"保持默认的 SSH 不用改。
- "Host Name"填目标设备的 IP 地址或域名,端口通常不用动,用默认的就行。
- 点"Open"。如果是第一次连这台设备,会弹出一条提示,说这是一台没见过的主机,后面跟着一长串字符——这是正常的身份确认提示,不是报错,核对一下要连的地址有没有敲错,确认没问题就点接受,以后再连同一台设备就不会再弹了。
- 输入用户名和密码(或者用密钥登录,视设备而定),进去看到命令行提示符,就是连上了。
展厅工程里真正要弄明白的那几件事
这一节不是操作手册的复述,是现场和售前真正用得上的几条判断。
串口连不上,先查这三件事
这是展厅现场出现频率最高的一类问题,而且大多数时候原因就在这三件事里,按顺序查能省下很多来回折腾的时间。
第一,串口号选错了。 一台电脑上插多个 USB 转串口设备,或者同一根线换了个 USB 口插,操作系统分配的 COM 口编号经常会变——原来是 COM3,换个口插上去可能变成 COM5。PuTTY 本身不会替你纠正这个,选错了口,表现跟设备完全没接是一样的。出问题先去系统的设备管理器里核对一遍实际编号,别凭记忆填。
第二,波特率、数据位、停止位、校验位没对齐。 这四个参数必须跟设备完全一致,差一个都连不上,或者连上了但收到的全是看不懂的乱码字符——这一点很容易被误判成"线坏了",其实只是参数没对上。波特率最常见的几档是 9600、19200、38400、57600;数据位常见 7 或 8;校验位常见"无""奇""偶"三种。设备说明书上一般会写死这几个值,照抄最省事;找不到说明书,就按常见组合挨个试,对上的那一刻乱码会立刻变成正常字符,非常好判断。
第三,转换头驱动或者线序问题。 现场常用的 USB 转串口线,插上电脑第一次要装驱动,新电脑第一次插经常识别不出来——设备管理器里压根看不到新增的 COM 口,就是这个原因,得先去装对应的驱动。另外,如果是自己接的转接头,收发线接反了也是现场高频的坑,表现跟参数不对很像,都是"连了但没反应",排查时可以放在参数核对之后再试。
会话保存,省的是重复劳动
现场设备一多,每次都从头填 IP、串口号、波特率,费时间还容易填错。PuTTY 支持把一套连接参数存成一个"会话":填好参数后回到 Session 面板,在左下角"Saved Sessions"框里给这次配置起个好认的名字(比如按位置和设备命名,"1F矩阵-COM3"这种),点 Save 保存。下次打开软件,双击这个名字就直接带着全部参数连上,不用重新填一遍。设备多的项目,把常连的那几台都存成会话,现场调试效率差得出来。
有一点要注意:串口类型的会话里存的是固定的 COM 口号,换根 USB 转串口线插到别的 USB 口上,系统重新分配的编号可能会变,存的会话反而连不上——这时候不是会话坏了,是编号变了,去设备管理器核对一下新编号,回到会话设置里改过来重新保存就行。
日志留存:一个实施人员很少主动用、但很有用的功能
PuTTY 能把整个终端窗口里出现过的内容原样记录成一个文件。操作路径是:在已经打开的窗口里,从窗口左上角的系统菜单选"Change Settings"(更改设置),进到 Logging(日志)面板,填一个日志文件的保存路径和名字,选一种记录模式(记录全部原始输出,还是只记录看得懂的文字,拿不准就选后者),点 Apply 就开始记录了;不再需要的时候,回到同一个面板把记录模式改回关闭,PuTTY 会正常关闭这个文件,之后就能放心打开来看。
这个功能容易被忽略,但对展厅工程有两个很实在的用处。一是排障留痕:现场设备间歇性掉线这种问题最难查,因为你不可能守在电脑前一整晚盯着屏幕。开着日志记录过夜,第二天回来翻记录,就能看到到底是几点几分中断的、中断之前设备最后吐出来的是什么内容,比"昨晚好像断过一次"这种口头描述靠谱得多。二是交付材料:设备验收或者系统联调阶段,把关键的一段通信日志导出来,附在验收记录里,比一句"已测试通过"更有说服力,也是出了争议时能拿出来的凭证。
串口连接不会自己挂断
这条容易被忽略,但值得单独说清楚:串口这种连接方式,没有一个明确的信号能让一头通知另一头"我这边要断了"。所以 PuTTY 在串口模式下,只要你不主动点窗口的关闭按钮,它就会一直保持"已连接"的状态,跟设备那头到底还在不在没关系。这跟 SSH、Telnet 不一样——那两种如果远端主动断开,PuTTY 这边通常也会跟着退出。带来的实际影响是:现场调试完顺手把窗口最小化、没有真正关掉,串口窗口会一直占着那个 COM 口,下次再想用同一个口连接(哪怕是同一台设备)会报口被占用;这也是排错清单里那一条"COM 口选不到"的常见成因之一。
踩坑与排错清单
| 现象 | 原因 | 处置 |
|---|---|---|
| 串口窗口打开后一片空白,敲键盘也没反应 | 参数没对齐,或设备没上电、没进入待命状态 | 先核对波特率等参数是否与说明书一致,确认设备通电,按几次回车试探 |
| 收到的字符全是乱码或方块 | 波特率不匹配是最常见的原因,不是编码或字体问题 | 挨个试常见档位(9600/19200/38400/57600),对上瞬间乱码会变成正常字符 |
| 设备管理器里能看到 COM 口,PuTTY 里连不上或提示占用 | 该口被另一个还开着的串口窗口或调试软件占用 | 关掉占用的程序,或者检查是不是自己有个 PuTTY 窗口一直没真正关掉 |
| 换了根 USB 转串口线,原来保存的会话连不上 | 换个 USB 口插入后,系统分配的 COM 口编号变了 | 去设备管理器核对新编号,回到会话设置里改过来并重新保存 |
| SSH 第一次连提示一长串陌生字符,看着像报错 | 这是正常的首次连接身份确认提示,不是故障 | 核对目标 IP 是否填对,确认无误后接受即可,之后不会再弹 |
| 只能用 Telnet 连,SSH 连不上 | 部分老设备、老交换机压根没实现 SSH,只开了 Telnet | 确认设备手册的管理方式,把 Connection type 改选 Telnet |
| 现场敲了几行指令,选中文字想再粘贴一次却没反应 | PuTTY 的复制粘贴靠鼠标:左键拖拽选中即复制,右键点一下才是粘贴,跟其它软件的 Ctrl+C/V 习惯不一样 | 改用鼠标操作,或先适应这个反直觉的默认设置 |
| 用 Close 按钮直接关掉了 SSH 会话窗口,设备那头状态异常 | 直接关窗口对远端来说等于连接被硬中断,跟正常注销不是一回事 | 能进命令行的话优先在设备那端敲登出命令退出,逼不得已再用关闭按钮 |
什么时候别用它
同时要管十几台设备、需要在多个连接之间频繁切换查看的场合,PuTTY 会显得吃力——它的每个连接都是一个独立窗口,没有统一的标签栏,也没有分组管理,设备一多,桌面上全是叠在一起的黑窗口,找起来比在标签页里点一下麻烦得多。这种规模的场合,该考虑功能更全的同类工具,本站的MobaXterm条目值得看一看。
需要图形化拖拽传文件的场合也不合适。PuTTY 本体只是一个终端窗口,不带任何文件传输的图形界面,传文件得靠额外的命令行工具,对不熟悉命令行的实施人员不友好,这种需求同样该考虑功能更全的工具。
需要图形化操作、能看到桌面图标和窗口的远程场合,PuTTY 帮不上忙——它从头到尾只做纯文本终端,设备本身要靠图形界面才能配置的话,这条路走不通,得用远程桌面或者 VNC 一类的工具。
团队协作、需要把常用设备清单同步给同事、留存多人操作历史的场合,也不该指望它——已保存的会话只是这台电脑本地的一份平铺列表,没有云端同步,换一台电脑就得重新填一遍。
与本站的衔接
- 串口的电气原理、DB9 引脚定义、RS232 与 RS485 的差异,以及 A/B 接反怎么排查,看RS232 与 RS485 串口控制速查与实战,这一篇把本文没展开的电气层面讲透了。
- SSH 的分层架构、口令与密钥两种认证方式,看SSH 安全远程控制入门。
- Telnet 的协议细节和明文传输的安全风险,看Telnet 远程控制协议速查。
- 展厅机柜的远程接管整体方案、各类远程工具的取舍思路,见远程运维专题。
- 中控系统的整体架构和协议选型,见中控专题。
- 想把协议调试这条线系统地学一遍,从教程体系进去。
调试期试通的指令,能不能变成资产
调试工具帮你把每一条指令试通,但展厅真正的成本在交付之后:几十台设备、上百条指令、开闭馆时序、异常重试与告警,这些靠手动工具堆不出来。
企服君中控 SoftControl 承接的是这一段:调试期试通的指令沉淀成可复用的设备驱动,新项目只做界面编排。对每年交付多个展厅的集成商来说,这部分复用是可以量化的——见集成商年费方案。
出处
本文事实依据来自 PuTTY 官方网站公开材料:官网首页(https://www.chiark.greenend.org.uk/~sgtatham/putty/)、FAQ 页面、Licence 页面、最新版本下载页面(latest.html)、文档索引页(docs.html),以及官方在线手册 Chapter 2《Getting started with PuTTY》、Chapter 3《Using PuTTY》(含 3.2 会话日志、3.6 本地串口连接)、Chapter 4《Configuring PuTTY》(含 4.1 Session 面板的会话保存、4.29 Serial 面板的串口参数说明)。功能边界与操作步骤以官方最新文档为准,本文不涉及版本号与发布日期等易变信息。
本文为公开资料整理,非亲测。关键参数与代码请结合实物与下列官方来源验证。
留言讨论
评论发布后会被人工复核,违规内容将被删除。
如果发表没有反应,可以前往联系我们告诉我们。