ToDesk远程文件传输失败如何排查端口占用与权限设置？
问题现象与核心关键词
ToDesk 远程文件传输失败时，先看清报错提示：0x8007045d（I/O 设备错误）、0x00000005（拒绝访问）或单纯“传输中断”。不同代码指向端口冲突、系统权限、杀软拦截三类根因，下文按“现象→验证→处置”递进，给出可复现步骤。
功能边界：文件传输依赖哪些底层通道
ToDesk 在 v5.2.0 之后默认优先走 QUIC 极光链路 3.0，回退 TCP 443/HTTPS；当两端直连失败时才中继。文件传输子通道复用同一端口组，因此“远程桌面正常，传文件失败”99% 是子通道被占用或权限不足，而非中继延迟。
排查总览：一张图理清顺序
提示
先确认两端都能登录同一账号且会话未过期，再执行下方三步，避免白走弯路。
- 端口占用：本机监听 vs 第三方抢端口
- 权限设置：UAC、杀软、企业EDR拦截
- 防火墙/NAT：出站入站规则是否把 ToDesk 子通道挡掉
Step 1 端口占用：如何一眼看出谁抢了 6180-6190
Windows 桌面端
1. 以管理员身份打开 PowerShell，输入：
Get-Process -Id (Get-NetTCPConnection -LocalPort 6180).OwningProcess
2. 若返回 System、nginx.exe 或其他陌生进程，说明端口被占；经验性观察：6180-6190 是 ToDesk 文件传输默认区间，可在设置-传输-高级里改成 7100-7110 后重启客户端，再测传输。
macOS & Linux
终端执行：
lsof -i :6180
输出为空即正常；若出现 docker-proxy 或 kubelet，考虑改端口或暂停对应容器。
Step 2 权限设置：UAC、杀软、EDR 三板斧
Windows 11 24H2 实测路径
- 控制面板-用户账户-更改用户账户控制设置-调到“默认”或更低
- Windows 安全中心-病毒和威胁防护-管理勒索软件防护-关闭“受控文件夹访问”或在“允许应用”里添加 ToDesk.exe（安装目录因版本而异，请以实际为准）
- 企业版若装有 360 EDR、火绒、天擎，需在白名单里加整条安装目录，并放行子进程 tdesk_transfer.exe
macOS 15 Sequoia
系统设置-隐私与安全-文件和文件夹-给 ToDesk 勾选“下载文件夹、桌面、文稿”；若出现“无法捕获屏幕”顺带检查屏幕录制权限（官方 KB-2261）。
Step 3 防火墙/NAT：出站入站双向放行
Windows Defender 防火墙
1. 控制面板-Windows Defender 防火墙-高级设置-出站规则-新建规则-程序-选 ToDesk.exe-允许连接-域/私有/公用全勾-命名“ToDesk Out”。
2. 同理再建入站规则；若公司策略禁止本地放行，可让网管在核心交换机 ACL 里放行 UDP 6180-6190、TCP 443。
家庭光猫端口映射
部分电信天翼网关默认关闭 UPnP，导致子通道无法打洞。登录 192.168.1.1-应用-UPnP 开启，或在“虚拟服务器”里手动把 6180-6190 指向被控机内网 IP；改后重启光猫与 ToDesk，文件传输速率经验性观察可回到带宽上限。
验证方法：如何确认已修复
- 传输任意单文件 >100 MB，观察是否仍断在 0%、50% 或 99%。
- 打开 ToDesk 日志（设置-关于-打开日志目录）搜索“transfer_channel_establish”，出现“success”即子通道建立成功。
- 若日志里反复“quic handshake timeout”而 TCP 443 正常，说明 UDP 被丢包，可回退到设置-传输-强制 TCP 模式再测。
常见分支：为什么桌面流畅却传不了文件
桌面流走 TCP 443 中继，文件子通道尝试 P2P QUIC；若 UDP 被禁就会卡在“等待对方接收”。此时并非带宽不足，而是子通道没建起来，按上文 Step 3 放行 UDP 或强制 TCP 即可。
不适用场景：哪些情况别浪费时间
- 公司 SD-WAN 强制白名单且网管不在场——直接改用 U 盘或 SMB 共享更省时间。
- 被控机磁盘剩余空间 < 待传文件大小——日志会报“disk full”，清空间即可，与端口无关。
- 安卓被控存储权限被系统回收——需重新弹窗授权，端口排查无效。
最佳实践 10 秒检查表
| 检查项 | 命令/路径 | 通过标准 |
|---|---|---|
| 端口占用 | Get-NetTCPConnection -LocalPort 6180 | 返回为空或 ToDesk 自身 PID |
| UAC 拦截 | 设置-账户-用户账户控制 | 默认级别或更低 |
| 杀软勒索防护 | Windows 安全中心 | 受控文件夹访问=关 或 ToDesk 在白名单 |
| 防火墙出站 | wf.msc-出站规则 | ToDesk.exe 允许 |
| 日志验证 | transfer_channel_establish | 出现 success |
FAQ：3 个高频疑问（FAQPage Schema）
修改端口后需要两端一致吗？
不需要。ToDesk 会自动协商，只要本端新端口未被占用即可。
日志里出现“RSA key mismatch”是端口问题吗？
不是，是身份证书缓存冲突，退出账号重新登录即可，与端口无关。
家用 Wi-Fi 6 路由需要额外设置吗？
默认开启 UPnP 即可；若关闭，需手动映射 6180-6190 到被控机。
收尾：下一步行动建议
按“端口→权限→防火墙”三步法，10 分钟内即可定位 ToDesk 远程文件传输失败根因；修复后先传 200 MB 以上大文件验证，再通过日志关键词“success”二次确认。若公司网络白名单无法变更，优先改用 SMB 共享或加密 U 盘，避免在合规边缘反复试错。