环境：Windows 11 / RustDesk / ToDesk / ZorinOS 18.1 / Wayland
问题现象
使用 RustDesk 基于 Linux 远控 Windows 11 主机时，控制端看到的画面整体明显偏暗，表现类似显示器黑位被压死或伽马映射异常。随后使用 ToDesk 连接同一台 Windows 11 主机，现象一致。
具体表现：
- 画面整体发黑
- 暗部细节大量丢失
- 色彩明显失真
- 中间灰阶明显偏暗
- 本机截图显示正常
- 更换远控软件后问题仍存在
RustDesk 连接状态中可见远控流信息类似：
Codec: H265
Chroma: 4:2:0
但后续排查证明，编码格式和色度采样并非根因。
初步排查：确认 RustDesk 服务端状态
首先确认自建 RustDesk 服务端运行正常。
sudo systemctl status rustdesksignal.service --no-pager
sudo systemctl status rustdeskrelay.service --no-pager
服务状态正常：
rustdesksignal.service: active (running)
rustdeskrelay.service: active (running)
确认监听端口：
sudo ss -lntup | grep -E '34582|34581|34520'
结果显示：
udp UNCONN *:34582 hbbs
tcp LISTEN *:34582 hbbs
tcp LISTEN *:34581 hbbs
tcp LISTEN *:34520 hbbr
其中：
| 端口 | 服务 | 状态 |
|---|---|---|
| 34582/TCP | hbbs | 正常监听 |
| 34582/UDP | hbbs | 正常监听 |
| 34581/TCP | hbbs NAT test | 正常监听 |
| 34520/TCP | hbbr | 正常监听 |
进一步抓包确认外部客户端请求确实到达服务端：
sudo tcpdump -i any -nn 'tcp port 34582 or udp port 34582 or tcp port 34520'
抓包中可见外部地址访问 34582，且服务端正常回包。
结论：RustDesk 服务端、端口映射、防火墙和网络连通性均正常，画面异常与服务端无关。
排除编码和色度采样问题
针对远控画面发黑，首先测试了常见的远控画质相关选项：
- 关闭硬件编解码
- 切换 H.264 / H.265 / VP9
- 启用 4:4:4 真彩模式
- 调整画质策略
- 调整码率
- 重启 RustDesk 客户端
- 使用 ToDesk 复现
上述操作均未解决问题。
分析：
Chroma 4:2:0 只表示色度采样为 4:2:0。它通常会影响彩色边缘、文字边缘和细节锐度，不应导致灰阶整体大幅压暗。因此，画面发黑不应优先归因于 4:2:0。
排查控制端视频与图形栈
控制端环境为 ZorinOS 18.1 + AMD Radeon RX 580，因此继续排查 Linux 侧视频解码与渲染链路。
查看 GStreamer 相关插件：
gst-inspect-1.0 | grep -Ei 'vaapi|va-|vah264|vah265|h264|h265|hevc|glimage|ximage|gtk|wayland'
可见系统存在 AMD VA-API 解码器：
vah264dec: VA-API H.264 Decoder in AMD Radeon RX 580 Series
vah265dec: VA-API H.265 Decoder in AMD Radeon RX 580 Series
测试 GStreamer 基础视频输出：
gst-launch-1.0 -v videotestsrc pattern=smpte ! video/x-raw,width=1280,height=720,framerate=30/1 ! videoconvert ! ximagesink
gst-launch-1.0 -v videotestsrc pattern=smpte ! video/x-raw,width=1280,height=720,framerate=30/1 ! videoconvert ! glimagesink
同时测试 H.264 与 H.265 视频播放，均未出现色彩异常。
结论：
- 普通 H.264 视频播放正常
- 普通 H.265 视频播放正常
- GStreamer
ximagesink输出正常 - GStreamer
glimagesink输出正常 - AMD/Mesa/OpenGL 并非全局异常
- 显示器输出链路并非全局异常
定位异常特征：灰阶测试
在 Windows 11 被控端打开灰阶测试图，通过远控画面观察灰阶显示效果。
观察结果：
16 / 32：全黑
64：几乎全黑
128：深灰
192：浅灰
224：仍明显偏灰
255：纯白
分析：
该现象不是单纯的视频压缩问题，也不是 4:2:0 色度采样问题。灰阶图不依赖色度细节，若灰阶被整体压暗，通常意味着亮度、伽马或色彩空间映射发生异常。
可能方向包括：
黑位压缩
Gamma 映射错误
Full range / limited range 映射错误
sRGB / scRGB / HDR 色彩空间转换异常
Windows 色彩管理影响屏幕捕获链路
此时问题范围已从“远控画质问题”收敛为“被控端屏幕捕获或色彩管理链路异常”。
根因确认：Windows 11 自动管理应用颜色
最终在 Windows 11 被控端发现以下选项处于开启状态：
设置
→ 系统
→ 显示
→ 颜色配置文件
→ 自动管理应用颜色
关闭该选项后，重新连接 RustDesk / ToDesk，远控画面恢复正常。
结论：问题由 Windows 11 被控端启用“自动管理应用颜色”导致。
机制分析
“自动管理应用颜色”属于 Windows 11 的系统级颜色管理能力，目标是在不同色域、不同显示器、不同应用色彩空间之间自动进行颜色映射。
对普通本机显示而言，该功能用于改善广色域显示器上的颜色一致性。例如避免 sRGB 应用在广色域屏幕上显示过饱和。
但远控软件的工作方式不同。远控软件需要从系统捕获屏幕内容，再编码为视频流传输。
普通本机显示链路大致为：
应用输出画面
→ Windows 颜色管理
→ 显示到本机屏幕
远控链路则为：
应用输出画面
→ Windows 颜色管理 / HDR / ACM
→ 远控软件捕获屏幕
→ 编码为视频流
→ 控制端解码并显示
当 Windows 自动颜色管理介入后，远控软件可能捕获到已经被转换过的画面，或捕获到处于中间色彩空间的画面。随后远控软件仍按普通 SDR/sRGB 视频处理，最终导致控制端出现灰阶压缩、画面发黑和色彩失真。
为什么本机截图正常
本问题中，Windows 11 被控端本机截图显示正常，但远控画面异常。
这说明普通截图路径与远控软件的屏幕捕获路径并不完全一致。
可能情况包括：
| 路径 | 结果 |
|---|---|
| 本机显示 | 经系统颜色管理后正常显示 |
| 本机截图 | 获取到已正确处理的画面 |
| 远控捕获 | 捕获到受自动颜色管理影响的帧 |
| 远端显示 | 被当作普通 SDR 视频解码，出现亮度和色彩错误 |
因此，“本机截图正常”不能完全排除被控端捕获链路异常。
修复方案
方案 A：关闭自动管理应用颜色（推荐）
在 Windows 11 被控端关闭：
设置
→ 系统
→ 显示
→ 颜色配置文件
→ 自动管理应用颜色
关闭后重启远控软件，必要时重启 Windows。
方案 B：同时检查 HDR 与颜色相关选项
若关闭“自动管理应用颜色”后仍存在异常，继续检查：
HDR
Auto HDR
夜间模式
显示器 ICC 配置文件
显卡控制面板颜色范围
远控软件高性能捕获 / DirectX 捕获
建议测试时暂时使用最保守配置：
HDR：关闭
Auto HDR：关闭
自动管理应用颜色：关闭
显示器颜色配置：默认 sRGB 或厂商默认配置
远控软件：优先普通 SDR 捕获路径
同类问题判断方法
若出现以下现象，应优先检查 Windows 11 色彩管理相关设置：
本机画面正常
本机截图正常
远控画面明显发黑
录屏或串流颜色异常
灰阶 16/32 全黑
64 几乎全黑
128 明显偏暗
255 正常白
优先检查项：
自动管理应用颜色
HDR
Auto HDR
颜色配置文件
DirectX / 高性能屏幕捕获
不应优先归因于：
RustDesk 服务端
端口映射
防火墙
中继服务器
码率
4:2:0 色度采样
H.265 编码
Linux 显卡驱动
这些因素仍可能导致其他问题，但本案例中并非根因。
根本原因总结
| 层级 | 现象 | 原因 |
|---|---|---|
| Windows 色彩管理 | 自动管理应用颜色开启 | 系统对应用颜色进行自动映射 |
| 屏幕捕获 | 远控软件获取到异常色彩空间或已转换画面 | 捕获链路受系统色彩管理影响 |
| 视频传输 | 远控流仍按普通 SDR 视频处理 | 色彩空间信息未被正确保留或解释 |
| 控制端显示 | 灰阶压缩、画面发黑、色彩失真 | Gamma / range / 色彩空间映射错误 |
| 表现 | RustDesk / ToDesk 均复现 | 问题位于被控端系统捕获链路，而非单一远控软件 |
附：排查命令速查
RustDesk 服务状态
sudo systemctl status rustdesksignal.service --no-pager
sudo systemctl status rustdeskrelay.service --no-pager
服务端端口监听
sudo ss -lntup | grep -E '34582|34581|34520'
服务端抓包
sudo tcpdump -i any -nn 'tcp port 34582 or udp port 34582 or tcp port 34520'
GStreamer 插件检查
gst-inspect-1.0 | grep -Ei 'vaapi|va-|vah264|vah265|h264|h265|hevc|glimage|ximage|gtk|wayland'
GStreamer 测试图输出
gst-launch-1.0 -v videotestsrc pattern=smpte ! video/x-raw,width=1280,height=720,framerate=30/1 ! videoconvert ! ximagesink
gst-launch-1.0 -v videotestsrc pattern=smpte ! video/x-raw,width=1280,height=720,framerate=30/1 ! videoconvert ! glimagesink
最终结论
本案例中，RustDesk / ToDesk 远控画面发黑的根因是：
Windows 11 被控端开启了“自动管理应用颜色”，
导致远控软件屏幕捕获链路中的颜色映射异常，
最终控制端看到灰阶压缩、黑位压死和色彩失真。
解决方式：
关闭 Windows 11 的“自动管理应用颜色”
重启远控软件
重新连接
I HATE Windows dude...