向日葵远程控制黑屏等问题可按五步排查：一查网络连通性；二关代理与防火墙；三授屏幕录制、辅助功能及全盘访问权限；四调帧率与显卡设置；五禁硬件加速并清缓存。
如果您使用向日葵远程控制连接目标设备时出现黑屏、画面卡在加载状态或操作无响应，则可能是由于网络异常、权限缺失、驱动不兼容或配置冲突所致。以下是针对性的排查与解决步骤：
本文运行环境：MacBook Air M2，macOS Sequoia。
一、检查并修复网络连接
网络不稳定或双向连通性中断会直接导致图像流无法建立，从而呈现黑屏或持续加载状态。需分别验证主控端与被控端的实时连通能力。
1、在主控端打开终端，输入 ping -c 4 [被控端局域网IP] 并回车，观察是否收到有效回复。
2、在被控端向日葵客户端界面点击右上角菜单，选择“网络检测”，确认其上报的“远程服务可达性”为正常。
3、若任一端检测失败，重启双方路由器，并确保被控端未处于飞行模式或热点共享状态。
二、关闭代理及防火墙干扰
系统级或应用级代理（如 Shadowrocket、ClashX）、第三方安全软件或 macOS 内置防火墙可能拦截向日葵的视频传输端口（默认 TCP 5900/UDP 5901），造成信令握手成功但画面无法渲染。
1、在被控端系统设置中进入“网络-高级-代理”，关闭“网页代理（HTTP）”和“安全网页代理（HTTPS）”开关。
2、前往“系统设置-隐私与安全性-防火墙”，点击“防火墙选项”，临时关闭防火墙并勾选“允许所有传入连接”。
3、重新启动向日葵客户端，尝试建立新连接。
三、校验并授予必要系统权限（macOS 专属）
macOS Sequoia 对屏幕录制、辅助功能及全盘访问实施强管控，若向日葵未获全部授权，将无法捕获桌面图像，强制触发黑屏保护机制。
1、打开“系统设置-隐私与安全性”，依次点击“屏幕录制”、“辅助功能”、“全盘访问”三项。
2、在每一项列表中查找“SunloginClient”或“向日葵远程控制”，确保其右侧开关均为开启状态。
3、若某项未列出该应用，点击左下角“+”号，前往应用程序文件夹手动添加 SunloginClient.app。
四、调整显卡输出与帧率配置
当被控端启用多显卡（如 Intel 集显 + AMD 独显）或高刷新率显示器时，向日葵默认采用集成显卡输出路径，易因显存带宽不足或帧同步异常导致黑屏。
1、在被控端打开“活动监视器”，切换至“GPU”标签页，确认向日葵进程 GPU 占用率是否为 0 或持续波动。
2、进入向日葵客户端“设置-显示”，将“远程帧率”由默认 60Hz 手动改为 30Hz。
3、在 macOS 中打开“系统设置-显示器”，点击当前显示器右下角“高级设置”，关闭“自动切换图形处理器”，并强制设定为“高性能图形处理器”。
五、重置向日葵显示缓存与硬件加速
本地视频解码缓存损坏或硬件加速模块与当前 GPU 驱动不匹配，会导致解码器崩溃，仅显示黑色背景而无错误提示。
1、在向日葵客户端主界面点击右上角头像，选择“设置-显示”，取消勾选“启用硬件加速”。
2、返回设置页，点击“高级”，在“显示优化”区域点击“清除显示缓存”按钮。
3、关闭客户端后，前往访达，按 Command+Shift+G 输入 ~/Library/Caches/com.oray.sunlogin，删除整个文件夹。
