ubuntu jellyfin音频设置指南
小樊
34
2025-12-07 00:37:57
Ubuntu 下 Jellyfin 音频设置指南
一 系统音频基础配置
- 在 Ubuntu/GNOME 中通过 设置 → 声音 选择默认输出设备（如 HDMI、耳机、内置扬声器），并在“配置/配置文件”里为蓝牙选择 A2DP Sink（高保真），避免 HSP/HFP（电话音频） 导致音质差或单声道。必要时开启“允许音量超过 100%”。
- 命令行快速切换默认输出（两种声音框架二选一）：
- PipeWire（Ubuntu 22.04+ 常见）：
- 查看设备：wpctl status
- 设为默认：wpctl set-default
- PulseAudio：
- 查看设备：pactl list sinks short
- 设为默认：pactl set-default-sink
- 蓝牙耳机无声或切到 HSP/HFP 时，可强制切回 A2DP：
- PulseAudio：pactl set-card-profile <bluez_card.xxx> a2dp-sink
- 快速自检：
- 系统提示音：paplay /usr/share/sounds/freedesktop/stereo/bell.oga
- ALSA 测试音：speaker-test -t sine -f 440 -l 1
- 若使用 Jellyfin 服务器版（无桌面），音频设备由客户端决定；若需在服务器本机播放测试音，可临时安装并启动 PulseAudio。
二 让 Jellyfin 服务使用正确的音频设备
- 将 jellyfin 用户加入音频/视频组，确保服务可访问声卡：
- sudo usermod -aG audio jellyfin
- sudo usermod -aG video jellyfin
- 重启服务生效：sudo systemctl restart jellyfin
- 若通过 Nginx 反向代理访问，确保代理配置正确并重启 Nginx；Jellyfin 默认访问端口为 8096。
三 播放器与转码中的音频关键设置
- 播放器选择：
- 网页端（Chromium/Edge/Firefox）通常走系统音频输出；
- Kodi/Jellyfin Media Player 等客户端可在应用内选择输出设备与音轨。
- 音轨与字幕：在“播放信息/播放选项”中手动指定 音轨语言/声道布局（如 5.1/7.1/立体声） 与字幕，避免客户端自动选择错误。
- 转码与直通：
- 多声道或 无损（FLAC/ALAC） 建议“直接播放/复制音频”，减少转码；
- 客户端不支持的编码（如 DTS、TrueHD、EAC3）可在服务器启用转码，并在转码配置中选择合适的 音频编码器（AAC/Opus） 与码率；
- 若只需调整音量而不改编码，可在客户端启用“音量归一化/动态范围压缩”。
四 常见问题与快速排查
- 服务器本机测试无声：
- 确认默认输出设备正确（wpctl/pactl），再播放测试音；
- 重启音频栈：systemctl --user restart wireplumber pipewire pipewire-pulse（或 pulseaudio -k && pulseaudio --start）。
- 蓝牙耳机“能连但音质差/像电话”：在声音设置或命令行将蓝牙配置切回 A2DP Sink。
- 网页端无声但系统有声：检查浏览器标签页是否被静音、客户端应用内输出设备是否选错、系统默认设备是否变更。
- 特定应用把系统切到 HSP/HFP：在会议软件中将输入设备改为“内置麦克风”，输出保持 A2DP；必要时关闭该应用的麦克风权限再切回。
- 日志定位：查看 /var/log/jellyfin/jellyfin.log 中播放会话与转码日志，确认是否发生音频转码与所选编码器。
五 进阶 多房间与宿主机直放音
- 多房间同步：使用 PulseAudio/PipeWire 的模块（如 module-combine-sink 或支持多播的插件）将音频同时输出到多个设备，再让 Jellyfin 使用这个“虚拟合并”设备作为默认输出。
- 宿主机直放音（无桌面环境）：
- 安装最小音频栈：sudo apt install -y pipewire pipewire-pulse
- 启动服务：systemctl --user start pipewire pipewire-pulse
- 通过 wpctl/pactl 选定输出后，Jellyfin 播放将走该设备。
