Jellyfin在Ubuntu上的音频输出设置

Jellyfin在Ubuntu上的音频输出设置

一、前置检查与系统准备

• 确认音频设备被系统识别：在终端执行aplay -l（ALSA）或pactl list short sinks（PulseAudio/PipeWire），记下目标设备的名称或索引，如：alsa_output.pci-0000_00_1f.3.analog-stereo（内置声卡）或alsa_output.usb-…analog-stereo（USB/蓝牙音箱）。
• 安装并打开图形化调音台PulseAudio Volume Control（pavucontrol）：执行sudo apt install pavucontrol，运行pavucontrol。在“Configuration”里为当前声卡选择正确的Profile（如：Analog Stereo Output、HDMI / DisplayPort），在“Output Devices”中将目标端口（如Headphones、HDMI/DP）设为Port并调音量；必要时用“Test”按钮验证。
• 若遇到插入耳机仍外放或设备显示“unplugged”，在“Configuration”中手动切换到正确的Port，或在“Output Devices”勾选Show: All output devices后选择有效端口再测试。

二、选择Jellyfin的输出设备

• 使用系统默认设备（推荐）：将系统的默认输出设备设为你的目标设备（见第三部分），Jellyfin（通过浏览器或客户端）会随系统输出。
• 在浏览器中指定输出设备（Chrome/Edge）：打开WebRTC相关设置，将音频输出设备选择为目标设备（不同浏览器路径略有差异，通常在站点权限或设备选择中）。
• 使用Jellyfin桌面客户端（如Jellyfin Media Player）：在应用内“设置-播放-音频设备”选择目标设备。
• 使用DLNA/Chromecast：音频跟随接收端设备，需在电视/音箱端切换音频输出（如电视的“音频输出：外部音响/光纤”）。

三、命令行切换与持久化（适合服务器/无界面环境）

• 查看与临时切换输出设备：
  • 列出设备：pactl list short sinks
  • 临时切换默认输出：pactl set-default-sink <设备名或索引>（例：pactl set-default-sink alsa_output.pci-0000_00_1f.3.analog-stereo）
• 将正在播放的流实时迁移到目标设备：
  • 查看播放流：pactl list short sink-inputs
  • 迁移流：pactl move-sink-input <流ID> <设备名>（例：pactl move-sink-input 1234 alsa_output.usb-Headphone.analog-stereo）
• 永久生效（修改默认设备）：
  • 编辑配置文件：nano ~/.config/pulse/default.pa
  • 在文件末尾添加：set-default-sink <你的设备名>
  • 使配置生效：pulseaudio -k && pulseaudio --start
• 提示：若系统使用PipeWire，上述pactl/pacmd命令通常仍可用；若命令不可用，请确认已安装并运行pipewire-pulse。

四、常见问题与快速排查

• 有画面无声音：在pavucontrol的“Output Devices”确认目标Port未被静音（音量滑块与“Mute”按钮），并点击“Test”验证；必要时在“Configuration”切换Profile（如从Digital Stereo切到Analog Stereo或HDMI）。
• 插入耳机仍外放：在“Configuration”将内置声卡设为Analog Stereo Output，在“Output Devices”勾选Show: All output devices，将Headphones设为Port并测试。
• 多设备时Jellyfin走错设备：用pactl list short sinks确认设备名，临时执行pactl set-default-sink <设备名>；或在“正在播放”的应用中将其音频流move-sink-input到目标设备。
• 重启后失效：将默认设备写入**~/.config/pulse/default.pa并执行pulseaudio -k && pulseaudio --start**以持久化。