Jellyfin在Debian上的配置步骤是什么

Jellyfin在Debian上的配置步骤

一、前置准备

确保系统已更新至最新版本，并安装必要工具：

sudo apt update && sudo apt upgrade -y
sudo apt install wget gnupg2 lsb-release -y

二、添加Jellyfin官方存储库

1. 导入GPG密钥（验证软件包完整性）：

   wget -O - https://repo.jellyfin.org/debian/jellyfin_team.gpg.key | sudo apt-key add -
   

   （若apt-key提示弃用，可忽略，后续用signed-by替代）

2. 创建存储库配置文件：

   echo "deb [arch=$(dpkg --print-architecture)] https://repo.jellyfin.org/debian $(lsb_release -c -s) main" | sudo tee /etc/apt/sources.list.d/jellyfin.list
   

   注：$(lsb_release -c -s)会自动匹配Debian代号（如buster、bullseye），无需手动替换。

3. 更新软件包列表：

   sudo apt update
   

三、安装Jellyfin

通过APT安装Jellyfin及依赖：

sudo apt install jellyfin -y

安装过程中会自动解决依赖关系（如.NET Core运行时、ffmpeg等）。

四、启动Jellyfin服务

1. 启动服务并设置开机自启：

   sudo systemctl enable jellyfin  # 开机自启
   sudo systemctl start jellyfin   # 立即启动
   

2. 检查服务状态：

   sudo systemctl status jellyfin
   

   若显示“active (running)”，则表示服务已正常运行。

五、访问Web界面

1. 获取服务器IP：

   ip a
   

   找到类似inet 192.168.x.x/24的局域网IP（若为公网服务器，直接使用公网IP）。

2. 浏览器访问： 在浏览器输入http://<服务器IP>:8096（默认端口为8096），进入Jellyfin初始设置页面。

六、初始配置

1. 设置管理员账户： 输入用户名、密码（建议使用强密码），完成管理员账户创建。

2. 添加媒体库：

   • 点击“媒体库”→“添加媒体库”；
   • 选择媒体类型（电影、电视节目、音乐等）；
   • 浏览并选择本地媒体文件夹路径（如/home/user/Movies）；
   • 设置扫描频率（如实时扫描或每日扫描）。

3. 完成基础设置： 根据需求调整语言、主题、播放设备（如DLNA、流媒体客户端）等选项，保存设置即可。

七、可选优化（Docker方式安装）

若偏好容器化部署，可使用Docker快速安装：

1. 安装Docker：

   sudo apt install docker.io -y
   sudo systemctl enable --now docker
   

2. 拉取Jellyfin镜像并启动容器：

   docker pull jellyfin/jellyfin
   docker run -d \
     --name jellyfin \
     -p 8096:8096 \
     -p 8920:8920 \
     -v /path/to/config:/config \
     -v /path/to/media:/media \
     jellyfin/jellyfin
   

   注：将/path/to/config替换为配置文件存储路径（如/home/user/jellyfin-config），/path/to/media替换为媒体文件路径（如/home/user/Movies）。

3. 访问方式： 同步骤五，通过http://<服务器IP>:8096访问Web界面。

常见问题解决

• 存储库报错：若apt update提示“无法验证签名”，检查GPG密钥是否正确导入（sudo apt-key list），或手动修改/etc/apt/sources.list.d/jellyfin.list，删除[arch=]参数。
• 端口冲突：若8096端口被占用，可在安装时通过--port参数修改端口（如jellyfin --port 8097），或在Web界面设置中更改。