jellyfin 群晖安装

简介

Jellyfin 是一款免费开源的家庭媒体服务器，帮你集中管理电影、剧集、音乐和照片，随时随地跨设备播放。（适用 Windows/x64。）

一、核心痛点与软件介绍

如果你手里攒了不少电影、剧集、音乐和照片，散落在移动硬盘、网盘和手机相册里，想在电视、平板、手机上随时播放却总要来回倒腾，那 jellyfin 群晖安装就是为这类人准备的：Jellyfin 是一款免费开源的家庭媒体服务器，把你的影音与照片集中到一处管理，跨设备播放，摆脱付费订阅与平台限制。它采用 GPL-2.0 许可证，代码完全公开，与同类商业方案相比最大优势在于不收订阅费、功能不设阉割门槛，且社区持续维护。

二、环境要求与官方下载

下载请前往官方仓库获取（本页下载区也提供真实下载通道，实际以页面展示为准）：https://github.com/jellyfin/jellyfin。本页收录信息中未收录具体系统要求参数，CPU、内存、磁盘等硬性门槛请以官网为准。作为 GitHub 开源项目，服务端不依赖 Python 或 Node 运行环境，具体依赖以所选安装方式的实际提示为准。

三、保姆级安装步骤

【步骤一：获取安装包并运行】前往官方仓库 Release 区，选择与你系统匹配的安装包下载，双击下载到的文件运行；若系统弹出用户账户控制（UAC）提示，点击「是」授权继续。

【步骤二：选择安装路径与组件】安装向导会让你确认安装目录，保持默认或点击「浏览」改到空间充足的盘；若向导列出可选组件，按需勾选后点击「下一步」；如提示缺少运行库（如 VC++ 运行库），先前往微软官网装好对应组件再重跑安装。

【步骤三：完成初始化】安装结束点击「完成」，浏览器会打开初始化向导：输入管理员用户名与密码并确认密码，选择语言与地区，逐步点「下一步」直至进入主界面。

macOS 用户：下载 dmg 镜像后双击打开，将图标拖入 Applications 文件夹完成安装。首次启动若被系统拦截，前往「系统设置 → 隐私与安全性」，在相应权限项（如屏幕录制、辅助功能）中勾选授权该应用，这是 mac 用户最容易卡住的环节。

包管理器方式：Windows 可在 PowerShell 用 winget 搜索 Jellyfin 安装；macOS 可用 brew 搜索安装；具体命令名与参数请以官方文档为准。

四、首次启动快速配置

1. 登录后台后，点击「控制台 → 媒体库」，点击「新建媒体库」，选择内容类型（电影/剧集/音乐/照片），点击「添加媒体库」选择你存放影片的共享目录，点击「确定」保存。
2. 点击「控制台 → 播放」，按需调整默认播放行为；字幕相关选项也在该页内，按你的观影习惯勾选后保存。
3. 点击「控制台 → 仪表盘」可查看扫描任务进度；首次扫描大型媒体库耗时较长，属正常现象。

五、常见安装报错解决方案（FAQ）

症状一：安装时提示缺少运行库。解决动作：前往微软官网安装对应版本 VC++ 运行库后，重新运行安装包。

症状二：升级后报「数据库被锁定 / database is locked」。解决动作：确认没有第二个实例挂载同一数据目录；若跑在 Proxmox LXC + ZFS 存储环境，官方已知该组合会放大锁定问题，建议换用其他存储类型。

症状三：升级后报「no such table」等数据库迁移失败。解决动作：官方明确要求升级前对数据目录做完整备份，因 12.0 起包含数据库变更、无法直接回滚；按官方指引恢复备份后重试。

六、优缺点

优点

• GPL-2.0 开源，代码公开、无订阅费，可自由部署。
• 集中管理电影、剧集、音乐与照片，跨设备播放。
• 社区活跃，官方仓库持续发布稳定版与候选版。

缺点

• 升级涉及数据库变更，官方多次强调必须先完整备份，回滚成本高。
• 部分部署组合（如 LXC + ZFS、Docker 硬解）存在社区反馈的已知问题。
• 大型媒体库初次扫描耗时明显，具体参数以官方公布信息为准。

七、历史版本

• v12.1（2026-09-15）：稳定版，包含多项缺陷修复；升级前请完整备份数据目录。
• v12.0（2026-09-08）：包含数据库变更，升级前必须完整备份，否则无法回滚；不支持从 10.10.7 直接升级。
• v12.0-rc7（2026-08-31）：预览版，供测试者发现缺陷，不建议主力环境使用。
• v12.0-rc6（2026-08-26）：预览版，性质同上。
• v12.0-rc5（2026-08-11）：预览版，性质同上。
• v12.0-rc4（2026-08-02）：预览版，性质同上。
• v12.0-rc3（2026-07-22）：预览版，性质同上。
• v12.0-rc2（2026-06-28）：预览版，性质同上。
• v12.0-rc1（2026-06-21）：12.0 首个候选预览版。
• v10.11.11（2026-06-06）：稳定版，含缺陷修复，升级前请完整备份。

八、社区高频问题与已知坑

• 症状：LXC 容器 + ZFS 存储反复报「Database Locked」。规避：官方已知问题，请勿重复开新 bug，建议更换底层存储。
• 症状：扫描大型媒体库时内存被 ffprobe 进程吃满导致卡死。规避：分批添加媒体库，避开高峰扫描。
• 症状：Docker 从 10.10 升到 10.11 报「no such table: ActivityLog」。解决：先备份数据目录，按官方迁移指引操作。
• 症状：Docker 环境下 QSV 硬件转码报「Error creating a QSV device」。解决：检查容器对核显设备的映射授权。
• 症状：字幕延迟 30 秒才出现、恢复播放时字幕不同步。规避：属已知反馈，可先手动切换字幕轨观察。

同类软件推荐

以下是与本文软件定位相近、可相互替代的同类工具，便于按需选型：

• Plex（本站已收录，点击查看下载与教程）
• Emby（本站已收录，点击查看下载与教程）
• Navidrome（同类热门，建议结合官网评估）

核心功能

• 本页保留官方站点入口作为下载来源，并在可用时提供网盘转存通道，链接与提取码随页面展示。
• 围绕「jellyfin 群晖安装」这一需求给出可执行的获取与部署步骤，减少试错成本。
• 提供版本与架构比对，避免装错版本或选错系统架构导致无法运行。

使用场景

• 需要在本机部署或重装 jellyfin 群晖安装（当前版本），并希望先核对版本与文件信息再获取的场景。
• 使用 jellyfin 群晖安装 时遇到官方站点访问不稳定或速度较慢，需要国内网盘通道作为替代的情况。
• 需要在多台设备使用同一 jellyfin 群晖安装 版本（当前版本），便于统一环境与后续排查时。

注意事项

• 部署 jellyfin 群晖安装 时路径建议避免中文与空格，可减少部分写入失败的概率。
• 若安全软件出现拦截提示，请先确认来源为本页收录渠道后再决定是否放行。

安装与校验

• 通过本页「夸克/百度 网盘」通道转存到自己的网盘后再取回文件，可避免直接下载中断造成的文件不完整。
• 解压后先确认 jellyfin 群晖安装 主程序能否正常启动，再决定是否替换原有版本。
• 如遇安全软件拦截，请先确认来源为本页收录渠道，再决定是否放行。

官方来源获取步骤

• 第 1 步：打开本页给出的官方站点入口，核对页面域名与下方收录信息是否一致。
• 第 2 步：在官方页面的下载区选择与本机 Windows/x64 匹配的安装包，注意区分 32 位与 64 位。
• 第 3 步：下载完成后核对文件名与文件大小，再执行安装或解压；建议解压到 C:\\Tools 这类不含中文与空格的路径。