UVR5 Linux 安装教程：源码部署与依赖配置

UVR5 没有提供 Linux 图形安装包，官方推荐通过源码方式运行。整个过程不算复杂：装好依赖、克隆仓库、安装 Python 依赖包、执行启动脚本，四步就能跑起来。以下命令以 Debian/Ubuntu 系为例，其他发行版替换对应包管理器即可。

第一步：安装系统依赖

Debian、Ubuntu 与 Linux Mint 用户执行：sudo apt update，然后 sudo apt install ffmpeg python3-pip python3-tk git。Fedora 用户需要先启用 RPMFusion 软件源，再执行 sudo dnf install ffmpeg python3-pip python3-tkinter git。Arch Linux 与 Manjaro 用户执行 sudo pacman -S ffmpeg python-pip tk git。

第二步：克隆仓库

在终端执行 git clone https://github.com/Anjok07/ultimatevocalremovergui，把官方仓库克隆到本地，然后 cd 进入项目目录。国内网络克隆缓慢时，可以使用镜像加速站点复制仓库地址克隆。

第三步：安装 Python 依赖

在项目目录内执行 pip3 install -r requirements.txt。如果你的系统 Python 是较新版本，个别包编译报错时，建议先创建虚拟环境（python3 -m venv venv 并激活）再安装，避免污染系统环境，也能避开部分发行版对系统 pip 的限制。

第四步：启动软件

执行 python3 UVR.py 即可启动图形界面。之后每次使用都重复这一步，也可以自己写一个 shell 别名。首次启动时软件会初始化并下载运行组件，请保持网络畅通。

显卡加速说明

Linux 下使用 NVIDIA 显卡加速需要确保驱动正常安装。UVR5 首次以 GPU 模式启动时会自动拉取对应的推理后端；如果启动时报 CUDA 相关错误，先检查 nvidia-smi 是否能正常输出，再确认驱动版本与软件要求匹配。AMD 显卡用户以 CPU 模式运行为主。

图形界面之外的选择

部分 Linux 用户更偏好无图形界面的工作流：Demucs 的命令行版本可以脱离 UVR5 直接通过 pip 安装使用，适合写脚本做服务器端批量处理；Spleeter 也提供了纯命令行的轻量分离方案。这些方案与 UVR5 使用的是同一批开源模型，音质特征一致，区别在于缺少图形界面的模型管理与集成模式。想横向了解三者差异，请阅读知识百科栏目的工具对比一篇。

常见报错处理

• 提示 tk 相关模块缺失：说明没有安装 python3-tk 或 python3-tkinter，图形界面依赖它。
• ffmpeg 未找到：确认 ffmpeg 已安装且在 PATH 中，执行 ffmpeg -version 能正常输出即可。
• pip 安装超时：换用国内镜像源，例如在命令后加 -i 参数指定镜像地址。
• 启动后模型列表为空：属正常现象，需在软件内手动下载模型，方法见模型大全栏目。