Introduction

基于home-manager的用户级配置管理, ansible 管理系统包和github应用. 开发环境使用mise进行管理, 本仓库不涉及开发环境的管理.

使用指南

前置条件:

• nix
• home-manager

NOTE:

• home-manager通过nix flakes方式管理用户级配置.
• ansible 管理系统包和github应用
• 其它商业或特殊软件使用手动安装Manual Install.

1. 关闭SELINUX

永久关闭 - 需重启

sudo sed -i 's/^SELINUX=.*/SELINUX=disabled/' /etc/selinux/config

临时关闭 - 无需重启, 但重后会失效

sudo setenforce 0

2. 安装nix

• Install Nix
• 添加channel, nix-channel --add https://nixos.org/channels/nixos-unstable nixpkgs
• 更新channel, nix-channel --update
• 添加相关help文档, nix-env -i nix.

3. 安装home-manager

Install home-manager via nix flakes

home manager 切换

# username: thinkgos, system: ubuntu25_10
home-manager switch --flake .#thinkgo-laptop
# username: cors, system: ubuntu25_10
home-manager switch --flake .#cors-ubuntu25_10
# username: thinkgos, system: ubuntu25_10
home-manager switch --flake .#thinkgo-ubuntu25_10
# username: thinkgo, system: fedora-43
home-manager switch --flake .#thinkgo-fedora43

4. 设置默认shell为zsh

# 设置默认shell为zsh
sudo chsh -s ~/.nix-profile/bin/zsh $USER

5. 安装软件

ansible playbook 标签:

• system: 安装系统包
• github: 安装github应用

ansible-playbook site.yml -u <username> --tags system,github -K

系统

扩大 swap

# 查看当前swap配置
swapon --show
# 关闭swap
sudo swapoff /swap.img  # 这里的路径 swapon --show 的结果修改
# 删除旧的swap文件
sudo rm /swap.img
# 快速预留32G
sudo fallocate -l 32G /swap.img
# 只有root用户可读写
sudo chmod 600 /swap.img
# 格式化为swap格式
sudo mkswap /swap.img
# 启用swap
sudo swapon /swap.img
# 挂久化配置
# vim /etc/fstab

Manual Install

由于一些软件是商业软件或特殊限制, 需要从手动或从系统中安装.

• chrome 浏览器
• virtualbox 虚拟机
• wireshark 网络分析工具
• vnc-viewer VNC客户端
• gnome-browser-connector GNOME浏览器连接器
• vscode vscode代码编辑器
• claude-code code agent

按键绑定

标记:

• 无: ❌
• 禁用: 🚫
• 未配置: ◻️
• 已配置: ✅

NOTE: 由于GNOME不是平铺, 某些按键绑定不能完全一致.

系统

声音和媒体

截图

打字

启动器

工作区和窗口

导航

窗口

布局

Issue

1. 桌面端启动器找不到相关程序

XDG_DATA_DIRS 没有Nix对应路径

systemctl --user show-environment | grep XDG_DATA_DIRS

home-manager添加以下配置暂时解决

  xdg.enable = true;
  targets.genericLinux = {
    enable = true;
    gpu.enable = true;
  };

2. 桌面端启动器只有一部份显示

在1解决后, 仍有部份不显示, 主要是找不到二进制程序, 原因是PATH没有包含Nix对应路径.

 systemctl --user show-environment | grep PATH

• issues 1439
• BohdanTkachenko gist
• systemd/systemd#32423
• pr 7949

3. 禁用用户级IBus

systemctl --user mask org.freedesktop.IBus.session.GNOME.service

4. code出现sandbox权限问题

放开AppArmor权限

echo "kernel.apparmor_restrict_unprivileged_userns=0" | sudo tee /etc/sysctl.d/60-apparmor-namespace.conf

5. 用户目录名称改成英文

LANG=C xdg-user-dirs-gtk-update

6. 远程桌面在无显示器时无法使用

gsettings set org.gnome.desktop.remote-desktop.rdp screen-share-mode 'extend'

NOTE: 远程桌面在无显示器时无法使用, 需要在图形界面先进行登陆.(核心原因, 缺少图形会话)

Hyprland

1. 安装sddm启动hyprland出现白色面板

主要是sddm是有引入kde相关的依赖, 如xdg-desktop-portal-kde, xwaylandvideobridge.

# 查看系统级的自动启动项
ls /etc/xdg/autostart | grep videobridge

# 查看用户级的自动启动项
ls ~/.config/autostart | grep videobridge

# 查看是否作为 systemd 用户服务运行
systemctl --user list-unit-files | grep videobridge

# 完全清除 kde和xwaylandvideobridge
sudo apt purge xdg-desktop-portal-kde xwaylandvideobridge

hyprlock锁屏后无法登陆

权限和共享库问题, Hyprlock 没有权限通过 PAM 验证你的密码.

see issues 7027

# 找不到pam的相关库, 软链接过去
sudo ln -s /usr/lib/x86_64-linux-gnu/security /usr/lib/security
# 配置hyprlock的pam配置.
sudo bash -c 'cat > /etc/pam.d/hyprlock << EOF
#%PAM-1.0
auth    required        pam_unix.so
@include common-account
@include common-session
EOF'

home-manager 配置:

  programs.hyprlock = {
    enable = true;
        package = pkgs.hyprlock.overrideAttrs (oldAttrs: {
      nativeBuildInputs = oldAttrs.nativeBuildInputs ++ [ pkgs.patchelf ];
      postFixup = ''
        file="$out/bin/hyprlock"
        patchelf --replace-needed libpam.so.0 /usr/lib/x86_64-linux-gnu/libpam.so.0 "$file"
        patchelf --add-needed /usr/lib/x86_64-linux-gnu/libaudit.so.1 "$file"
        patchelf --add-needed /usr/lib/x86_64-linux-gnu/libcap-ng.so.0 "$file"
        patchelf --add-needed /usr/lib/x86_64-linux-gnu/libcrypt.so.1 "$file"
        patchelf --add-needed /usr/lib/x86_64-linux-gnu/libpam_misc.so.0 "$file"
        patchelf --add-needed /usr/lib/x86_64-linux-gnu/libcap.so.2 "$file"
      '';
    });
    # ...你的配置
  };

问题排查:

# 查看日志
sudo tail -f /var/log/auth.log
# 锁屏会话
loginctl lock-session

# 解锁会话
pkill -USR1 hyprlock

终端

按键绑定