RustConn自动化实战:Expect规则、按键序列与.rsc脚本实现完全无人值守操作
RustConn自动化实战:Expect规则、按键序列与.rsc脚本实现完全无人值守操作
RustConn 是一款现代跨平台连接管理器,内置 Expect 规则、按键序列 与 .rsc 脚本 三大自动化能力,配合前置/后置任务,能让 SSH、Telnet、Serial 等会话在登录、sudo 提权、菜单选择等环节完全无人值守。本文带你从零理解这三类工具各自解决什么问题、如何配置,以及它们如何组合成一套稳定的自动化流水线。
三大自动化武器:各管一段
| 工具 | 触发时机 | 适合场景 |
|---|---|---|
| Expect 规则 | 终端出现特定文本时 | 自动回答 password:、sudo 提示、菜单选择 |
| 按键序列 | 连接建立后一次性执行 | 登录后立即执行固定命令、翻页、方向键操作 |
| .rsc 脚本 | 会话启动后持续运行 | 多步交互:等待输出、捕获文本、分支判断、管理会话 |
| 前/后置任务 | 连接前 / 断开后 | 开 VPN、加载 SSH key、断开会话后收尾 |
它们分别实现在 rustconn-core/src/automation/expect.rs、rustconn-core/src/automation/key_sequence.rs、rustconn-core/src/automation/script.rs 和 rustconn-core/src/automation/tasks.rs,完整使用说明见官方指南 docs/USER_GUIDE.md。
Expect 规则:自动回答任何 "password:" 提示
Expect 规则是最轻量的自动化:匹配模式(Pattern)+ 应答内容(Response)。引擎实时监视终端输出,一旦某行命中正则,就把应答敲进终端并回车(见 expect.rs#L57-L86 的规则结构)。
配置路径:编辑连接 → Automation 选项卡 → 点击 Add Rule,输入模式与应答,还能用 Test 按钮实时验证匹配效果。
常用规则速查表:
| 模式(Pattern) | 应答(Response) | 用途 |
|---|---|---|
password:\s*$ |
${password} |
自动填入密钥库密码 |
\[sudo\] password for \w+: |
${password}\n |
自动回答 sudo 提权 |
Are you sure.*continue |
yes |
首次连接自动确认主机指纹 |
Select option: |
2 |
自动选择设备菜单项 |
Enter token: |
${MFA_TOKEN} |
用全局变量填一次性令牌 |
应答支持变量占位符,这是无人值守的关键:
${password}、${username}、${host}、${port}直接取自当前连接,密码在连接时才从密码源注入,规则里不落盘;- 其余
${NAME}按名称解析你的全局变量(Menu → Tools → Variables); ${TIMESTAMP}、${DATE_Y}、${ENV_HOME}等动态内置变量开箱即用。
内置模板一键导入 🎁:Automation 选项卡的 From Template 提供 5 套现成规则——Sudo Password、SSH Host Key Confirmation、Login Prompt、Press Enter to Continue、MOTD Pager(自动跳过 --More--),模板定义见 templates.rs#L46-L123。
⚠️ 一个刻意的设计:主机指纹变更警告(
REMOTE HOST IDENTIFICATION HAS CHANGED)不会被任何内置规则自动接受——那正是中间人攻击的信号,RustConn 要求你用ssh-keygen -R <host>手动处理,把决策留在人手里。
两条值得记住的行为规则:多条规则按 priority 从高到低匹配;开启 One-shot(默认)的规则只触发一次,密码被拒后提示再次出现时会交还给你,避免自动重试导致账户锁定。
按键序列:连上后立刻"代打"
Expect 规则是"被动应答",按键序列(Key Sequence)则是连接建立后主动发起的一次性操作:输入文本、发送特殊键、定时等待、引用变量,四种元素可以任意拼接(语法解析见 key_sequence.rs#L293-L306)。
| 写法 | 含义 |
|---|---|
hello world |
普通文本,原样输入 |
{ENTER} {TAB} {ESCAPE} |
特殊键,另有 F1–F12、方向键、{CTRL+C} 等 |
{WAIT:1000} |
等待 1000 毫秒 |
${username} |
变量占位符,连接时解析 |
一条典型序列 uptime{ENTER}{WAIT:500} 就是"输入 uptime、回车、等半秒"。配合 Telnet/Serial 设备的 Automatic Login(内置识别 login:、Username:、>>User name: 等提示),一台交换机从开机横幅到登录成功全程无需人工干预。
登录后脚本(Post-login Scripts)
比按键序列更"命令化"的选项是登录后脚本:在 Automation 选项卡里添加若干命令行,登录完成即逐条执行,例如 cd /app、source .env、export TERM=xterm-256color。它适合"每台机器登录后都要进同一个工作目录"这类固定动作。
.rsc 脚本:驱动会话的"宏语言"
当你需要等待输出、判断结果、分支重试时,Expect 规则就不够用了——这时上 .rsc 脚本。它是事件驱动的小语言:每行一条指令,支持标签与跳转,能像 SecureCRT 脚本一样操作活动会话(解析器见 script.rs#L1013-L1088)。
指令总览(完整参考:应用内 Tools → Scripts… → ⓘ):
| 指令 | 作用 |
|---|---|
send <序列> |
发送文本与按键(语法同按键序列) |
expect <正则> [秒] |
等待输出匹配(超时则失败) |
capture <正则> <变量> [秒] |
匹配并把第 1 捕获组存入变量 |
readline <变量> [秒] |
读取下一行输出存入变量 |
ask "提示" hide <变量> |
弹窗询问用户(hide 打码显示) |
run "命令" [out=变量] [code=变量] |
在本机执行命令并取结果 |
start / select / stop |
启动、选中、关闭会话 |
split / towindow / totab |
分屏、移窗等布局操作 |
set / goto / if_goto |
变量赋值、跳转、条件分支 |
示例:在 OpenWrt 路由器上自动取运行时间(仓库自带 example-openwrt-uptime 脚本):
expect "#" 15
send "uptime{ENTER}"
capture /up\s+([^,]+)/ up 10
print "Uptime: $up"
三行搞定:等提示符出现 → 敲入命令 → 用正则捕获 up 后面的天数并打印。
无人值守的典型玩法:把脚本放进脚本库(<config_dir>/scripts/<id>.rsc,脚本管理器在 Tools → Scripts…,保存时自动做语法校验),再到 编辑连接 → Automation → Auto-run Scripts 挂上脚本 id,此后每次打开这条连接都会自动执行。
内置了三层安全防护 🔒:
run的变量替换会拒绝 shell 元字符——远端主机打印的文本无法借道在你本机执行命令;run的环境会剥掉BW_SESSION、AWS_*、GITHUB_TOKEN等凭据(tasks.rs#L25-L33),且默认 60 秒超时强杀;ask … hide的打码答案永远不允许出现在命令行上。
配置一次,全组生效:组级自动化继承
手动给 200 条连接逐条配规则不现实。RustConn 支持组级继承:右键组 → Edit Group → Automation,配好的 Expect 规则、登录后脚本和 Auto-run 脚本会沿组层级链自动下发给组内所有连接。
继承规则很简单:
- 连接自身为空的自动化配置,才继承父组的;有自己规则时以连接为准;
- 规则继承与脚本继承相互独立,可以来自不同的组;
${password}按各连接自己的密码源解析,一条组规则即可覆盖整个文件夹。
常见问题与最佳实践
Q:规则配了却没触发? 先确认优先级:引擎按 priority 从高到低取第一条命中的规则。用 Pattern Tester 实时测试,无效正则会直接标红提示。
Q:password: 为什么匹配不到?
终端输出常带首尾空格,用 password:\s*$ 这类带锚点的写法更稳;Telnet/Serial 的登录提示建议优先用 Automatic Login,正则留给 sudo 这类"后出现"的提示。
Q:什么时候该用 Expect 规则、什么时候该用 .rsc 脚本? 规则是状态无关的应答器,适合"看到 X 就答 Y";脚本是有控制流的流程,需要捕获输出、验证、重试、操作多个会话时才上脚本。两者可以叠加:规则兜底,脚本主导。
Q:前/后置任务怎么用?
在编辑连接的 Tasks 选项卡配置:连接前 nmcli con up VPN-Work、连接后 notify-send "Session ended";还可限定"仅文件夹内第一个/最后一个连接时执行",适合批量操作的收尾清理。
小结
RustConn 的自动化是一条完整流水线:前置任务打通网络 → Automatic Login / Expect 规则完成登录与应答 → 按键序列 / 登录后脚本进入工作目录 → .rsc 脚本执行多步巡检与分支逻辑 → 后置任务收尾。理解这五环各自职责,就能把绝大多数重复操作变成"点一下连接图标,全程零干预"。
想动手的话,建议按这个顺序练习:先用 From Template 导入 Sudo 规则体会 Expect 机制,再写一条 {WAIT:500} 按键序列,最后从仓库自带的 example-openwrt-uptime 脚本改起,逐步掌握 expect / capture / if_goto 的组合——源码级细节可查阅 docs/USER_GUIDE.md 与 rustconn-core/src/automation/ 模块。


