Arch-Hyprland安装与配置完整指南

Arch-Hyprland是一个自动化安装脚本项目，专门用于在Arch Linux及其衍生发行版上安装现代化的Hyprland桌面环境。本指南将详细介绍项目的完整安装流程和配置方法。

项目结构概述

Arch-Hyprland项目采用模块化的脚本设计，主要包含以下核心组件：

• install.sh - 主安装脚本，提供交互式安装界面
• auto-install.sh - 自动克隆和安装脚本
• uninstall.sh - 卸载脚本，用于移除配置文件和恢复系统

安装脚本目录结构

install-scripts目录包含了所有功能模块的安装脚本：

• 00-base.sh - 基础包安装
• 01-hypr-pkgs.sh - Hyprland相关包安装
• hyprland.sh - Hyprland核心安装
• nvidia.sh - NVIDIA显卡驱动支持
• sddm.sh - SDDM登录管理器安装
• zsh.sh - Zsh shell配置
• pipewire.sh - 音频系统配置
• 各种系统监控脚本（电池、磁盘、温度监控）

安装前准备

系统要求

• 至少是服务器类型或最小化安装的Arch Linux系统
• 足够的磁盘空间和稳定的网络连接
• 建议先备份系统（使用timeshift或snapper）

重要注意事项

• 脚本将在安装过程中安装Pipewire音频系统，并可能禁用或卸载现有的PulseAudio
• 下载脚本到具有写入权限的目录，如HOME目录或其中的任何目录

安装方法

方法一：自动克隆安装（推荐）

使用以下命令自动克隆仓库并运行安装脚本：

sh <(curl -L https://raw.githubusercontent.com/JaKooLit/Arch-Hyprland/main/auto-install.sh)

注意：如果使用Fish Shell，请不要使用此方法，应手动克隆并运行install.sh。

方法二：手动克隆安装

如果需要更多控制权，可以手动克隆仓库：

git clone --depth=1 https://gitcode.com/gh_mirrors/ar/Arch-Hyprland.git ~/Arch-Hyprland
cd ~/Arch-Hyprland
chmod +x install.sh
./install.sh

配置选项详解

Hyprland Dots配置

本项目不包含实际的Hyprland配置文件。在安装过程中，如果选择复制预配置的dots，系统将从Hyprland-Dots仓库自动下载最新的配置文件。

这些配置包括：

• Rofi应用启动器设置
• Waybar状态栏主题
• 终端和Shell配置文件优化

音频系统配置

默认安装Pipewire音频系统，包括：

• pipewire
• wireplumber
• pipewire-audio
• pipewire-pulse

显示管理器选项

支持SDDM和GDM登录管理器，可选择安装SDDM主题和GTK主题。

NVIDIA显卡支持

• 默认安装nvidia-dkms驱动，支持GTX 900及更新显卡
• 如需使用nouveau驱动，请不要在选项中选择nvidia
• 支持较旧的NVIDIA显卡（驱动470系列）

安装后配置

Zsh Shell设置

安装程序应自动将默认shell更改为zsh。如果未更改，请手动执行：

chsh -s $(which zsh)
zsh
source ~/.zshrc

默认安装agnosterzak主题，可通过以下方式更改主题：

• 使用快捷键SUPER SHIFT O选择主题
• 手动编辑~/.zshrc文件中的ZSH_THEME设置

系统监控服务

项目提供了多个系统监控脚本，可在安装后根据需要单独运行：

• 电池监控：./install-scripts/battery-monitor.sh
• 磁盘监控：./install-scripts/disk-monitor.sh
• 温度监控：./install-scripts/temp-monitor.sh

这些脚本会自动安装所需包并创建用户级服务。

故障排除

常见问题解决

ROFI缩放问题 如果在已安装rofi的系统上遇到缩放问题，请卸载并重新安装：

sudo pacman -Rns rofi
sudo pacman -S rofi-wayland

NVIDIA用户登录问题 部分NVIDIA用户可能在SDDM登录时卡住，解决方案：

1. 在SDDM界面按Ctrl+Alt+F2或F3
2. 登录账户
3. 检查GPU设备信息并配置环境变量

Hyprland自动启动 默认情况下，Hyprland的自动启动功能已被禁用。如需启用，请编辑~/.zprofile文件，移除相关行的注释符号。

重新安装特定组件

如需重新安装特定组件，请从Arch-Hyprland目录运行相应脚本：

./install-scripts/gtk-themes.sh  # 重新安装GTK主题
./install-scripts/sddm.sh        # 重新安装SDDM

重要：不要进入install-scripts目录运行脚本，否则可能失败。

卸载流程

项目提供了卸载脚本uninstall.sh，但使用时需格外谨慎，因为可能导致系统不稳定。建议的最佳恢复方法是使用timeshift或snapper还原系统快照。

项目特色功能

多发行版兼容

脚本设计为跨Arch Linux衍生发行版兼容，支持Arco Linux、Manjaro等。

持续更新

Hyprland-Dots配置不断演进和改进，建议定期查看更新日志以了解最新功能。

完善的文档支持

项目提供详细的Wiki文档，包含快捷键绑定、常见问题解答等完整信息。

通过本指南，您可以顺利完成Arch-Hyprland的安装和配置，打造一个现代化、高效的桌面工作环境。