# 6.6.使用 Xwayland

在安装 Wayland 时，除非 Wayland 是在没有 X11 支持的情况下构建的，否则 `Xwayland` 二进制文件应该已经安装。如果 `/usr/local/bin/Xwayland` 文件不存在，请使用以下命令安装它：

```sh
# pkg install xwayland
```

> **注意**
>
> 推荐使用 Xwayland 的开发版本，并且它很可能与 Wayland 包一起安装。每个合成器都有启用或禁用此功能的方法。

安装 `Xwayland` 后，需要在所选合成器中进行配置。对于 Wayfire，在 `wayfire.ini` 文件中需要添加以下行：

```ini
xwayland = true
```

对于 Sway 合成器，`Xwayland` 应该默认启用。即使如此，建议手动在 `~/.config/sway/config` 中添加以下配置行：

```ini
xwayland enable
```

最后，对于 Hikari，不需要做任何更改。默认情况下，`Xwayland` 的支持已内建。如果需要禁用该支持，可以从 Ports 重新构建该包，并在此时禁用 `Xwayland` 支持。

完成这些更改后，启动合成器并通过键绑定执行一个终端。在此终端中，执行 `env` 命令并搜索 `DISPLAY` 变量。如果合成器能够正确启动 `Xwayland` X 服务器，则这些环境变量应该类似于以下内容：

```sh
% env | grep DISPLAY
```

```sh
WAYLAND_DISPLAY=wayland-1
DISPLAY=:0
```

在此输出中，显示了默认的 Wayland 显示器和为 `Xwayland` 服务器设置的显示器。验证 `Xwayland` 是否正常工作的另一种方法是安装并测试一个小的包：\[x11/eyes]，并检查输出。如果 `xeyes` 应用程序启动并且眼睛跟随鼠标指针，则说明 `Xwayland` 正常工作。如果出现如下错误，说明在 `Xwayland` 初始化期间发生了问题，可能需要重新安装：

```sh
Error: Cannot open display wayland-0
```

> **警告**
>
> Wayland 的一个安全特性是，在没有运行 X 服务器的情况下，不会有其他网络监听程序。待启用 `Xwayland`，此安全特性不再适用于系统。

对于某些合成器，如 Wayfire，`Xwayland` 可能无法正确启动。因此，`env` 会显示以下 `DISPLAY` 环境变量信息：

```sh
% env | grep DISPLAY
```

```sh
DISPLAY=wayland-1
WAYLAND_DISPLAY=wayland-1
```

尽管已经安装并配置了 `Xwayland`，X11 应用程序仍然无法启动，并会出现显示问题。为了解决这个问题，需要验证是否已经有一个通过 UNIX 套接字运行的 `Xwayland` 实例。首先，检查 `sockstat` 的输出并搜索 X11-unix：

```sh
% sockstat | grep x11
```

输出应该类似于以下信息：

```sh
trhodes  Xwayland   2734  8  stream /tmp/.X11-unix/X0
trhodes  Xwayland   2734  9  stream /tmp/.X11-unix/X0
trhodes  Xwayland   2734  10 stream /tmp/.X11-unix/X0
trhodes  Xwayland   2734  27 stream /tmp/.X11-unix/X0_
trhodes  Xwayland   2734  28 stream /tmp/.X11-unix/X0
```

这表明存在一个 X11 套接字。可以进一步通过在合成器下的终端仿真器中尝试手动执行 `Xwayland` 来验证这一点：

```sh
% Xwayland
```

如果已经有一个 X11 套接字可用，用户会看到以下错误：

```sh
(EE)
Fatal server error:
(EE) Server is already active for display 0
	If this server is no longer running, remove /tmp/.X0-lock
	and start again.
(EE)
```

由于已经有一个活跃的 X 显示器（显示号为 0），因此环境变量设置不正确。要修复此问题，可以将 `DISPLAY` 环境变量更改为 `:0` 并重新尝试执行该应用程序。以下示例使用 [mail/claws-mail](https://cgit.freebsd.org/ports/tree/mail/claws-mail/) 作为需要 `Xwayland` 服务的应用程序：

```sh
export DISPLAY=:0
```

做出此更改后，[mail/claws-mail](https://cgit.freebsd.org/ports/tree/mail/claws-mail/) 应用程序应该能够使用 `Xwayland` 启动并按预期工作。