手动安装
本页面由 PageTurner AI 翻译（测试版）。未经项目官方认可。 发现错误？ 报告问题 →
Windows 便携版安装包
Windows 便携版安装
-
下载并解压最新版本
-
在您选择的安装位置创建
jellyfin文件夹 -
将解压后的文件夹复制到
jellyfin目录中并重命名为system -
在
jellyfin文件夹内创建jellyfin.bat文件，内容如下：- 使用默认库/数据位置 (
%localappdata%)：
<--Your install path-->\jellyfin\system\jellyfin.exe- 使用自定义库/数据位置（-d 参数后的路径）：
<--Your install path-->\jellyfin\system\jellyfin.exe -d <--Your install path-->\jellyfin\data- 使用自定义库/数据位置并禁用 Web 应用自动启动：
<--Your install path-->\jellyfin\system\jellyfin.exe -d <--Your install path-->\jellyfin\data -noautorunwebapp - 使用默认库/数据位置 (
-
运行：
jellyfin.bat -
在浏览器中访问
http://<--Server-IP-->:8096
Windows 便携版更新
-
停止 Jellyfin 服务
-
将 Jellyfin 的
system文件夹重命名为system-bak -
下载并解压最新版 Jellyfin
-
将解压的文件夹复制到
jellyfin目录并重命名为system -
运行
jellyfin.bat重新启动服务
Windows 便携版回滚
-
停止 Jellyfin 服务
-
删除
system文件夹 -
将
system-bak重命名为system -
运行
jellyfin.bat重新启动服务
macOS 便携版安装包
macOS 便携版安装
-
下载最新版 Jellyfin
-
解压到 Applications 文件夹
-
打开终端，输入
cd加空格，然后将 jellyfin 文件夹拖入终端 -
输入
xattr -rd com.apple.quarantine .解除隔离限制 -
输入
codesign -fs - --deep jellyfin创建临时签名 -
输入
./jellyfin运行 jellyfin -
在浏览器中访问 http://localhost:8096
关闭终端窗口将终止 Jellyfin。使用 screen 或 tmux 运行可避免此问题
macOS 便携版更新
-
下载最新版本
-
通过控制面板或终端按
CTRL+C停止当前服务 -
将最新版解压到 Applications 目录
-
打开终端，输入
cd加空格，然后将 jellyfin 文件夹拖入终端 -
输入
xattr -rd com.apple.quarantine .解除隔离限制 -
输入
codesign -fs - --deep jellyfin创建临时签名 -
输入
./jellyfin运行 Jellyfin。 -
在浏览器中访问 http://localhost:8096
卸载便携版 macOS 版本
-
通过控制面板或终端窗口使用
CTRL+C停止当前运行的服务器。 -
将
/Application/jellyfin-version文件夹移至废纸篓（请将"version"替换为实际要删除的版本号）。 -
删除
~/.config/jellyfin/文件夹。 -
删除
~/.local/share/jellyfin/文件夹。
在便携版 macOS 中使用 FFmpeg
便携版默认不包含 FFmpeg，可通过以下方式安装：
-
从 Jellyfin 仓库 下载 jellyfin-ffmpeg（推荐）
-
使用包管理器 homebrew，在终端输入
brew install ffmpeg（若未安装 homebrew 可参考此指南） -
下载最新的静态编译版本（第三方编译，详见 evermeet.cx；此来源不 提供 Apple Silicon 版本）
-
从官方网站下载源码自行编译
下载完成后，移除 ffmpeg 和 ffprobe 的隔离标志：
确保 ffmpeg 和 ffprobe 位于同一路径后，执行以下命令：
cd /path/to/ffmpeg/folder
xattr -rd com.apple.quarantine .
便携式 Linux 安装
通用 amd64、arm64 和 armhf 架构的 Linux TAR 压缩包可在主下载仓库获取。
基础安装流程
在 /opt 下创建 jellyfin 目录并进入：
sudo mkdir /opt/jellyfin
cd /opt/jellyfin
下载适用于您架构的最新通用 Linux 版本（以下以 10.10.7 版本为例，即 jellyfin_10.10.7-amd64.tar.gz），解压下载的压缩包：
sudo wget https://repo.jellyfin.org/files/server/linux/latest-stable/amd64/jellyfin_10.10.7-amd64.tar.gz
sudo tar xvzf jellyfin_10.10.7-amd64.tar.gz
为 Jellyfin 数据创建四个子目录：
sudo mkdir data cache config log
FFmpeg 安装
若非 Debian 衍生系统，请通过系统包管理器安装 ffmpeg 并跳过此部分。
无法使用 jellyfin-ffmpeg 将导致硬件加速和色调映射功能失效。
若使用 Debian 或其衍生系统，请下载专为 Jellyfin 构建的 .deb 格式 ffmpeg 包并安装。
若遇依赖错误，运行此命令可自动安装依赖及 jellyfin-ffmpeg：
sudo apt install -f
运行 Jellyfin
因需传递大量命令行参数，建议创建启动脚本运行：
sudoedit jellyfin.sh
粘贴以下命令（可根据自定义部署需求修改参数）：
#!/bin/bash
JELLYFINDIR="/opt/jellyfin"
FFMPEGDIR="/usr/share/jellyfin-ffmpeg"
$JELLYFINDIR/jellyfin/jellyfin \
-d $JELLYFINDIR/data \
-C $JELLYFINDIR/cache \
-c $JELLYFINDIR/config \
-l $JELLYFINDIR/log \
--ffmpeg $FFMPEGDIR/ffmpeg
若需以非 root 用户运行， 请将所有文件和目录 chmod 授权给您的普通用户及用户组，并确保启动脚本具有可执行权限：
USER=$(id --name --user)
GROUP=$(id --name --group)
sudo chown -R $USER:$GROUP *
sudo chmod u+x jellyfin.sh
最后，您就可以运行 Jellyfin 了。 运行时您会看到大量日志信息，这属于正常现象。 请按照常规流程在网页浏览器中进行设置。
./jellyfin.sh
设置开机自启动（可选）
创建 systemd 服务单元文件。
cd /etc/systemd/system
sudo nano jellyfin.service
将以下内容粘贴到文件中，并将 youruser 替换为您的实际用户名。
[Unit]
Description=Jellyfin
After=network.target
[Service]
Type=simple
User=youruser
Restart=always
ExecStart=/opt/jellyfin/jellyfin.sh
[Install]
WantedBy=multi-user.target
为文件设置正确权限，启用开机自启动服务，然后启动服务。
sudo chmod 644 jellyfin.service
sudo systemctl daemon-reload
sudo systemctl enable jellyfin.service
sudo systemctl start jellyfin.service
.NET DLL 便携版
跨平台的 .NET Core DLL 构建版本（TAR 格式）可在便携版下载页面获取。
这些版本使用二进制文件 jellyfin.dll，必须通过 dotnet 命令加载运行。
Debian（使用 extrepo）
extrepo 目前仅支持 Debian 系统。其优势在于已整合至 Debian 官方套 件中，无需像前文"自动安装"章节那样执行 curl | sudo bash 命令组合。该命令组合存在安全隐患，因为它依赖于远程服务器的安全性。extrepo 通过将 Jellyfin 仓库信息（包括 GPG 密钥）整合至其extrepo-data中规避了此风险。extrepo 工具会通过 GPG 验证 extrepo-data 的完整性，从而建立了从 Debian 系统到 Jellyfin 仓库的完整信任链。
sudo apt install extrepo
sudo extrepo enable jellyfin
现在您可以继续执行手动配置官方仓库步骤 5 的操作。
手动配置官方 Linux 仓库
如果您希望完全手动安装，完整步骤如下：
-
安装
curl和gnupg（如果尚未安装）：sudo apt install curl gnupg -
仅 Ubuntu（及其衍生版）需启用 Universe 仓库获取 FFmpeg 依赖项：
sudo add-apt-repository universe备注若上述命令执行失败，请安装
software-properties-common套件包：sudo apt-get install software-properties-commonDebian 用户可额外启用基础仓库的
non-free组件获取更多 FFmpeg 依赖项（此步骤可选）。 -
下载 Jellyfin 团队签署的 GPG 密钥并安装：
sudo mkdir -p /etc/apt/keyringscurl -fsSL https://repo.jellyfin.org/jellyfin_team.gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/jellyfin.gpg -
在
/etc/apt/sources.list.d/jellyfin.sources添加软件源配置：export VERSION_OS="$( awk -F'=' '/^ID=/{ print $NF }' /etc/os-release )"export VERSION_CODENAME="$( awk -F'=' '/^VERSION_CODENAME=/{ print $NF }' /etc/os-release )"export DPKG_ARCHITECTURE="$( dpkg --print-architecture )"cat <<EOF | sudo tee /etc/apt/sources.list.d/jellyfin.sourcesTypes: debURIs: https://repo.jellyfin.org/${VERSION_OS}Suites: ${VERSION_CODENAME}Components: mainArchitectures: ${DPKG_ARCHITECTURE}Signed-By: /etc/apt/keyrings/jellyfin.gpgEOF -
更新APT软件源：
sudo apt update -
安装Jellyfin元软件包（自动获取所有子包）：
sudo apt install jellyfin备注如需手动选择，可不安装元软件包，改为单独安装子包：
sudo apt install jellyfin-server jellyfin-webjellyfin-server包会自动为您匹配正确的jellyfin-ffmpeg包 -
管理系统服务：
sudo systemctl {action} jellyfinsudo service jellyfin {action}
.deb软件包（完全手动安装）
原始.deb软件包（含旧版本、源码包和dpkg元文件）可在主下载仓库获取
对于Debian和Ubuntu系统，强烈推荐使用软件源安装方式，这将确保您获得自动更新且所有依赖关系正确解析。仅当您完全了解操作风险时再使用本手动方式
-
仅Ubuntu（及其衍生版）需启用Universe仓库获取FFmpeg依赖：
sudo add-apt-repository universe备注若上述命令失败，需先安装
software-properties-common包。 可通过以下命令实现：sudo apt-get install software-properties-commonDebian系统也可启用
non-free组件获取额外FFmpeg依赖（可选） -
从仓库下载所需的
jellyfin-server、jellyfin-web和jellyfin-ffmpeg的.deb软件包（jellyfin元包非必需） -
使用
apt安装下载的.deb软件包以处理依赖关系：sudo apt install ./jellyfin-server_*.deb ./jellyfin-web_*.deb ./jellyfin-ffmpeg_*.deb -
管理 Jellyfin 系统服务：
sudo systemctl {action} jellyfinsudo service jellyfin {action}