ubuntu jellyfin音频设置指南

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 播放将走该设备。