Linux用户如何访问Jellyfin

Linux 用户访问 Jellyfin 的常用方式

• 使用任意现代浏览器访问 http://服务器IP:8096，完成初始化（创建管理员账户、添加媒体库等）。
• 安装 Jellyfin Media Player 桌面客户端（基于 MPV，播放兼容性更好）。
• 使用 Docker 部署时，通过 host 网络或正确映射端口后，同样用 http://服务器IP:8096 访问。
• 远程访问建议在路由器做端口转发，或使用 Tailscale 等内网穿透工具更安全便捷。

快速开始 本机或局域网访问

• 确认服务已运行：
  • 启动：sudo systemctl start jellyfin
  • 状态：sudo systemctl status jellyfin
• 获取服务器 IP（示例）：ifconfig 或 ip a
• 在浏览器打开：http://<服务器IP>:8096，按向导完成初始化（语言、账户、媒体库）。

桌面客户端访问 Linux

• 使用 Flatpak 安装（推荐）：
  • 添加源：flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
  • 安装：flatpak install flathub io.jellyfin.JellyfinMediaPlayer
• 启动后在客户端内添加服务器地址 http://<服务器IP>:8096，登录后即可播放。
• 该客户端集成 MPV，对多种音视频编码支持更好，适合 Linux 桌面环境。

Docker 部署的访问方式

• 示例 docker-compose（使用 host 网络，无需端口映射）：
  • 关键要点：
    • 挂载配置与缓存：/config、/cache
    • 挂载媒体目录：如 /media、/movie、/music
    • 网络模式：network_mode: “host”（或映射 8096:8096）
  • 启动后在浏览器访问：http://服务器IP:8096
• 注意：部分教程或镜像可能使用 8090 端口，属于镜像或配置差异，以实际映射为准。

常见问题与排查

• 访问被拒绝或页面打不开：
  • 检查服务是否运行：sudo systemctl status jellyfin
  • 放行防火墙端口（示例）：
    • UFW：sudo ufw allow 8096/tcp
    • firewalld：firewall-cmd --zone public --add-port 8096/tcp --permanent && firewall-cmd --reload
• 媒体库不显示新文件：
  • 在 Web UI 对应媒体库执行 Scan Library 或 Refresh Metadata。
• 权限问题导致“看不见”文件：
  • 将媒体目录授权给 jellyfin 用户：
    • sudo chown -R jellyfin:jellyfin /your/media/folder
  • 或创建共享组（如 media），将 jellyfin 与上传用户加入该组并设置组权限。
• 远程访问更安全做法：
  • 路由器端口转发 8096/TCP（注意安全风险）
  • 或使用 Tailscale 等零配置内网穿透，无需公网暴露端口。