Hello Arch + Niri

681 字

3 分钟

Hello Arch + Niri

2025-12-25

杂项

Linux

这是一份我在 Arch Linux 上搭建 niri 桌面环境的完整记录。内容包含：系统与引导器、核心软件、常用快捷键、坑位与修复方案（例如飞书共享屏幕），并尽量做到“可复现”。

0. 环境概览#

系统：Arch Linux（UEFI）
桌面：niri（Wayland）
登录管理器：SDDM（自定义主题）
引导器：systemd-boot

1. 引导器：从 GRUB 迁移到 systemd-boot#

loader.conf#

1
default arch.conf
2
timeout 0
3
console-mode max

启动项#

1
title   Arch Linux
2
linux   /vmlinuz-linux
3
initrd  /amd-ucode.img
4
initrd  /initramfs-linux.img
5
options root=UUID=ee47c9bd-01d0-425e-83f5-1627a27c7a78 rw quiet splash rd.systemd.show_status=false rd.udev.log_level=3

2. Shell 与终端#

Shell：zsh
Oh My Zsh + powerlevel10k
即时提示设置为 quiet，避免 zsh 启动警告

1
typeset -g POWERLEVEL9K_INSTANT_PROMPT=quiet
2
ZSH_THEME="powerlevel10k/powerlevel10k"
3
plugins=(git zsh-autosuggestions zsh-syntax-highlighting)

终端：Ghostty#

1
font-family = Maple Mono NF CN
2
font-size = 14

3. niri 核心配置#

配置文件：

~/.config/niri/config.kdl
~/.config/niri/binds.kdl
~/.config/niri/output.kdl

3.1 显示器#

只固定外接屏刷新率，其他保持自动：

1
output "HDMI-A-1" {
2
    mode "1920x1080@100.000"
3
}

3.2 桌面 Shell / Bar#

1
spawn-sh-at-startup "qs -c noctalia-shell"

Noctalia 性能优化（内存占用下降）#

我在 noctalia-shell 上关闭了动画与阴影后，内存占用明显下降，体验更稳定。

1
"general": {
2
  "animationDisabled": true,
3
  "enableShadows": false
4
}

3.3 锁屏#

手动锁屏走 noctalia：

1
Mod+Alt+L { spawn "qs" "-c" "noctalia-shell" "ipc" "call" "lockScreen" "lock"; }

自动锁屏仍用 swayidle 触发：

1
exec swayidle -w \
2
  timeout 300  'qs -c noctalia-shell ipc call lockScreen lock' \
3
  timeout 600  'niri msg action power-off-monitors' \
4
  resume       'niri msg action power-on-monitors' \
5
  timeout 1200 'systemctl suspend'

4. 常用快捷键（节选）#

启动器与工具#

Super+T：Ghostty
Super+Z：noctalia launcher
Super+Alt+L：锁屏（noctalia）
Super+Alt+V：剪贴板

音量/亮度#

XF86Audio*：音量/静音/媒体
XF86MonBrightness*：亮度

截图（grim + slurp + satty）#

Print：全屏截图并编辑
Shift+Print / Sys_Req：区域截图并编辑
Ctrl+Print：窗口截图并编辑
Super+Shift+A：区域截图并编辑

5. 输入法与主题#

Fcitx5#

1
Theme=Matugen
2
DarkTheme=Matugen
3
Vertical Candidate List=False

系统深色模式#

1
gsettings set org.gnome.desktop.interface color-scheme 'prefer-dark'

6. 浏览器与触控板#

Chrome 触控板前进/后退#

1
--enable-features=TouchpadOverscrollHistoryNavigation

触控板滚动灵敏度#

1
scroll-factor horizontal=0.3 vertical=0.3

7. 飞书相关问题与解决#

7.1 Dock 出现灰色 + 问号双图标#

原因：Wayland 下飞书窗口 app_id 为空，dock 无法正确匹配。

解决：强制 Feishu 走 XWayland：

1
--ozone-platform=x11

然后在 noctalia 的固定项里用一致的 app_id：

1
"pinnedApps": [
2
  "...",
3
  "Feishu"
4
]

7.2 飞书屏幕共享（niri）#

GNOME portal 在 niri 下无法正确获取窗口列表，导致屏幕共享失败。

最终方案：

默认 portal 走 gnome/gtk
屏幕共享走 hyprland portal

1
[preferred]
2
default=gnome;gtk;
3
org.freedesktop.impl.portal.Access=gtk;
4
org.freedesktop.impl.portal.Notification=gtk;
5
org.freedesktop.impl.portal.Secret=gnome-keyring;
6
org.freedesktop.impl.portal.ScreenCast=hyprland;
7
org.freedesktop.impl.portal.RemoteDesktop=hyprland;

niri 启动时拉起 hyprland portal：

1
spawn-sh-at-startup "dbus-update-activation-environment --systemd WAYLAND_DISPLAY XDG_CURRENT_DESKTOP=niri & /usr/lib/xdg-desktop-portal-hyprland"

结果：

屏幕共享可用
窗口级共享在 niri 下仍可能不可用（portal 限制）

8. 小结#

这套配置的目标是：

保留 niri 的轻量与灵活
让日常工具稳定可用（飞书/浏览器/输入法）
关键操作有明确快捷键

如果将来要迁移或复现，只需要同步这些配置文件即可。

Hello Arch + Niri

https://bangwu.top/posts/arch-niri-setup/

作者

棒无

发布于

2025-12-25

许可协议

CC BY-NC-SA 4.0

Caddy 最佳实践与演进史