niri快速部署指南：5分钟完成可滚动平铺Wayland桌面环境

niri快速部署指南：5分钟完成可滚动平铺Wayland桌面环境

【免费下载链接】niriA scrollable-tiling Wayland compositor.项目地址: https://gitcode.com/GitHub_Trending/ni/niri

想要快速体验niri这款创新的可滚动平铺Wayland合成器？这篇零基础快速部署指南将带你用最简单的步骤完成一键安装配置。无论你是Linux新手还是经验丰富的用户，都可以轻松上手。

🚀 快速开始

niri是一款轻量级、高性能的Wayland桌面环境，特别适合追求效率和美观的用户。通过本指南，你只需5分钟就能搭建完整的桌面环境。

📦 一键安装方法

方法一：使用预编译二进制包（推荐）

对于大多数用户，我们建议直接下载预编译的二进制文件：

# 下载最新版本 wget https://gitcode.com/GitHub_Trending/ni/niri/-/releases/permalink/latest/downloads/niri-latest-x86_64.tar.gz # 解压并安装 tar -xzf niri-latest-x86_64.tar.gz cd niri-latest sudo ./install.sh

方法二：源码编译安装

如果你需要最新功能或自定义配置，可以通过源码编译：

# 克隆仓库 git clone https://gitcode.com/GitHub_Trending/ni/niri.git cd niri # 安装必要依赖 sudo apt-get install -y libudev-dev libgbm-dev libxkbcommon-dev libinput-dev libsystemd-dev # 编译安装 cargo build --release sudo cp target/release/niri /usr/local/bin/

⚙️ 基础配置

安装完成后，创建配置文件目录和基础配置：

# 创建配置目录 mkdir -p ~/.config/niri # 生成默认配置 niri --default-config > ~/.config/niri/config.kdl

🔧 核心功能配置

窗口管理配置

编辑配置文件~/.config/niri/config.kdl，添加以下基础配置：

// 基础窗口规则 window-rules { rule ".*" { open-on-output "current" open-on-workspace "current" } } // 键盘快捷键 bindings { Mod+Return spawn="alacritty" Mod+Q close-focused-window Mod+J focus-window left Mod+K focus-window down Mod+L focus-window up Mod+semicolon focus-window right }

工作区设置

workspaces { // 命名工作区 workspace "1" name="Web" workspace "2" name="Code" workspace "3" name="Terminal" }

🎯 最快配置方案

对于追求效率的用户，推荐以下精简配置：

layout { preset "main-and-vert-stack" preset "main-and-hori-stack" }

❓ 常见问题解决

1. 启动后黑屏怎么办？

检查显卡驱动是否正常，尝试重新启动niri：

niri --session

2. 如何添加自定义快捷键？

在配置文件的bindings部分添加新的绑定：

bindings { Mod+E spawn="firefox" Mod+C spawn="code" }

3. 如何退出niri？

使用快捷键Mod+Shift+E或在终端中执行：

pkill niri

4. 无法运行X11应用？

确保Xwayland已正确安装：

sudo apt install xwayland

📈 进阶使用指引

性能优化

启用硬件加速渲染：

debug { render-drm-device "/dev/dri/card0" }

插件扩展

niri支持丰富的插件系统，你可以根据需要添加：

• 状态栏插件
• 通知中心
• 应用启动器

✅ 验证安装成功

完成所有配置后，验证niri是否正常运行：

# 检查版本 niri --version # 启动会话 niri --session

🎉 恭喜完成！

现在你已经成功部署了niri桌面环境。这个轻量级的Wayland合成器将为你提供流畅的工作体验。记住：

• ✅ 配置保存在~/.config/niri/config.kdl
• ✅ 日志文件在系统日志中查看
• ✅ 遇到问题可以重置配置文件重新开始

继续探索niri的更多高级功能，打造属于你的完美桌面环境！

【免费下载链接】niriA scrollable-tiling Wayland compositor.项目地址: https://gitcode.com/GitHub_Trending/ni/niri