mRemoteNG 外部工具变量参考:连接属性动态注入与转义规则完全指南

发布时间:2026/11/22 23:58:10

mRemoteNG 外部工具变量参考:连接属性动态注入与转义规则完全指南 桌面应用网络【免费下载链接】mRemoteNGmRemoteNG is the next generation of mRemote, open source, tabbed, multi-protocol, remote connections manager.项目地址https://gitcode.com/gh_mirrors/mr/mRemoteNG点击查看免费下载mRemoteNG 的变量Variables也称参数是打通当前连接信息与外部程序的桥梁在 External Tools外部工具的 Filename 与 Arguments 字段中写入%HOSTNAME%、%USERNAME%等占位符运行时会自动替换为当前选中连接的实际属性值从而让tracert、WinSCP、filezilla、PuTTY等程序按连接上下文动态工作。读完本文你将掌握 mRemoteNG 全部内置变量的语义、环境变量展开与屏蔽技巧、^防止展开、以及-/!前缀控制的参数分割与 Shell 元字符双层转义机制并能结合源码理解其底层实现与测试验证。变量功能在 External Tools 界面中使用相关入口与完整界面说明见 外部工具使用指南本文是其中的变量参考专题页。一、变量是什么把连接属性注入外部命令变量Variables也叫 Parameters可以在 External Tools 中动态地把连接属性插入命令与参数中。例如你可以在连接树上选中某台主机然后通过外部工具一键对它执行tracert而不必手动敲入主机名Filename%COMSPEC%Arguments/c set /P | tracert %HostName%其运行原理在源码中非常清晰ExternalTool.Start()启动进程前会为当前连接构造一个 ExternalToolArgumentParser构造参数为ConnectionInfo然后对FileName、Arguments、WorkingDir三个字段统一调用ParseArguments完成替换见 ExternalTool.SetProcessProperties。因此变量不只用于 Arguments也适用于 Filename例如%COMSPEC%和工作目录字段。二、可用变量完整列表mRemoteNG 支持以下内置变量均引用当前选中连接的属性变量含义对应 ConnectionInfo 属性源码%NAME%连接的显示名称Name%HOSTNAME%连接的主机名或 IP 地址Hostname%PORT%连接的端口号PortConvert.ToString转为字符串%USERNAME%连接配置的用户名Username%PASSWORD%连接配置的密码Password%DOMAIN%连接配置的域Domain%DESCRIPTION%连接的描述文本Description%MACADDRESS%连接配置的 MAC 地址MacAddress%USERFIELD%连接的自定义用户字段UserField上面的源码映射可直接在 ExternalToolArgumentParser.GetVariableReplacement 中找到解析器对变量名做ToLowerInvariant()后按name / hostname / port / username / password / domain / description / macaddress / userfield逐一匹配。2.1 用户名、密码、域的空值回退行为从源码可以看出%USERNAME%、%PASSWORD%、%DOMAIN%三个变量在连接属性为空时并非简单地替换为空字符串而是受Options → Credentials 页的EmptyCredentials设置影响见 OptionsCredentialsPage%USERNAME%为空时若EmptyCredentials windows替换为Environment.UserName当前 Windows 登录用户名若EmptyCredentials custom替换为设置的默认用户名DefaultUsername。%PASSWORD%为空时仅当EmptyCredentials custom会使用LegacyRijndaelCryptographyProvider解密DefaultPassword后替换。%DOMAIN%为空时windows模式替换为Environment.UserDomainNamecustom模式替换为DefaultDomain。这意味着即使连接的凭据字段留空外部工具也可能拿到来自操作系统或默认凭据设置的值——在配置敏感命令时需留意这一点。三、环境变量展开%PATH%、%USERPROFILE%与\%转义除了内置变量mRemoteNG 也会展开操作系统环境变量如%PATH%、%USERPROFILE%。展开流程见 ExternalToolArgumentParser.BuildReplacementList当变量名既不是内置变量、又不是特殊形式时会调用Environment.GetEnvironmentVariable(variableName)尝试读取系统环境变量读取成功则替换读取失败则保留原文。3.1 冲突场景\%USERNAME\%强制走环境变量当环境变量与 mRemoteNG 内置变量同名时最典型的是USERNAME内置变量优先%USERNAME%→ 展开为当前选中连接里配置的用户名\%USERNAME\%用\%代替%→ 展开为USERNAME环境变量的值。其实现位于源码第 45-60 行当 token 前后两个字符都是\时解析器标记isEnvironmentVariable true跳过内置变量查找、直接走环境变量分支。3.2 相关测试佐证在 ExternalToolsArgumentParserTests 中可以看到对应测试用例%COMSPEC%→ 解析为Environment.GetEnvironmentVariable(comspec)环境变量被解析\%COMSPEC\%→ 同样解析为comspec环境变量的值反斜杠转义的环境变量被解析^%COMSPEC^%→ 原样返回%COMSPEC%见下文防止展开。四、防止变量展开^%前缀如果想把变量名原样传给目标程序、不让 mRemoteNG 展开请用^%代替%。mRemoteNG 会移除插入符^并保留其余内容不变。例如输入^%USERNAME^%→ 传给程序的是字面量%USERNAME%不会被展开。实现上解析器在 第 61-75 行 检测 token 前后字符为^时直接把 token 还原为%变量名%加入替换列表不进行任何值替换与转义。测试ChevronEscapedEnvironmentVariablesNotParsed验证了该行为。五、变量的使用规则使用变量时须遵守以下规则变量始终引用当前选中的连接在连接树中高亮的那个连接变量名不区分大小写%HOSTNAME%与%HostName%等价源码用ToLowerInvariant统一处理变量可用于 External Tools 的Filename与Arguments两个字段实际上 Working directory 字段同样经过解析器处理变量总是被%包裹未定义的变量名不会被替换例如%UNSUPPORTEDPARAMETER%原样保留测试UnsupportedParametersNotParsed已覆盖空的变量标签%%不会被当作变量解析测试EmptyVariableTagsNotParsed已覆盖。六、特殊字符转义双层转义机制展开后的变量值会被自动转义转义分两个层次参数分割转义针对 C/C argv、CommandLineToArgvW等标准参数拆分规则Shell 元字符转义针对ShellExecute场景下的 shell 特殊字符。注意只有被展开的变量值才会转义命令中其余部分需要你自己负责转义。6.1 参数分割转义规则按标准 Windows 命令行参数拆分规则源自 CommandLineArguments.cs注释标明 Adapted from http://qntm.org/cmd每个引号之前加一个反斜杠转义一个或多个反斜杠后跟引号\每个反斜杠再补一个反斜杠翻倍引号前再加一个反斜杠。官方文档给出的示例%USERFIELD%若连接的用户字段内容为Thisis a\test\则%USERFIELD%替换为\This\is a\\\test\\\若用户字段内容为c:\Example\结尾带反斜杠则%USERFIELD%替换为c:\Example\\。第二个示例对应源码中的EscapeBackslashesForTrailingQuote当变量后面紧跟一个引号且值以反斜杠结尾时末尾反斜杠必须翻倍否则会吃掉闭合引号见 ExternalToolArgumentParser 第 125-126 行。6.2 禁用参数分割转义-前缀在变量名前加减号-可关闭参数分割转义只保留 Shell 元字符转义。例如%-USERFIELD%→ 不进行引号/反斜杠的参数分割转义但仍做 Shell 元字符转义。源码 DetermineEscapeType 中前缀-对应EscapeType.ShellMetacharacters。6.3 Shell 元字符转义规则Shell 元字符集合为( ) % ! ^ |。每个元字符前会加一个插入符^进行转义对应 CommandLineArguments.EscapeShellMetacharacters 中的正则([()%!^|])→^$1。测试用例中给出了非常直观的对照测试常量见 ExternalToolsArgumentParserTests原始值()%!^abc123*|\结尾仅 Shell 元字符转义后%-前缀^()^%^!^^abc123*^^^^|^\双层全量转义后默认^()^%^!^^abc123*^^^^|\^\6.4 完全禁用转义!前缀不推荐在变量名前加感叹号!可同时关闭参数分割转义与 Shell 元字符转义。例如%!USERFIELD%→ 原样替换不做任何转义。文档明确警示这可能导致意外结果不建议使用例如包含空格或引号的值会破坏命令参数结构。源码中!前缀对应EscapeType.None。6.5 三层转义行为速查写法参数分割转义Shell 元字符转义适用场景%USERFIELD%✅✅默认行为最安全%-USERFIELD%❌✅值内部已含需要保留的引号结构%!USERFIELD%❌❌特殊场景风险高官方不建议测试 ParserTestsDataSource 对全部 9 个内置变量逐一验证了%x%、%-x%、%!x%三种形态的展开结果与上述规则完全一致。七、解析器实现细节token 扫描流程理解底层实现有助于排查变量不生效的问题。BuildReplacementList的核心流程是用IndexOf(%)在输入串中从左到右扫描%...%token第 29-39 行检查 token 前导字符\\前后成对 → 环境变量强制展开^前后成对 → 原样保留不展开检查 token 第二个字符-/!→ 决定转义级别先在ConnectionInfo中查内置变量查不到再查Environment.GetEnvironmentVariable有替换值才加入替换列表并应用对应转义无替换值时保留原文最后在PerformReplacements中从右向左执行替换避免下标错位。另外解析器对ConnectionInfo null时返回空字符串测试NullConnectionInfoResultsInEmptyVariables验证test %USERNAME% test解析为test test这对应外部工具在无连接上下文时启动的场景。八、实战示例把变量用起来结合 外部工具常用配置速查表以下示例展示了变量的典型组合用法Ping使用环境变量%COMSPEC%作为 FilenameFilename%COMSPEC%Arguments/c ping -t %HostName%FileZilla 连接用户名/密码/主机/端口组合FilenameC:\Program Files\FileZilla FTP Client\filezilla.exe示例路径ArgumentsFTPftp://%Username%:%Password%%Hostname%ArgumentsSFTPsftp://%Username%:%Password%%Hostname%WinSCP SCP 会话FilenameC:\Program Files\WinSCP\WinSCP.exe示例路径Argumentsscp://%Username%:%Password%%Hostname%/可选参数-rawsetting Compression1 -hostkey*开启压缩并忽略主机密钥错误COM 串口变量放在 Filename 里也能展开Filenameputty.exe示例路径Arguments-serial com%Port%PowerShell 远程会话引号与^配合Filename%WINDIR%\system32\WindowsPowerShell\v1.0\PowerShell.exeArguments-noexit $pw \%password%\ -replace \^, ; ... Enter-PSSession -ComputerName %hostname% -credential $Cred最后一个示例特别体现了转义的价值\是让参数分割转义产生的输出与 PowerShell 语法兼容的典型写法而-replace \^, 中的^用于在 mRemoteNG 展开后对 PowerShell 特殊字符做二次处理。九、最佳实践小结优先使用默认转义%HOSTNAME%、%USERNAME%等默认形式足够应对绝大多数场景只有确认值中的引号/反斜杠会被参数拆分破坏时才用%-前缀。密码变量注意隐私%PASSWORD%会把明文密码拼进命令行参数进程列表如任务管理器中可能可见且当连接密码为空、EmptyCredentials设为custom时会回退到全局默认密码。环境变量冲突时显式声明要取操作系统级%USERNAME%、%DOMAIN%时用\%USERNAME\%形式避免被连接属性覆盖。字面量用^%需要把%xxx%原样传给下游程序如脚本模板时使用^%xxx^%。不要滥用%!前缀完全关闭转义会让包含空格、引号、、|等字符的值直接进入命令行可能导致参数错位甚至意外执行仅在明确风险可控时使用。十、相关文档导航外部工具使用指南变量在 External Tools 界面中的配置入口Tools → External Tools快捷键Shift-F4新建外部工具常用配置速查表Ping、traceroute、WinSCP、FileZilla、PowerShell 等完整可复制示例变量解析器源码内置变量映射、环境变量回退、^/-/!前缀与转义级别判定命令行转义工具源码EscapeBackslashes、EscapeBackslashesForTrailingQuote、EscapeShellMetacharacters的具体正则实现外部工具启动流程Start→SetProcessProperties→ 解析 Filename/Arguments/WorkingDir 的调用链解析器单元测试覆盖全部变量的三种转义形态、环境变量展开、防止展开、未定义变量保留等边界场景。赞分享桌面应用网络【免费下载链接】mRemoteNGmRemoteNG is the next generation of mRemote, open source, tabbed, multi-protocol, remote connections manager.项目地址https://gitcode.com/gh_mirrors/mr/mRemoteNG点击查看免费下载相关推荐mRemoteNG External Tools 完全指南用连接变量驱动任意外部命令mRemoteNG External Tools 完全指南用连接变量驱动任意外部命令 mRemoteNG 的 External Tools外部工具机制允许桌面应用网络mRemoteNG 用户界面完全指南主窗口、面板、连接管理、快速连接与外部工具实战mRemoteNG 用户界面完全指南主窗口、面板、连接管理、快速连接与外部工具实战 mRemoteNG 是一款开源的标签式多协议远程连接管理器其界面围绕「主桌面应用网络mRemoteNG 外部工具External Tools实战指南变量注入、命令行集成与典型配置示例mRemoteNG 外部工具External Tools实战指南变量注入、命令行集成与典型配置示例 mRemoteNG 的 External Tools桌面应用网络创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
延伸阅读

更多相关文章

2026/11/21 20:07:53

LanceDB Python 绑定开发指南:从环境搭建到提交高质量的 PR

向量数据库数据库人工智能后端 【免费下载链接】lancedb Developer-friendly OSS embedded retrieval library for multimodal AI. Search More; Manage Less. 项目地址: https://gitcode.com/gh_mirrors/la/lancedb 点击查看 免费下载 本篇指南以 python/CONTRIBU…

2026/11/22 23:56:37

盐源县电工证培训机构怎么选?含金量高不高别再踩坑

盐源县电工证培训机构怎么选?含金量高不高别再踩坑 怕考不过白交培训费?别急,今天我就从郑州金水区房建工程从业者的角度,告诉你怎么选一家靠谱的 盐源县电工证培训机构 ,还有这证的 含金量 到底高不高,怎么备考才不会被坑。…

2026/11/22 23:56:37

西安电工证在哪学怎么报名全流程解析

西安电工证在哪学怎么报名全流程解析 之前考的证在外省能不能转过来?这个问题几乎每个想考电工证的人都问过,特别是那些已经在外地工作多年、手握证书但想回西安发展的朋友。别急,今天就把西安电工证在哪学、怎么报名、怎么转证、怎么考试、怎么复审这些流…

2026/11/22 23:56:37

直流桩要高压电工证吗?网上查询最新政策+报名攻略

直流桩要高压电工证吗?网上查询最新政策+报名攻略 学历不高怕报不上名?你不是一个人。最近很多从事新能源行业的朋友,尤其是许昌公路工程从业者,问得最多的问题就是“直流桩要高压电工证吗?”。其实,这背后隐藏着不少人的担忧——证书门槛高、流程复杂…

2026/11/22 23:56:37

电工作业现场直播证丢了怎么补办 值不值得考

电工作业现场直播证丢了怎么补办 值不值得考 你是不是正为找工作发愁,但又苦于没特种作业证?别急,电工作业现场直播证丢了怎么补办,这事儿别拖,赶紧搞清楚流程, 值不值得考 这个证,其实早该问问自己了。…

2026/11/22 23:56:37

闻喜特种工证过期了怎么复审上岗必备

闻喜特种工证过期了怎么复审上岗必备 证书过期了不知道怎么复审延期,这事儿真让人头疼。尤其是在闻喜,很多特种作业人员都面临着证书到期后如何操作的问题,不仅影响工作,还可能面临被单位辞退的风险。很多人在遇到这种情况时,不知道从哪里下手,更别说找…

2026/11/22 0:09:40

高压电工证还能年审吗良心建议来了,学历不高也能考!

高压电工证还能年审吗良心建议来了,学历不高也能考! 你是不是也担心,自己学历不高,根本报不上高压电工证?其实不然,现在政策已经非常明确, 高压电工证还能年审 ,而且只要符合条件, 学历不是门槛 , 良心建议…

2026/11/22 0:09:40

吴江的电工证免费培训怎么报名?官方报名入口全解析

吴江的电工证免费培训怎么报名?官方报名入口全解析 你急需特种作业证才能上岗找工作,但不知道从哪里下手?别急,现在就给你讲明白【吴江的电工证免费培训】到底怎么操作,以及怎么通过 官方报名入口…

2026/11/22 0:09:40

电工证复审肃州区的真实经历:别被中介坑了,自己搞定更靠谱

电工证复审肃州区的真实经历:别被中介坑了,自己搞定更靠谱 不知道去哪报名怕被中介坑?这几乎是每个需要办理或复审电工证的人的真实经历。尤其在肃州区,信息不透明、流程复杂、中介收费高又不靠谱,让很多电工从业者感到头疼。作为一个在应急管理和特种作…

2026/11/22 0:09:40

高压电工证还能年审吗良心建议来了,学历不高也能考!

高压电工证还能年审吗良心建议来了,学历不高也能考! 你是不是也担心,自己学历不高,根本报不上高压电工证?其实不然,现在政策已经非常明确, 高压电工证还能年审 ,而且只要符合条件, 学历不是门槛 , 良心建议…

2026/11/22 0:09:40

吴江的电工证免费培训怎么报名?官方报名入口全解析

吴江的电工证免费培训怎么报名?官方报名入口全解析 你急需特种作业证才能上岗找工作,但不知道从哪里下手?别急,现在就给你讲明白【吴江的电工证免费培训】到底怎么操作,以及怎么通过 官方报名入口…

2026/11/22 0:09:40

电工证复审肃州区的真实经历:别被中介坑了,自己搞定更靠谱

电工证复审肃州区的真实经历:别被中介坑了,自己搞定更靠谱 不知道去哪报名怕被中介坑?这几乎是每个需要办理或复审电工证的人的真实经历。尤其在肃州区,信息不透明、流程复杂、中介收费高又不靠谱,让很多电工从业者感到头疼。作为一个在应急管理和特种作…

2026/11/22 9:39:14

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

在智慧养宠时代,基于视觉的宠物身份识别技术正逐步从实验室走向家庭应用。然而,与配合度高的人类不同,宠物是典型的“非合作生物识别对象”——它们不会主动配合摄像头调整姿态,更无法控制光照环境。实际应用中,我们常…

2026/11/22 5:39:03

SSM电子书店源码全解析:结构、原理、部署与排错实战

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
☎咨询二维码 ☎ ↑