在 openEuler Linux 上安装 Hyprland

Hyprland 是一个基于 Wayland 的现代动态平铺窗口管理器，支持动画、圆角、模糊效果和高可配置快捷键。
不过 openEuler 目前并没有官方 Hyprland 软件包，所以不建议直接照搬 Arch、Fedora 或 Debian 的安装命令。 更稳妥的做法是：优先源码编译安装，或者使用 Flatpak / AppImage 运行 Hyprland 相关组件。

1. 安装前的检查

Hyprland 必须在图形桌面环境下运行，openEuler 服务器版默认没有桌面，无法直接启动。

确认桌面环境：

echo $XDG_CURRENT_DESKTOP
echo $DISPLAY
echo $WAYLAND_DISPLAY

确认显卡：

lspci | grep -iE "vga|3d|display"

确认内核版本：

uname -r

Hyprland 需要 Wayland 支持，内核建议 5.18 以上，6.0 以上体验更好。

2. 安装基础依赖

openEuler 上可以先安装编译和 Wayland 相关依赖：

sudo dnf groupinstall -y "Development Tools"
sudo dnf install -y git cmake meson ninja-build pkg-config \
  wayland-devel wayland-protocols-devel \
  libxkbcommon-devel libdrm-devel libinput-devel \
  pixman-devel libxcb-devel libX11-devel \
  libXcursor-devel libXrandr-devel libXinerama-devel \
  mesa-libEGL-devel mesa-libGL-devel \
  fontconfig-devel pango-devel cairo-devel \
  libseat-devel seatd \
  qt5-qtwayland qt6-qtwayland

如果后续编译仍提示缺少头文件，可以用：

dnf provides */xxx.h

继续补装对应 -devel 包。

3. 方法一：源码编译安装 Hyprland

Hyprland 更新较快，源码安装可以拿到较新版本。

克隆仓库：

git clone --recursive https://github.com/hyprwm/Hyprland.git
cd Hyprland

编译并安装：

meson build
ninja -C build
sudo ninja -C build install

如果编译失败，建议先去掉并行参数，根据报错信息补装缺失依赖。

安装后还需要安装配套组件：

# 状态栏
sudo dnf install -y waybar

# 通知守护进程
sudo dnf install -y mako-notifier

# 壁纸工具
sudo dnf install -y hyprpaper

# 程序启动器
sudo dnf install -y wofi

# 终端模拟器
sudo dnf install -y kitty

这些包在 openEuler 中是否可用，以 dnf search 实际结果为准。

4. 方法二：使用 Flatpak 或 AppImage

如果不想编译，可以尝试通过 Flatpak 安装 Hyprland 相关组件，例如状态栏、壁纸工具、启动器等。

安装 Flatpak：

sudo dnf install -y flatpak
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo

然后在 Flathub 中搜索可用组件，例如：

flatpak search waybar
flatpak search hyprpaper
flatpak search wofi

但需要注意：Hyprland 合成器本身通常不能只靠 Flatpak 完整替代，它仍需要系统级 Wayland 会话支持。所以 Flatpak 更适合作为辅助组件安装方式。

5. 配置 Hyprland

首次登录后，Hyprland 通常会在：

~/.config/hypr/hyprland.conf

生成默认配置。较新版本也可能使用 Lua 配置。

可以先创建一个最小配置：

monitor=,preferred,auto,1

input {
    kb_layout = us
    follow_mouse = 1
}

general {
    gaps_in = 5
    gaps_out = 20
    border_size = 2
}

exec-once = waybar
exec-once = hyprpaper

默认快捷键通常是：

• Super + Q：打开终端
• Super + M：退出 Hyprland
• Super + 数字：切换工作区
• Super + Shift + 数字：移动窗口到工作区

具体以实际生成的配置文件为准。

6. NVIDIA 显卡注意事项

如果使用 NVIDIA 显卡，需要安装专有驱动，并启用 DRM modeset。

检查当前状态：

cat /sys/module/nvidia_drm/parameters/modeset

如果输出不是 Y，可以添加内核参数：

nvidia_drm.modeset=1

然后根据 openEuler 的引导方式更新 GRUB 配置。
同时建议设置环境变量：

export GBM_BACKEND=nvidia-drm
export WLR_RENDERER_ALLOW_SOFTWARE=1

NVIDIA 在 Wayland 合成器上的兼容性仍在持续完善，可能会出现闪屏、登录异常或应用兼容问题。

7. 常见问题

小结

在 openEuler 上安装 Hyprland，推荐流程是：

# 1. 安装依赖
sudo dnf groupinstall -y "Development Tools"
sudo dnf install -y wayland-devel wayland-protocols-devel libxkbcommon-devel libdrm-devel libinput-devel mesa-libEGL-devel seatd

# 2. 编译安装 Hyprland
git clone --recursive https://github.com/hyprwm/Hyprland.git
cd Hyprland
meson build
ninja -C build
sudo ninja -C build install

# 3. 安装配套组件
sudo dnf install -y waybar mako-notifier hyprpaper wofi kitty

# 4. 启动 Hyprland
Hyprland