jellyfin

免费开源媒体服务器，自己掌控影音库，随时随处播放

开源基础设施

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 58041

维护状态活跃

是否开源是

定价模式

项目预览

项目数据

分类基础设施

开发团队jellyfin

所属国家

官网地址https://jellyfin.org

GitHubhttps://github.com/jellyfin/jellyfin

定价模式

价格说明

访问状态

是否开源是

开源协议GPL-2.0

主要语言C#

技术栈/模型csharp,dotnet,hacktoberfest,jellyfin

GitHub 星标★ 58041

30天Star增速

HF 下载量

上线时间2018-12-09 00:00:00

代码更新—

仓库体积—

本站数据更新—

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-29

浏览次数16

项目介绍

Jellyfin 是一个免费开源的媒体服务器系统，旨在为用户提供完整的个人媒体管理解决方案。它解决了商业媒体服务器（如 Plex 和 Emby）的闭源、收费和隐私问题，让用户完全掌控自己的媒体库。核心能力包括：跨平台服务器（Windows、Linux、macOS、Docker 等），支持电影、电视剧、音乐、照片等多种媒体类型的整理与元数据抓取；提供网页端、移动端（iOS/Android）、电视端（Android TV、Roku、Apple TV 等）的客户端播放；内置转码引擎，支持硬件加速，适应不同网络带宽；支持多用户管理、家长控制、字幕下载和插件扩展。Jellyfin 基于 .NET（C#）构建，社区活跃，持续更新，是自托管媒体中心的理想选择。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

正在加载星标数据…

技术标签

使用教程

—

难度：进阶约 30 分钟部署方式：本地安装 7 步

环境要求

.NET SDK（README 中构建输出目录为 net10.0，需对应版本的 .NET SDK）
Git，用于克隆仓库
已获取的 web 客户端静态文件（构建产物或已有安装中的 jellyfin-web 目录）
可选：Visual Studio 或 Visual Studio Code（含工作区推荐扩展）

安装与启动步骤

1克隆仓库

把 Jellyfin 服务端源码克隆到本地，默认目录名为 jellyfin。
```
git clone https://github.com/jellyfin/jellyfin.git
```
2进入仓库目录

后续所有构建与运行命令都在仓库根目录下执行。
```
cd jellyfin
```
3准备 web 客户端

仓库本身不含 web 客户端静态文件，需从 jellyfin-web 仓库构建，或从已有安装中复制，例如 Windows 下位于 C:Program FilesJellyfinServerjellyfin-web。
4命令行运行服务端

通过 dotnet run 启动服务端项目，并用 --webdir 指向 web 客户端 dist 的绝对路径。
```
dotnet run --project Jellyfin.Server --webdir /absolute/path/to/jellyfin-web/dist
```
5构建并直接运行

先构建项目，再进入构建输出目录运行生成的可执行文件；Linux/macOS 用 ./jellyfin，Windows 用 jellyfin.exe。
```
dotnet build
cd Jellyfin.Server/bin/Debug/net10.0
```
6查看命令行选项

直接运行可执行文件时，可加 --help 查看所有支持的命令行选项。
```
./jellyfin --help
```
7运行单元测试

仓库包含用于 CI 校验的单元测试，可在命令行执行。
```
dotnet test
```

关键配置

配置项	必填	说明	示例
`--webdir`	是	指定 web 客户端静态文件所在目录的绝对路径	`/absolute/path/to/jellyfin-web/dist`
`--help`	否	列出所有支持的命令行选项	`--help`

如何确认成功

用浏览器打开服务端 WebUI，首次会出现登录页，刷新一次后应跳转到 Setup 初始化页面，即表示启动成功。

常见问题

Q：首次打开 WebUI 为什么进入登录页而不是初始化页面？

A：这是正常现象，刷新一次登录页即可被重定向到 Setup 初始化页面。

Q：运行时提示找不到 web 客户端文件怎么办？

A：仓库不包含 web 客户端，需从 jellyfin-web 仓库构建，或从已安装的服务器中复制，例如 Windows 的 C:Program FilesJellyfinServerjellyfin-web。

Q：在 Visual Studio / VS Code 中如何运行？

A：Visual Studio 打开 .sln 后按 F5；VS Code 先用 Open Folder 打开仓库目录并安装工作区推荐扩展，然后按 F5。

Q：用 GitHub Codespaces 打开后一直没就绪？

A：需等待 20-30 秒加载扩展和 .NET 环境，直到输出中出现 Downloading .NET version(s) 7.0.15~x64 ...... Done!

Q：如何知道支持哪些启动参数？

A：直接运行生成的可执行文件并附加 --help 查看全部支持的命令行选项。

注意事项

仓库默认不包含 web 客户端静态文件，必须先自行获取，否则服务端无法提供网页界面。
开发场景下推荐将 web 客户端与服务端分开托管，此时可跳过准备 web 客户端这一步。
使用 GitHub Codespaces 时，若要从外部访问，需在 VS Code 下方把 ports 设置为 public。
README 未给出 Docker 运行命令，如需容器部署请参考官方 Docker Hub 镜像页面与官网文档。

核心亮点

完全免费无任何付费墙，所有功能包括硬件转码和用户管理均开放
支持几乎所有主流平台，从服务器到客户端覆盖全面，生态完善
插件系统丰富，可扩展直播电视、字幕、元数据等第三方服务

不足之处

部分客户端（如 Android TV）偶有稳定性问题，需频繁更新修复
文档和社区支持相比商业竞品仍有差距，部分高级配置需自行摸索

适用场景

家庭用户搭建个人影音库，集中管理电影、剧集和音乐
小团队或组织内部共享媒体资源，实现多用户权限隔离
技术爱好者自托管服务，替代商业媒体服务器，保护隐私

替代项目

Plex、Emby、Kodi

上一篇：prometheus

下一篇：server