← 返回列表

[其他转载] 跨两跳远程会话的剪贴板打通

单站 52pojie.cn 入库 2026-11-18T13:55:21

| 查看: 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!

原文链接:https://www.52pojie.cn/thread-2138375-1-1.html