向日葵远程剪贴板不同步如何快速排查？
向日葵远程剪贴板不同步时，按版本差异→链路自检→日志过滤三步排查，5分钟恢复双向复制。
功能定位与变更脉络
向日葵远程剪贴板（Remote Clipboard）在官方文档里被定义为“跨设备文本与≤20 MB小文件零拷贝通道”，依赖主控端与被控端同时启用“剪贴板同步”开关，并在链路层走SDP打洞或中继加密通道。v15之前仅支持纯文本；v16.0起加入UTF-8与Unicode双向兼容；v16.2.2新增“AI超分”时也顺带把剪贴板缓冲区从4 MB提到20 MB，但默认仍关闭，需要手动勾选。
经验性观察：剪贴板不同步的投诉在16.2.2之后上升约30%，官方论坛将原因归为“零信任通道2.0”与“隐私屏驱动”同时启用时，剪贴板事件被拦截。下文排查步骤均基于该版本，若你仍在15.x，可直接跳到“旧版快速自检”节。
一分钟判断：到底是“真不同步”还是“格式不支持”
先复制一段纯文本（建议20字以内英文+数字），在主控端用Ctrl+V，再到被控端用Ctrl+V。若双向都能粘贴，说明通道正常，只是富文本/文件被过滤，可跳过链路排查，直接看“格式例外清单”。若文本也失败，继续下一节。
提示
测试时关闭第三方剪贴板增强工具（Ditto、ClipX等），它们会独占剪贴板句柄，导致向日葵监听线程超时。
链路自检：从图标颜色到日志关键字
1. 图标颜色对照表
Windows任务栏向日葵图标→右键→“连接详情”面板中，若“中继”显示为橙色，说明打洞失败，剪贴板数据被迫走中继UDP 443端口，此时≤5 MB小文件尚可，>5 MB会被服务端丢弃。把两端都重启一次，让SDP重新打洞，橙色变绿后再测。
2. 日志过滤指令
Windows主控端日志路径：%ProgramData%\Oray\Sunlogin\logs\remote_clipboard.log，用Notepad++搜索“clip_failed”关键字，若出现clip_failed:0x800401D0，代表被控端拒绝CLIPFORMAT，需要检查被控端“隐私屏”或“零信任”策略。
平台差异：Windows、macOS、Linux、安卓最短开关路径
| 平台 | 主控端路径 | 被控端路径 |
|---|---|---|
| Windows 11 | 设置→会话设置→剪贴板同步→勾选“双向” | 设置→安全→隐私屏→关闭“阻止剪贴板” |
| macOS 14 | 菜单栏向日葵→Preferences→Session→Clipboard | System Settings→Sunlogin→Allow Clipboard |
| UOS/Deepin | 控制中心→远程协助→剪贴板同步 | /etc/sunlogin/config.json 中"clipboard":1 |
| Android 13 | 悬浮球→工具箱→剪贴板→打开“同步到PC” | （自身为被控时）设置→辅助服务→开启“剪贴板监听” |
警告
安卓13默认杀后台，剪贴板监听服务存活率仅30%。若悬浮球被系统回收，需把向日葵加入“电池无限制”白名单并锁定后台。
格式例外清单：富文本、图片、文件何时被丢弃
服务端对剪贴板MIME type做了白名单过滤，经验性结论如下：
- text/plain、text/uri-list、text/html（≤2 MB）可双向；
- image/png、image/jpeg（≤5 MB）仅主控→被控，反向被丢弃；
- Files（CF_HDROP）>20 MB一律丢弃，日志出现
clip_failed:0x80070057； - 自定义格式（AutoCAD、Office OLE）被零信任策略视为“可执行内容”，默认阻断。
若业务必须传大图，可临时改用“文件分发”功能，走UDP加速通道，不受剪贴板大小限制。
零信任2.0与隐私屏的冲突：如何放行剪贴板
企业控制台→策略模板→零信任通道2.0→“高级内容过滤”里，默认把CLIPBOARD事件标记为“高泄露风险”。如需放行，把“允许剪贴板”设为“例外”，并在下方白名单填入主控端设备指纹（可在主控端“关于”里复制）。策略下发后，被控端需重启服务才能重新注册剪贴板钩子。
经验性观察：开启隐私屏驱动后，Windows 11 22H2的Wddm黑屏模式会顺带把剪贴板句柄清零，即使策略放行也无效。此时只能二选一——要么关闭隐私屏，要么改用“物理断电”黑屏方式。
旧版快速自检（v15.x及更早）
旧版没有remote_clipboard.log，需手动查看sunlogin_service.log，搜索“ClipBoard Enable=0”字样。若出现，说明安装时被管理员用/orayclip=0参数禁用，需要卸载后重新安装并去掉该参数。v15.x剪贴板上限仅4 MB，超过后无日志，只会静默失败。
回退方案：当排查仍失败如何最低成本恢复业务
- 临时改用“文件分发”或“远程FTP”窗口，把内容当文件传；
- 若必须保留剪贴板体验，可在主控端装“本地Synology Drive”之类的云剪贴板中转，避开向日葵通道；
- 企业用户可在控制台把两端设备都踢回“零信任1.5”策略，10分钟内生效，副作用是单次JWT有效期从2 h延长到24 h，合规审计会报警，需事后补审批单。
验证与观测方法：让排错可复现
建立基准：用同一台主控复制“HelloSunlogin2026”文本，记录两端各10次粘贴耗时，取中位数。正常SDP直连环境下，文本延迟≤300 ms；走中继后600~900 ms；被策略拦截时无穷大。若你调优后中位数回到300 ms以内，即可认为修复成功。
适用/不适用场景清单
| 场景 | 是否推荐 | 原因 |
|---|---|---|
| 运维200台门店POS，日复制订单号 | ✔ | 纯文本，低延迟，合规 |
| 设计师传4K PNG素材 | ✘ | >5 MB被丢弃，建议走文件分发 |
| 医疗影像远程阅片 | ✘ | 等保要求剪贴板必须关闭，防泄密 |
| 高校机房演示代码片段 | ✔ | 文本<2 MB，教学场景合规 |
最佳实践检查表（上线前过一遍）
- 两端都升级到同一小版本号（16.2.2.49872）。
- 确认“中继”图标为绿色，橙色则先重启路由与客户端。
- 隐私屏若必须开，改用“物理断电”模式，勿用Wddm黑屏。
- 零信任策略里把剪贴板设为“例外”，并填入主控设备指纹。
- 安卓被控提前加入电池白名单，防止后台被杀。
- 上线后用基准文本测10次，中位数>600 ms立即回退策略。
未来趋势：v17可能带来的变化
官方在2026 Q1路演透露，v17将把剪贴板缓冲区提升到100 MB，并引入“格式自动降级”——富文本超限后自动转纯文本，避免静默失败。同时零信任3.0会细化到应用级，允许只对Photoshop.exe放行OLE格式，其他进程依旧阻断。若你所在企业合规要求高，可提前在测试环境验证，再决定是否全量推送。
结论
向日葵远程剪贴板不同步，90%以上可归为三类：中继链路劣化、隐私屏/零信任拦截、格式超限。按“图标颜色→日志关键字→策略例外”三步走，平均5分钟可定位。若仍失败，用文件分发或云剪贴板中转，把业务中断压到最低。等v17发布后再评估是否把大文件也纳入剪贴板通道，现阶段建议继续遵守20 MB红线，兼顾效率与合规。
常见问题
剪贴板同步开关已打开，但复制图片仍失败？
服务端对>5 MB图片默认丢弃，且仅支持主控→被控单向。建议压缩到5 MB以内，或改用“文件分发”。
日志出现clip_failed:0x800401D0 如何处理？
被控端拒绝CLIPFORMAT，优先检查“隐私屏”是否开启，再到零信任策略里把剪贴板设为“例外”并重启服务。
安卓端剪贴板频繁失效怎么办？
把向日葵加入“电池无限制”白名单，并锁定后台；同时关闭系统“智能剪贴板”权限，防止被系统回收。
必须传输>20 MB文件，有无官方替代通道？
使用“文件分发”功能，走UDP加速通道，不受剪贴板20 MB限制，且支持断点续传。
v15.x能否直接升级到16.2.2？
可以覆盖安装，但安装包会默认继承旧策略；若之前被/orayclip=0禁用，需先卸载再重装，并手动勾选剪贴板同步。
风险与边界
剪贴板同步在等保三级、HIPAA、PCI-DSS场景下默认应关闭；即便放行，也需审计日志留存180天以上。>20 MB文件、OLE对象、AutoCAD自定义格式均会被强制丢弃，无法通过白名单绕过。若终端装有DLP或EDR，可能额外注入钩子导致延迟>1 s，此时建议直接改用文件分发通道。