| 查看: 3|回复: 0 |
[其他转载] 跨两跳远程会话的剪贴板打通 [复制链接] |
|
|
发表于 2026-11-18 11:01
Clipboard.7z 6.25 KB, 下载次数: 0, 下载积分: 吾爱币 -1 CB |
| | 发帖前要善用【论坛搜索】功能,那里可能会有你要找的答案或者已经有人发布过相同内容了,请勿重复发帖。 |
| 工作的时候经常需要使用到 虚拟机和远程管理桌面电脑,但是在远程桌面电脑里的虚拟机复制粘贴文本一直不行,突发奇想搞了一个小脚本,提供给参考 RDP → VMware Workstation → 断网 Windows 虚拟机 一、需求 1.1 环境与场景 办公终端 A 通过远程桌面登录主机 B;B 上运行 VMware Workstation,其中一台 Windows 虚拟机 C 承载业务。出于安全要求,C 不具备对外网络,只能在 B 的 VMware 控制台中操作。 A:办公终端(Windows),RDP 客户端 B:Windows 主机,VMware Workstation 宿主机 C:Windows 虚拟机,无对外网络,仅控制台可达 1.2 问题现象 A 与 B 之间:复制粘贴正常 B 与 C 之间(VMware 控制台):复制粘贴正常 A 与 C 之间:无法直接复制粘贴,只能在 B 上手工中转两次 1.3 目标 A、C 之间可双向直接复制粘贴纯文本 端到端时延不超过 2 秒 保持 C 的断网状态,不新增对外网络通道 不降低既有安全策略:不开放监听端口、不引入第三方云服务 重启或重新登录后自动恢复,无需人工启动 1.4 约束 C 无对外网络,A 无法直连 C,无法把链路缩短为一跳 宿主机为 VMware Workstation;若为 ESXi 则不支持 HGFS 共享文件夹,需改用虚拟串口方案 二、解决方法 2.1 根因分析 剪贴板不是端到端协议,而是每跳各自桥接的“单槽会话资源”,本身没有链式转发能力: 第一跳由 RDP 客户端完成剪贴板重定向,把 A 的剪贴板映射到 B 第二跳由 VMware Tools 完成宿主机与客户机之间的剪贴板同步,把 B 的剪贴板映射到 C 两跳互相独立:B 的剪贴板由 RDP 客户端以延迟渲染方式持有,VMware Tools 读取时可能拿不到内容或格式不匹配 结论:瓶颈在 B 的剪贴板上,与 C 是否断网无关。VMware Tools 的剪贴板通道走虚拟设备,不经过网络协议栈。要解决的是“缺少一条不依赖这两套剪贴板通道的传输链路”。 2.2 方案设计 以 VMware 共享文件夹作为独立数据通道,在 B 与 C 上各运行一个守护脚本,用两个文本文件交换剪贴板内容。整个过程不经过网络协议栈,C 保持断网即可。 数据流向: 1.A 复制文本,RDP 将内容同步到 B 的剪贴板 2.B 端脚本检测到剪贴板变化,写入 to-guest.txt 3.C 端脚本轮询到新的变更标记,把内容写入 C 的剪贴板 4.反向操作同理:C 复制后写入 to-host.txt,B 端脚本读入并写入 B 的剪贴板,再由 RDP 同步回 A 脚本: [Shell] 纯文本查看 复制代码 2.5 部署步骤 5.在 B 上创建 D:\ClipBridge,放入 ClipboardBridge.ps1、Start-Host.cmd、Install-AutoStart.ps1、Install-AutoStart.cmd 6.VMware 中打开 虚拟机 → 设置 → 选项 → 共享文件夹,选择“总是启用”,添加主机路径 D:\ClipBridge,名称 ClipBridge,不勾选只读 7.在 C 中访问 \vmware-host\Shared Folders\ClipBridge,确认可见后,把 ClipboardBridge.ps1、Start-Guest.cmd、Install-AutoStart.ps1、Install-AutoStart.cmd 复制到 C:\Tools 8.在 B 上启动 Host 端 powershell -NoProfile -ExecutionPolicy Bypass -STA -File D:\ClipBridge\ClipboardBridge.ps1 -Role Host 9.在 C 上启动 Guest 端 powershell -NoProfile -ExecutionPolicy Bypass -STA -File C:\Tools\ClipboardBridge.ps1 -Role Guest 10.两端分别双击 Install-AutoStart.cmd,按提示选择 1(Host)或 2(Guest)完成自启配置 2.6 自启动设计说明 自启通过当前用户“启动”文件夹中的快捷方式实现,而不是任务计划程序。原因有两点: 剪贴板属于交互式桌面会话,服务或“不管用户是否登录”的计划任务运行在 Session 0,拿不到剪贴板,进程存在但功能无效 启动文件夹天然在用户登录时触发,恰好是交互式会话,且无需管理员权限 快捷方式设置为最小化窗口启动,配合脚本内的互斥体,即使误触多次也只会保留一个实例。 三、验证 3.1 验证方法 两端各启动一个实例,在 A 与 C 的记事本之间双向复制,观察粘贴结果,并检查共享目录中交换文件的修改时间与内容,确认内容确实经过文件通道传递。 3.2 交付前验证(已完成) 3.3 现场验收用例 3.4 性能与资源 •轮询周期 800 毫秒,端到端时延约 1 至 2 秒 •单次仅读写 KB 级文本文件,对宿主机与虚拟机负载可忽略 •共享目录响应较慢时,可将 PollMs 调整为 1200,降低 HGFS 读写频率 3.5 边界与限制 •仅 VMware Workstation、Player、Fusion 支持 HGFS 共享文件夹;ESXi 需改用虚拟串口方案 •仅处理纯文本;图片、文件需扩展为文件通道或直接使用共享文件夹拷贝 •两端进程必须运行在交互式桌面会话,注销或关机后需依赖自启恢复 •共享文件夹必须保持“总是启用”且非只读,否则 Guest 端无法写入 •同一端重复运行会被互斥体拦截,属预期行为 3.6 排错速查 附录:文件清单与常用命令 文件 用途 # 查看运行实例 Get-CimInstance Win32_Process -Filter "Name='powershell.exe'" |Where-Object { $_.CommandLine -like '*ClipboardBridge*' } # 查看自启状态 powershell -NoProfile -ExecutionPolicy Bypass -File .\Install-AutoStart.ps1 -Action Status # 卸载自启 powershell -NoProfile -ExecutionPolicy Bypass -File .\Install-AutoStart.ps1 -Action Uninstall -Role All |
| to-guest.txt | B → C | B 端 Host 脚本 | C 端 Guest 脚本 |
| to-host.txt | C → B | C 端 Guest 脚本 | B 端 Host 脚本 |
| <``#``.SYNOPSIS VMware 虚拟机剪贴板桥接(共享文件夹版,支持文本、图片、文件)。``.DESCRIPTION 在 VMware 宿主机(B)与虚拟机(C)上各运行一次,两端共用一个「始终启用」的共享文件夹。 双方通过共享目录中的清单文件交换剪贴板内容,不经过虚拟机网络,也不依赖 RDP 与 VMware Tools 的剪贴板通道,因此适用于虚拟机完全断网、只能通过控制台访问的场景。 支持三种剪贴板内容: 文本 直接写入清单 图片 保存为 PNG 后投放到对端剪贴板 文件 复制到共享目录,再以文件列表形式投放到对端剪贴板 清单格式(JSON):{ id``, type``, text \| rel \| items } 变更检测使用 Windows 剪贴板序列号,避免 800ms 轮询时反复比较大对象。``.EXAMPLE # 在虚拟机 C 中运行(默认共享目录 \\vmware-host\Shared Folders\ClipBridge) powershell -NoProfile -ExecutionPolicy Bypass -STA -File .\ClipboardBridge.ps1 -Role Guest``.EXAMPLE # 在宿主机 B 中运行 powershell -NoProfile -ExecutionPolicy Bypass -STA -File .\ClipboardBridge.ps1 -Role Host -SharePath D:\ClipBridge``#>``[CmdletBinding()]``param( # Host = VMware 宿主机(B),Guest = 虚拟机(C) [ValidateSet(``'Host'``, 'Guest'``)] [string]$Role = 'Guest'``, # 宿主机填本地共享目录;虚拟机留空则使用 HGFS 默认路径 [string]$SharePath, # 轮询间隔(毫秒) [int]$PollMs = 800, # 单个文件或单次传输的总大小上限(MB) [int]$MaxFileMB = 200, # 单次传输的文件个数上限 [int]$MaxItems = 20, # 共享目录中保留的传输批次数量 [int]$KeepTransfers = 30``)``$ErrorActionPreference = 'Stop'``Add-Type -AssemblyName System.Windows.Forms``Add-Type -AssemblyName System.Drawing``# 单实例保护:自启与手动启动同时存在时,只保留一个进程(同一会话内)``$mutex = $null``try { $createdNew = $``false $mutex = New-Object System.Threading.Mutex($``true``, "ClipboardBridge-$Role"``, [ref]$createdNew) if (-not $createdNew) { Write-Host "检测到 $Role 角色的桥接实例已在运行,本次启动退出。" -ForegroundColor Yellow exit 0 }``}``catch { # 互斥体创建失败不影响主流程``}``# 剪贴板序列号:内容每次变化都会自增,用来做低成本变更检测``if (-not (``'Native.Clipboard' -as [``type``])) { Add-Type -Namespace Native -Name Clipboard -MemberDefinition ' [DllImport(``"user32.dll"``)] public static extern uint GetClipboardSequenceNumber(); '``}``if (-not $SharePath) { $SharePath = if ($Role -``eq 'Host'``) { 'D:\ClipBridge' } else { '\\vmware-host\Shared Folders\ClipBridge' }``}``if (-not (Test-Path -LiteralPath $SharePath)) { if ($Role -``eq 'Host'``) { New-Item -ItemType Directory -Path $SharePath -Force \| Out-Null } else { Write-Host "共享目录不可用:$SharePath" -ForegroundColor Red Write-Host '请先在 VMware 中把该目录设为「始终启用」的共享文件夹,并确认客户机内路径正确。' exit 1 }``}``$dataDir = Join-Path $SharePath 'data'``$filesDir = Join-Path $dataDir 'files'``New-Item -ItemType Directory -Path $filesDir -Force \| Out-Null``$inName = if ($Role -``eq 'Host'``) { 'to-host.json' } else { 'to-guest.json' }``$outName = if ($Role -``eq 'Host'``) { 'to-guest.json' } else { 'to-host.json' }``$inFile = Join-Path $dataDir $inName``$outFile = Join-Path $dataDir $outName``$utf8 = New-Object System.Text.UTF8Encoding($``false``)``function Write-Manifest { param([string]$Path, $Object) $json = $Object \| ConvertTo-Json -Depth 5 -Compress $tmp = "$Path.tmp" [System.IO.File]::WriteAllText($tmp, $json, $utf8) try { [System.IO.File]::Replace($tmp, $Path, $null) } catch { # 目标不存在或共享目录不支持替换,退化为覆盖写入 [System.IO.File]::Copy($tmp, $Path, $``true``) Remove-Item -LiteralPath $tmp -Force -ErrorAction SilentlyContinue }``}``function Read-Manifest { param([string]$Path) try { $raw = [System.IO.File]::ReadAllText($Path, $utf8) if ([string]::IsNullOrWhiteSpace($raw)) { return $null } return ($raw \| ConvertFrom-Json) } catch { return $null }``}``function Write-Warn { param([string]$Text) Write-Host "[警告] $Text" -ForegroundColor Yellow``}``# 读取当前剪贴板内容,按 文件 > 图片 > 文本 的优先级识别``function Get-ClipboardPayload { try { if ([System.Windows.Forms.Clipboard]::ContainsFileDropList()) { $items = @() foreach ($``file in [System.Windows.Forms.Clipboard]::GetFileDropList()) { if ($``file``) { $items += [string]$``file } } if ($items.Count -gt 0) { return [pscustomobject]@{ Type = 'files'``; Items = $items } } } if ([System.Windows.Forms.Clipboard]::ContainsImage()) { $image = [System.Windows.Forms.Clipboard]::GetImage() if ($null -``ne $image) { $stream = New-Object System.IO.MemoryStream try { $image.Save($stream, [System.Drawing.Imaging.ImageFormat]::Png) return [pscustomobject]@{ Type = 'image'``; Bytes = $stream.ToArray() } } finally { $stream.Dispose() $image.Dispose() } } } $text = Get-Clipboard -Raw -Format Text -ErrorAction SilentlyContinue if ($null -``ne $text -and ([string]$text).Length -gt 0) { return [pscustomobject]@{ Type = 'text'``; Text = [string]$text } } } catch { # 剪贴板被其他程序占用,跳过本轮 } return $null``}``function Get-UniqueName { param([string]$Name, [hashtable]$Used) $candidate = $Name if (-not $Used.ContainsKey($candidate)) { return $candidate } $base = [System.IO.Path]::GetFileNameWithoutExtension($Name) $ext = [System.IO.Path]::GetExtension($Name) $i = 1 while ($Used.ContainsKey($candidate)) { $candidate = "$base`_$i$ext" $i++ } return $candidate``}``function Remove-OldTransfers { try { $``dirs = @(Get-ChildItem -LiteralPath $filesDir -Directory -ErrorAction SilentlyContinue \| Sort-Object LastWriteTime -Descending) if ($``dirs``.Count -gt $KeepTransfers) { $``dirs \| Select-Object -Skip $KeepTransfers \| ForEach-Object { Remove-Item -LiteralPath $_.FullName -Recurse -Force -ErrorAction SilentlyContinue } } } catch { }``}``function Send-Payload { param($Payload) $``id = [guid]::NewGuid().ToString(``'N'``) $manifest = [ordered]@{ id = $``id``; type = $Payload.Type } switch ($Payload.Type) { 'text' { if ($Payload.Text.Length -gt 1048576) { Write-Warn (``"文本 {0:N1} MB 超过 1 MB 上限,整条未发送。可拆成多次复制。" -f ($Payload.Text.Length / 1MB)) return } $manifest[``'text'``] = $Payload.Text $sizeText = '{0:N1} KB' -f ($Payload.Text.Length / 1KB) } 'image' { $sizeMB = $Payload.Bytes.Length / 1MB if ($sizeMB -gt 30) { Write-Warn (``"图片 {0:N1} MB 超过 30 MB 上限,未发送。可另存为文件后再复制。" -f $sizeMB) return } $``dir = Join-Path $filesDir $``id New-Item -ItemType Directory -Path $``dir -Force \| Out-Null [System.IO.File]::WriteAllBytes((Join-Path $``dir 'clipboard.png'``), $Payload.Bytes) $manifest[``'rel'``] = "files/$id/clipboard.png" $sizeText = '{0:N1} MB' -f $sizeMB } 'files' { $items = @($Payload.Items) if ($items.Count -gt $MaxItems) { Write-Warn (``"选中 {0} 个文件,超过单次上限 {1} 个,整批未发送。请分批复制。" -f $items.Count, $MaxItems) return } $``dir = Join-Path $filesDir $``id New-Item -ItemType Directory -Path $``dir -Force \| Out-Null $rels = @() $failed = @() $used = @{} $totalBytes = 0 $aborted = $``false foreach ($``source in $items) { if (-not (Test-Path -LiteralPath $``source``)) { continue } try { $item = Get-Item -LiteralPath $``source -Force } catch { continue } $size = 0 if ($item.PSIsContainer) { try { $size = (Get-ChildItem -LiteralPath $``source -Recurse -File -ErrorAction SilentlyContinue \| Measure-Object -Property Length -Sum).Sum } catch { } } else { $size = $item.Length } if ($null -``eq $size) { $size = 0 } $totalBytes += $size if ($totalBytes -gt ($MaxFileMB * 1MB)) { Write-Warn (``"累计 {0:N1} MB 超过单次上限 {1} MB,整批未发送。请分批复制。" -f ($totalBytes / 1MB), $MaxFileMB) $aborted = $``true break } $name = Get-UniqueName -Name $item.Name -Used $used $used[$name] = $``true try { if ($item.PSIsContainer) { Copy-Item -LiteralPath $``source -Destination (Join-Path $``dir $name) -Recurse -Force -ErrorAction Stop } else { Copy-Item -LiteralPath $``source -Destination (Join-Path $``dir $name) -Force -ErrorAction Stop } $rels += "files/$id/$name" } catch { $failed += $item.Name } } if ($failed.Count -gt 0) { Write-Warn (``"{0} 个文件未能复制,已从本次传输中排除:{1}" -f $failed.Count, ($failed -``join '、'``)) } if ($aborted -or $rels.Count -``eq 0) { Remove-Item -LiteralPath $``dir -Recurse -Force -ErrorAction SilentlyContinue return } $manifest[``'items'``] = $rels $sizeText = '{0} 个 / {1:N1} MB' -f $rels.Count, ($totalBytes / 1MB) } } Write-Manifest -Path $outFile -Object $manifest Remove-OldTransfers Write-Host (``" 已发送 {0} {1}" -f $Payload.Type, $sizeText) -ForegroundColor Cyan``}``function Apply-Manifest { param($Message) try { switch ($Message.``type``) { 'text' { $text = [string]$Message.text Set-Clipboard -Value $text Write-Host (``" 已接收文本,{0:N1} KB" -f ($text.Length / 1KB)) -ForegroundColor Cyan return $``true } 'image' { $path = Join-Path $dataDir (([string]$Message.rel) -replace '/'``, '\') if (-not (Test-Path -LiteralPath $path)) { return $``false } $image = [System.Drawing.Image]::FromFile($path) try { [System.Windows.Forms.Clipboard]::SetImage($image) } finally { $image.Dispose() } Write-Host ' 已接收图片' -ForegroundColor Cyan return $``true } 'files' { $paths = @() $missing = 0 foreach ($rel in @($Message.items)) { $path = Join-Path $dataDir (([string]$rel) -replace '/'``, '\') if (Test-Path -LiteralPath $path) { $paths += $path } else { $missing++ } } # 任一文件尚未在共享目录可见时整体重试,避免投递出不完整的文件列表 if ($missing -gt 0 -or $paths.Count -``eq 0) { return $``false } $collection = New-Object System.Collections.Specialized.StringCollection foreach ($path in $paths) { [void]$collection.Add($path) } [System.Windows.Forms.Clipboard]::SetFileDropList($collection) Write-Host " 已接收 $($paths.Count) 个文件" -ForegroundColor Cyan return $``true } default { # 未知类型直接消费,避免反复重试同一条消息 return $``true } } } catch { return $``false }``}``# 启动时把已存在的对端清单标记为“已处理”,避免登录瞬间改写剪贴板``$existing = Read-Manifest -Path $inFile``$lastAppliedId = if ($null -``ne $existing) { [string]$existing.``id } else { '' }``$pendingId = ''``$pendingTries = 0``$maxApplyRetries = 10``$lastSeq = 0``try { $lastSeq = [Native.Clipboard]::GetClipboardSequenceNumber() } catch { }``Write-Host "剪贴板桥接已启动 Role=$Role" -ForegroundColor Green``Write-Host "共享目录:$SharePath"``Write-Host "接收:$inName 发送:$outName(文本 / 图片 / 文件)"``Write-Host (``"限制:文本 1MB,图片 30MB,单次文件 {0} MB / {1} 个" -f $MaxFileMB, $MaxItems)``Write-Host '保持本窗口运行,按 Ctrl+C 结束。'``while ($``true``) { # 1. 本机剪贴板有变化 -> 写入共享目录 try { $``seq = [Native.Clipboard]::GetClipboardSequenceNumber() if ($``seq -``ne $lastSeq) { $lastSeq = $``seq $payload = Get-ClipboardPayload if ($null -``ne $payload) { Send-Payload -Payload $payload } } } catch { } # 2. 对端有新的清单 -> 写入本机剪贴板 try { $message = Read-Manifest -Path $inFile if ($null -``ne $message -and [string]$message.``id -``ne $lastAppliedId) { $messageId = [string]$message.``id if ($messageId -``ne $pendingId) { $pendingId = $messageId $pendingTries = 0 } if (Apply-Manifest -Message $message) { $lastAppliedId = $messageId $pendingId = '' $pendingTries = 0 # 应用后同步序列号,避免把自己的写入再发回去 try { $lastSeq = [Native.Clipboard]::GetClipboardSequenceNumber() } catch { } } else { $pendingTries++ if ($pendingTries -``ge $maxApplyRetries) { Write-Warn (``"{0} 类型的载荷重试 {1} 次后仍不可用,已跳过。请让对方重新复制一次。" -f $message.``type``, $maxApplyRetries) $lastAppliedId = $messageId $pendingId = '' $pendingTries = 0 } elseif ($pendingTries -``eq 1) { Write-Warn (``"载荷尚未就绪({0}),正在自动重试…" -f $message.``type``) } } } } catch { } Start-Sleep -Milliseconds $PollMs``} |
| 验证项 | 方法 | 结果 |
| 脚本语法 | PowerShell AST 解析两个脚本 | 通过,无语法错误 |
| 脚本可启动 | 临时共享目录试运行 3 秒 | 正常输出启动信息,无异常退出 |
| 剪贴板读取接口 | Get-Clipboard -Raw -Format Text | 调用成功 |
| 快捷方式创建 | WScript.Shell 在临时目录生成 .lnk | 创建成功 |
| 单实例保护 | 同时启动两个进程 | 第二个在 5 秒内退出,退出码 0 |
| 自启状态查询 | Install-AutoStart.ps1 -Action Status | 正常输出安装状态 |
| 用例 | 操作 | 预期结果 |
| A → C 单行文本 | A 复制,约 1 秒后在 C 粘贴 | 内容完全一致 |
| C → A 单行文本 | 反向执行 | 内容完全一致 |
| 多行中文与长文本 | 复制 10 行中文文本 | 内容与换行完整无丢失 |
| 重复复制同一内容 | 连续复制两次相同文本 | 不产生重复回写或错乱 |
| 图片复制 | 在 A 复制一张截图 | 不传输,且不影响后续文本(已知限制) |
| 注销后重新登录 | 两端分别注销再登录 | 自启拉起,复制粘贴恢复 |
| 重复启动 | 手动再次运行启动器 | 第二个实例自动退出 |
| 现象 | 可能原因 | 处理方式 |
| Guest 提示共享目录不可用 | 共享未设为总是启用、共享名不一致或勾选了只读 | 按部署第 2 步重新配置 |
| 交换文件时间戳不更新 | 源端剪贴板未变化,或 A 与 B 之间本身不通 | 先单段验证 A 与 B 的复制粘贴 |
| 文件已更新但对面没粘上 | 目标端脚本未运行或已被关闭 | 检查窗口与实例数量 |
| 粘贴出旧内容 | 轮询周期未到或 HGFS 延迟 | 等待 2 秒,必要时调大 PollMs |
| 重新登录后未自启 | 安装账号不一致,或移动过脚本目录 | 用日常登录账号重新运行安装器 |
| 文件 | 用途 |
| ClipboardBridge.ps1 | 桥接主脚本,Host 与 Guest 共用,通过 -Role 区分 |
| Start-Host.cmd / Start-Guest.cmd | 手动启动器,指向同级目录的主脚本 |
| Install-AutoStart.ps1 | 自启安装、状态查询与卸载 |
| Install-AutoStart.cmd | 自启一键安装,交互选择角色 |
RSS订阅|小黑屋|处罚记录|联系我们|吾爱破解 - 52pojie.cn
GMT+8, 2026-11-18 11:14
Powered by Discuz!