# 6.4 KDE 6 桌面环境（Wayland 会话）

## Wayland 会话环境概述

Wayland 作为新一代显示服务器协议，相比传统的 X11 协议在架构设计与安全性方面具有多项技术优势。本节系统阐述在 FreeBSD 操作系统中配置 KDE 6 Wayland 会话的具体方法与相关注意事项。

由于 issue [Request to restore support for vboxvideo and vmwgfx DRM drivers #356](https://github.com/freebsd/drm-kmod/issues/356) 尚未得到解决（FreeBSD DRM 驱动的移植仅覆盖了 Intel、AMD 和 NVIDIA 等 GPU），故在 VMware、VirtualBox 或任何基于 Virtio 的虚拟机上均无法复现本教程。需在真实的物理机上进行操作。

NVIDIA 显卡尚未经过测试。本文使用 Intel 第 12 代处理器（i7-1260P）的集成显卡进行测试。

请参照其他章节内容自行 **安装** DRM、KDE 6、Fcitx 5、Firefox 浏览器等软件包。**并配置 DRM 显卡驱动。** 其余软件包暂且 **不要** 进行任何配置，**仅安装** 即可。请确保将用户加入 video 组。

## 用户权限配置：加入 video 组

将指定用户加入 video 组以获得调用显卡设备的权限：

```sh
# pw groupmod video -m 你的用户名
```

## seatd 相关

### 安装 seatd

seatd 是一个 seat 管理守护进程，用于在非 systemd 环境下管理 Wayland 会话和设备访问。

* 使用 pkg 安装：

```sh
# pkg install seatd
```

* 或通过 Ports 安装：

```sh
# cd /usr/ports/sysutils/seatd/ 
# make install clean
```

### 配置 seatd 服务

添加并启用服务：

```sh
# service dbus enable # 设置 D-Bus 服务开机自启
# service seatd enable # 设置 Seatd 服务开机自启
```

## 启动 KDE 6

### 方法 ① SDDM

设置 SDDM 服务开机自启：

```sh
# service sddm enable
```

通过使用 SDDM 登录管理器启动 KDE，在登录界面选择“Wayland”会话。

### 方法 ②：通过脚本启动

* 在 `~/` 下新建脚本 `kde.sh`：

```sh
#! /bin/sh
export LANG=zh_CN.UTF-8 # 设置中文，Fcitx 需要
export LANGUAGE=zh_CN.UTF-8 # 设置中文，Fcitx 需要
export LC_ALL=zh_CN.UTF-8 # 设置中文，Fcitx 需要
export XMODIFIERS='@im=fcitx' # Fcitx 需要
/usr/local/bin/ck-launch-session /usr/local/lib/libexec/plasma-dbus-run-session-if-needed /usr/local/bin/startplasma-wayland # 启动桌面的命令
```

* 授予 `~/kde.sh` 可执行权限：

```sh
$ chmod 755 ~/kde.sh
```

> **注意**
>
> 必须停止 SDDM 服务才能使用该脚本。请检查 `/etc/rc.conf` 是否有 `sddm_enable="YES"` 字样，如有请删除。按快捷键 Ctrl+Alt+F2 进入 TTY，登录 root 后输入 `service sddm stop` 停止 SDDM 服务。

* 进入 KDE

此时应在 TTY 界面以普通用户身份登录，且没有任何 X11 会话正在运行（如存在，请禁用相关服务并重启再试）。

```sh
$ sh ~/kde.sh
```

## 图示

![在 FreeBSD 上通过 Wayland 运行 KDE6](https://338876981-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCJR3FQGH1PkdRtOljuxb%2Fuploads%2Fgit-blob-edb290778c2dcf0a5096c372cf45c2eaa00e38d3%2Fkde-Wayland1.png?alt=media)

> **技巧**
>
> 上图显示为“Intel UHD Graphics”而非“Iris Xe Graphics”，这是因为系统未启用某些硬件加速特性（与内存配置有关）~~笔者无力购买第二根 DDR5 内存条~~。参见：Intel® Iris® Xe Graphics Shows As Intel® UHD Graphics in the Intel® Graphics Command Center and Device Manager\[EB/OL]. \[2026-03-26]. <https://www.intel.com/content/www/us/en/support/articles/000059744/graphics.html> （网站对应页面的中文翻译不正确）。

* 显示当前会话类型（如 X11 或 wayland）

```sh
# echo $XDG_SESSION_TYPE
```

![检查当前是否位于 Wayland](https://338876981-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCJR3FQGH1PkdRtOljuxb%2Fuploads%2Fgit-blob-3850cbea41ac42d3cda84b28e7088fe17913b011%2Fkde-Wayland2.png?alt=media)

## 配置 Fcitx 5

> **技巧**
>
> 经测试 IBus 亦可用，且无需配置。

配置 Fcitx 5 自动启动：

```sh
$ mkdir -p ~/.config/autostart/ # 创建自启动目录
$ cp /usr/local/share/applications/org.fcitx.Fcitx5.desktop ~/.config/autostart/ # 系统启动时自动启动 Fcitx 5
```

初次进入 KDE Wayland 桌面时，KDE 会在右下角提示需在设置的虚拟键盘中进行配置才能启用输入法。请留意该提示。若未进行此设置，将无法切换输入法或输入中文。

![KDE Wayland 设置](https://338876981-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCJR3FQGH1PkdRtOljuxb%2Fuploads%2Fgit-blob-3437653b0b8c08893ee07625b4e9f0ba70e61d06%2Fkde-Wayland-fcitx.png?alt=media)

打开 KDE 系统设置：找到“键盘”→“虚拟键盘”

![虚拟键盘](https://338876981-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCJR3FQGH1PkdRtOljuxb%2Fuploads%2Fgit-blob-3d34003b3a5140c01e824fb9ed3784fc10c5c56c%2Fkde-Wayland3-1.png?alt=media)

选择“Fcitx 5 Wayland 启动器（实验性）”

![Fcitx 5 Wayland 启动器（实验性）](https://338876981-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCJR3FQGH1PkdRtOljuxb%2Fuploads%2Fgit-blob-4856ea358adabe7f74c827b35b86b246bbc5a9ab%2Fkde-Wayland5.png?alt=media)

经测试，在 Konsole 终端、Firefox 和 Chromium（使用 `chrome --no-sandbox` 启动）中均可输入中文。

![Wayland Fcitx 5 演示](https://338876981-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCJR3FQGH1PkdRtOljuxb%2Fuploads%2Fgit-blob-66ef699f1506b68a2cabd25ccff24df9df565ec2%2Fkde-Wayland4.png?alt=media)

## 视频播放测试

![Wayland 视频播放测试](https://338876981-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCJR3FQGH1PkdRtOljuxb%2Fuploads%2Fgit-blob-3ee5d429b5c3a1920fc7d9e9f1b97faebbd1b08d%2Fkde-Wayland9.png?alt=media)

## 故障排除与未竟事宜

### 在 root 下无声音

表现为右下角声音控件提示“未连接到音频服务”：可设置 PulseAudio 自启动，方法是在 KDE 设置中添加该服务并赋予可执行权限。

## 参考文献

* Euroquis. KDE Plasma 6 Wayland on FreeBSD\[EB/OL]. \[2026-03-25]. <https://euroquis.nl/kde/2025/09/07/wayland.html>. 提供了在 FreeBSD 上配置 KDE Plasma 6 Wayland 会话的技术指南，明确指出 seatd 服务的必要性。

## 课后习题

1. 优化在 Wayland 上 KDE 的使用体验。
2. 适配 PipeWire 音频。