eGPU切换器在Linux上的安装与使用教程

本教程基于GitHub上的开源项目egpu-switcher，旨在帮助您理解并使用该工具来轻松管理您的外置显卡（eGPU）在Linux系统下的配置。eGPU-switcher是一个跨发行版的脚本，支持NVIDIA和AMD显卡，简化了在Linux桌面环境中利用eGPU的流程。

1. 项目目录结构及介绍

egpu-switcher项目的目录布局高效且有序，下面是主要目录及文件的简要说明：

• cmd: 包含主执行程序的代码。
• internal: 内部使用的工具或辅助函数。
• pkg/aur: 若适用，与Arch User Repository相关的脚本或配置。
• FUNDING.yml: 支持该项目的资金信息。
• LICENSE: 许可证文件，声明该项目遵循GPL-3.0许可协议。
• Makefile: 构建和安装规则的Makefile。
• README.md: 项目的主要说明文档，介绍了安装方法、使用说明等。
• TROUBLESHOOT.md: 遇到问题时可以参考的故障排除指南。
• config.yaml示例配置文件可能不在根目录，但作为文档提及，位于安装后的 /etc/egpu-switcher/ 目录下。

2. 项目启动文件介绍

egpu-switcher的核心在于其命令行界面（CLI）。没有特定的“启动文件”，而是通过命令行直接调用egpu-switcher命令进行操作。其中，最重要的启动操作是通过以下命令之一：

• 启用服务: sudo egpu-switcher enable
• 禁用服务: sudo egpu-switcher disable

这些命令控制脚本是否在系统启动时自动运行，并非指向单一的启动文件路径。

3. 项目的配置文件介绍

配置文件默认创建于/etc/egpu-switcher/config.yaml。此文件自动生成且包含了关键设置，例如所选择的外部显卡驱动信息(driver)和设备ID(id)。配置中的其他可选项包括：

• nomodesetting: 控制是否加载'modesetting'，以避免潜在的冲突。
• detection.retries 和 detection.interval: 定义了检测eGPU连接的重试次数和每次检查的间隔时间（以毫秒计）。
• hooks: 允许定义在切换到eGPU或内部显卡后执行的脚本路径，确保具有root权限且权限正确设置。

实践指导

自动安装（适用于某些Linux发行版）

• 对于Arch Linux用户，可以通过AUR安装：paru -S egpu-switcher。
• Ubuntu用户需手动下载并配置，首先获取二进制文件然后移至系统目录并赋予相应权限。

手动配置步骤概览

1. 下载最新版本的二进制文件。
2. 复制到/opt目录：sudo cp <downloaded-binary> /opt/egpu-switcher。
3. 设置权限：sudo chmod 755 /opt/eggpu-switcher。
4. 创建符号链接以便全局访问：sudo ln -s /opt/egpu-switcher /usr/bin/egpu-switcher。
5. 使用命令sudo egpu-switcher enable启用服务，并通过config命令配置eGPU。

记住，每次系统启动时，egpu-switcher将自动检查eGPU状态，并按配置进行相应的Xorg配置调整，无需用户干预，除非有特殊需求或遇到故障情况。遵循上述步骤，您应该能够成功设置并利用egpu-switcher来优化您的Linux eGPU体验。