02 - 安装与配置
02 - 安装与配置
在主流 Linux 发行版上安装 EasyEffects，配置 Flatpak 或原生包管理器，并完成初始设置。
2.1 前置条件检查
在安装 EasyEffects 之前，需要确认系统满足以下条件：
检查音频服务器
# 检查是否运行 PipeWire
pactl info | grep "Server Name"
# 期望输出: Server Name: PulseAudio (on PipeWire x.x.x)
# 或者直接检查 PipeWire 进程
systemctl --user status pipewire pipewire-pulse wireplumber
如果输出显示 PulseAudio 而非 PipeWire，说明系统仍在使用 PulseAudio，需要先迁移。
检查 PipeWire 版本
pw-cli info 0 | grep version
# 期望版本: >= 0.3.49
检查内核版本
uname -r
# 推荐: >= 5.15（低延迟内核更好）
前置条件检查清单
| 检查项 | 命令 | 期望结果 |
|---|---|---|
| 音频服务器 | pactl info | grep "Server Name" | 包含 PipeWire |
| PipeWire 版本 | pw-cli info 0 | grep version | ≥ 0.3.49 |
| WirePlumber | wpctl status | 正常输出设备列表 |
| 内核版本 | uname -r | ≥ 5.15 |
| 声卡检测 | aplay -l | 列出可用声卡 |
| 麦克风检测 | arecord -l | 列出可用录音设备 |
2.2 安装 PipeWire（如未安装）
如果你的系统尚未使用 PipeWire，以下是在主流发行版上迁移的方法。
Fedora（35+ 默认 PipeWire）
# Fedora 35+ 已默认使用 PipeWire，通常无需额外操作
# 确认安装
sudo dnf install pipewire pipewire-pulseaudio wireplumber
# 重启后检查
systemctl --user status pipewire pipewire-pulse wireplumber
Ubuntu / Debian
# Ubuntu 22.10+ / Debian 12+ 可通过包管理器安装
sudo apt install pipewire pipewire-pulse wireplumber
# 对于 Ubuntu 22.04 LTS，需要添加 PPA
sudo add-apt-repository ppa:pipewire-debian/pipewire-upstream
sudo apt update
sudo apt install pipewire pipewire-pulse wireplumber
Arch Linux
sudo pacman -S pipewire pipewire-pulse wireplumber pipewire-alsa
openSUSE
sudo zypper install pipewire pipewire-pulseaudio wireplumber
迁移后验证
# 重启 PipeWire 服务
systemctl --user restart pipewire pipewire-pulse wireplumber
# 验证
pactl info | grep "Server Name"
# 期望: Server Name: PulseAudio (on PipeWire x.x.x)
注意: 从 PulseAudio 迁移到 PipeWire 后，原有的 PulseAudio 配置文件（
~/.config/pulse/）可能需要清理，以避免冲突。
2.3 安装 EasyEffects
方式一：Flatpak（推荐）
Flatpak 是安装 EasyEffects 的最佳方式，因为它自带所有依赖，不受发行版版本限制。
# 安装 Flatpak（如未安装）
# Fedora
sudo dnf install flatpak
# Ubuntu
sudo apt install flatpak
# Arch
sudo pacman -S flatpak
# 添加 Flathub 仓库
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
# 安装 EasyEffects
flatpak install flathub com.github.wwmm.easyeffects
# 运行
flatpak run com.github.wwmm.easyeffects
Flatpak 权限配置:
# 确保 Flatpak 版 EasyEffects 可以访问 PipeWire
# 通常 Flatpak 会自动处理，但如遇问题可手动授权
flatpak override --user com.github.wwmm.easyeffects --filesystem=xdg-run/pipewire-0
方式二：原生包管理器
Fedora
sudo dnf install easyeffects
Ubuntu（22.10+）
sudo apt install easyeffects
Arch Linux
sudo pacman -S easyeffects
openSUSE
sudo zypper install easyeffects
方式三：源码编译
适用于需要最新开发版或自定义编译选项的用户。
# 安装构建依赖（以 Fedora 为例）
sudo dnf install meson gcc-c++ gtk4-devel libadwaita-devel \
pipewire-devel gstreamer1-devel gstreamer1-plugins-base-devel \
libsamplerate-devel libsndfile-devel libbs2b-devel \
rubberband-devel speexdsp-devel rnnoise-devel \
fftw-devel lilv-devel lv2-devel ladspa-devel \
libebur128-devel nlohmann-json-devel
# 克隆源码
git clone https://github.com/wwmm/easyeffects.git
cd easyeffects
# 构建
meson setup build
ninja -C build
# 安装
sudo ninja -C build install
安装方式对比
| 对比维度 | Flatpak | 原生包 | 源码编译 |
|---|---|---|---|
| 依赖管理 | 自带所有依赖 | 需手动安装 | 需手动安装 |
| 版本更新 | 及时 | 跟随发行版 | 最新开发版 |
| 磁盘占用 | 较大（~200MB） | 较小（~30MB） | 较小 |
| 插件支持 | 内置 | 需额外安装 | 按需编译 |
| 推荐程度 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐ |
2.4 额外插件安装
EasyEffects 依赖 GStreamer 的插件生态系统。为获得最丰富的效果器，建议安装以下额外插件：
LADSPA / LV2 插件
# Fedora
sudo dnf install \
swh-plugins \
rubberband-ladspa \
lsp-plugins \
calf-studio-gear-plugins \
zam-plugins \
x42-plugins
# Ubuntu
sudo apt install \
swh-plugins \
rubberband-ladspa \
lsp-plugins-ladspa \
calf-plugins \
zam-plugins
# Arch
sudo pacman -S \
swh-plugins \
rubberband \
lsp-plugins \
calf \
zam-plugins
常用插件包说明
| 插件包 | 提供的效果器 | 用途 |
|---|---|---|
swh-plugins | 多段均衡器、混响、延迟 | 基础效果器 |
lsp-plugins | 参数均衡器、压缩器、限制器 | 专业级效果器 |
calf-studio-gear-plugins | 均衡器、压缩器、混响、合唱 | 综合效果器套件 |
rubberband | 时间拉伸/音高变换 | 音高/速度调整 |
zam-plugins | 压缩器、限制器、均衡器 | 模拟风格效果器 |
x42-plugins | 分析仪、均衡器 | 分析与测量 |
Flatpak 版插件安装
# Flatpak 版 EasyEffects 自带大部分插件
# 如需额外插件，安装 Flatpak 版 GStreamer 插件
flatpak install flathub org.freedesktop.Platform.GStreamer.gstreamer-extra
flatpak install flathub org.freedesktop.Platform.Plugin.ffmpeg
2.5 初始配置
首次启动
# 命令行启动
easyeffects
# 或 Flatpak 版
flatpak run com.github.wwmm.easyeffects
# 或通过应用菜单找到 "EasyEffects" 图标
首次启动后，EasyEffects 会在 PipeWire 中注册为处理节点。
验证 PipeWire 连接
# 检查 EasyEffects 是否已注册为 PipeWire 节点
pw-dump | grep -i easyeffects
# 应该能看到 easyeffects_sink 和 easyeffects_source 相关节点
设置开机自启
通过 EasyEffects 内置设置
EasyEffects 的偏好设置中有「后台服务模式」选项。启用后，EasyEffects 会在后台运行而不显示界面，适合开机自启。
- 打开 EasyEffects
- 点击右上角的 ☰ 菜单
- 选择 偏好设置（Preferences）
- 启用 后台服务模式（Service Enable）
通过桌面环境的自启动
# 创建桌面文件
mkdir -p ~/.config/autostart
cp /usr/share/applications/com.github.wwmm.easyeffects.desktop ~/.config/autostart/
# 或创建简化版
cat > ~/.config/autostart/easyeffects.desktop << 'EOF'
[Desktop Entry]
Type=Application
Name=EasyEffects
Exec=easyeffects --gapplication-service
Hidden=false
NoDisplay=true
X-GNOME-Autostart-enabled=true
EOF
配置 PipeWire 低延迟
为获得最佳的实时音频处理体验，建议调整 PipeWire 的延迟设置。
编辑 ~/.config/pipewire/pipewire.conf.d/low-latency.conf：
mkdir -p ~/.config/pipewire/pipewire.conf.d/
cat > ~/.config/pipewire/pipewire.conf.d/low-latency.conf << 'EOF'
context.properties = {
default.clock.rate = 48000
default.clock.quantum = 256
default.clock.min-quantum = 32
default.clock.max-quantum = 1024
}
EOF
参数说明：
| 参数 | 默认值 | 低延迟值 | 说明 |
|---|---|---|---|
clock.rate | 48000 | 48000 | 采样率（Hz） |
clock.quantum | 1024 | 256 | 缓冲区大小（帧数） |
clock.min-quantum | 32 | 32 | 最小缓冲区 |
clock.max-quantum | 2048 | 1024 | 最大缓冲区 |
延迟计算公式：延迟(ms) = quantum / rate × 1000
- quantum=1024, rate=48000 → 约 21ms
- quantum=256, rate=48000 → 约 5.3ms
- quantum=128, rate=48000 → 约 2.7ms
# 重启 PipeWire 使配置生效
systemctl --user restart pipewire pipewire-pulse wireplumber
注意: quantum 值过小可能导致音频卡顿（xrun）。如果出现爆音或断断续续，请适当增大 quantum 值。
2.6 验证安装
功能验证步骤
# 1. 启动 EasyEffects
easyeffects &
# 2. 播放测试音频
# 使用系统音频播放器播放音乐，确认声音正常
paplay /usr/share/sounds/freedesktop/stereo/audio-test-signal.oga
# 3. 测试麦克风输入
# 在 EasyEffects 中切换到输入标签页
arecord -d 5 -f cd /tmp/test.wav && aplay /tmp/test.wav
# 4. 检查效果器是否工作
# 在 EasyEffects 输出页面启用均衡器，调整频段，确认声音变化
# 5. 检查 PipeWire 节点
pw-top
# 应该能看到 easyeffects_sink 和相关节点
常见安装问题排查
| 问题 | 可能原因 | 解决方案 |
|---|---|---|
| EasyEffects 无法启动 | 缺少 PipeWire | 安装 PipeWire 并重启 |
| 启动后无声音 | 效果链配置错误 | 重置预设或禁用所有效果 |
| 界面语言不对 | 系统 locale 设置 | 检查 LANG 环境变量 |
| Flatpak 版无声音 | 权限不足 | 执行权限覆盖命令 |
| 插件加载失败 | 缺少插件包 | 安装对应的插件包 |
| 效果器无效 | PipeWire 路由问题 | 检查 pw-top 节点连接 |
2.7 卸载 EasyEffects
Flatpak 版卸载
# 卸载
flatpak uninstall com.github.wwmm.easyeffects
# 清理残留数据
rm -rf ~/.var/app/com.github.wwmm.easyeffects/
原生包卸载
# Fedora
sudo dnf remove easyeffects
# Ubuntu
sudo apt remove easyeffects
# Arch
sudo pacman -Rns easyeffects
清理配置
# 删除用户配置和预设
rm -rf ~/.config/easyeffects/
2.8 要点回顾
- EasyEffects 推荐通过 Flatpak 安装，兼容性最好
- PipeWire 是必须的前置条件
- 安装额外的 LADSPA/LV2 插件可获得更丰富的效果器
- 建议调整 PipeWire 的 quantum 参数以优化延迟
- 开启后台服务模式实现开机自启
2.9 注意事项
PulseAudio 用户: 如果系统仍在使用 PulseAudio，必须先迁移到 PipeWire 才能使用 EasyEffects。迁移前请备份重要配置。
Flatpak 磁盘占用: Flatpak 版本因自带运行时和依赖，首次安装可能需要下载约 500MB 的数据。请确保磁盘空间充足。
低延迟风险: 将 PipeWire quantum 设置过低（如 64）可能导致 CPU 占用过高和音频卡顿。建议从 256 开始逐步降低测试。
蓝牙设备: 蓝牙音频设备可能需要额外的编解码器支持。如遇问题，安装
pipewire-codec-aptx等包。