这是一个事实：Wayland 正在逐步成为主流的显示服务器协议。目前，大多数 Linux 发行版已将 Wayland 作为默认显示服务器。
随着 Linux 合成器（compositor）不断扩展其远程桌面能力，TeamViewer 对 Wayland 的支持也在持续演进。由于不同的 Wayland 实现差异较大，TeamViewer 会根据所使用的合成器采用不同的集成方式。
注意：在开始之前，请确保您正在使用 最新版本的 TeamViewer。您可以按照下方相关文章中的说明更新 TeamViewer 客户端。
通过储存库更新 Linux 版的 TeamViewer
Wayland 支持的通用方案
基于门户的兼容模式（xdg-desktop-portal）
TeamViewer 使用 xdg-desktop-portal 提供的功能来实现屏幕共享和远程输入。这些功能必须由合成器本身实现。目前，GNOME 和 KDE Plasma 已支持所需的门户功能，可用于有人值守的会话。许多其他合成器已将相关实现纳入其路线图。
基于门户集成的限制
门户行为受 Wayland 安全模型的限制，常见限制包括：
- 不支持无人值守访问 → 首次连接需要用户确认 → 无法进行系统级或登录前的远程控制
- 不同合成器之间的行为存在差异
权限设置
根据所使用的合成器，TeamViewer 可提供半无人值守访问。您可以选择保存权限，以便后续会话无需再次交互；否则，每次连接都需要用户确认。
GNOME | KDE |
|---|
|
|
基于 wlroots 的集成
基于 wlroots 构建的合成器可以在无需确认提示的情况下提供无人值守访问。TeamViewer 已在以下环境中测试了该集成方式：Sway, labwc 和 Wayfire。无需进行额外配置。
当前限制
该集成方式仍处于实验阶段。不同 wlroots 合成器之间的行为可能有所不同，且可能出现意外问题或崩溃。我们欢迎并感谢用户反馈。
合成器相关说明
GNOME
GNOME 支持门户，并通过确认提示启用交互式远程会话。
- 无人值守访问支持非常有限
- 无法访问锁屏界面和登录界面
- 仅支持单显示器配置
- 显示布局发生变化后，权限可能会失效
KDE Plasma
KDE 提供了更灵活的门户行为，通常会直接授予访问权限，而无需选择显示器。
- 有限的无人值守访问
- 后续会话可在无需交互的情况下启动
- 支持在锁屏界面进行远程控制
- Wayland 下不支持登录界面访问
基于 wlroots 的合成器
（例如：Raspberry Pi OS 12 及更高版本）
- 无需额外配置即可进行无人值守访问
- 该集成方式为实验性
- 不同合成器之间的行为可能不同
- 可能出现崩溃或异常行为
欢迎提供反馈！
已知问题与故障排除
GNOME 显示配置变更
调整显示器布局（例如添加、移除或重新排序显示器）可能会导致此前授予的权限失效。
TeamViewer 会尝试检测此类情况并请求重新授权。
如果远程端看到黑屏，且未出现新的授权提示，请重置配置。
您可以使用以下命令行操作（内置的重置机制正在规划中）：
sudo teamviewer daemon stop && sudo sed -i.bak '/XDGRestoreTokens/d' "/etc/teamviewer/global.conf" && sudo teamviewer daemon start
KDE 权限持久性问题
在某些 KDE 系统中，无论用户是否选择保存权限，系统都会返回一个“restore token”。由于 TeamViewer 无法区分用户的实际选择，因此不会再次弹出确认提示。这可能是 KDE 的一个缺陷，也可能是其有意的设计选择。
实验状态与未来路线图
由于门户和各类合成器的行为差异较大，且仍在持续开发中，TeamViewer 的 Wayland 支持目前仍被视为实验性功能。当前的开发重点包括：改进基于门户的功能，在基于 wlroots 的环境中扩展无人值守访问，推动 GNOME 和 KDE 的完整无人值守支持。
对于需要高度可靠、稳定的无人值守访问的环境，Xorg 仍然是推荐的显示服务器。
