如何自定义Jellyfin在Linux上的主题

如何在Linux上自定义Jellyfin主题
Jellyfin支持多种自定义主题的方式，从简单更换内置主题到深度修改CSS/JS，甚至安装第三方皮肤，以下是详细步骤：

一、准备工作

在开始自定义前，需完成以下基础操作：

1. 安装Jellyfin：根据Linux发行版（如Ubuntu/CentOS）使用对应包管理器安装（如Ubuntu用apt，CentOS用dnf），并启动服务（sudo systemctl start jellyfin）。
2. 备份文件：自定义前务必备份原始主题文件（如/usr/share/jellyfin/web）和配置文件（如/etc/jellyfin/config.xml），避免操作失误导致界面崩溃。
3. 确认权限：确保你对Jellyfin安装目录（如/usr/share/jellyfin）和配置目录（如/etc/jellyfin）有读写权限（可使用sudo chown -R $USER:$USER /usr/share/jellyfin调整）。

二、使用内置主题（快速上手）

Jellyfin自带多套基础主题，无需额外安装即可切换：

1. 登录Jellyfin管理界面（http://服务器IP:8096）。
2. 进入Settings（设置）→ Look and Feel（外观）。
3. 在**Theme（主题）**下拉菜单中选择喜欢的主题（如"Default"、“Dark”、“Minimal”）。
4. 保存设置后，刷新界面即可看到新主题效果。

三、安装第三方皮肤（扩展风格）

若内置主题无法满足需求，可安装第三方皮肤（如社区开发的JellySkin或其他ZIP格式皮肤）：

1. 下载皮肤文件：从可信来源（如JellySkin GitHub仓库、Jellyfin社区论坛）下载皮肤包（通常为.zip格式）。
2. 上传皮肤包：将下载的皮肤包上传到Jellyfin服务器的指定目录（如Ubuntu的/var/www/html/themes、CentOS的/usr/share/jellyfin/themes）。
3. 启用皮肤：
   • 登录管理界面，进入Settings → Look and Feel → Themes。
   • 点击Add theme（添加主题），选择上传的皮肤包文件。
   • 选中新添加的主题并点击Save（保存）。

四、自定义CSS/JavaScript（深度修改）

若需调整界面细节（如颜色、布局、动画），可通过修改CSS或JS文件实现：

1. 定位前端资源：Jellyfin的前端资源（CSS、JS）默认存放在安装目录的web子目录下（如Ubuntu的/usr/share/jellyfin/web、CentOS的/usr/share/jellyfin/web）。
2. 备份原始文件：修改前复制web目录下的文件（如style.css、script.js）到其他位置（如~/jellyfin_backup），以便后续恢复。
3. 修改文件：用文本编辑器（如nano、VS Code）打开需要修改的文件（如style.css），调整样式代码（如将背景色改为深灰色：body { background-color: #333; }）。
4. 重启服务：修改完成后，重启Jellyfin服务使更改生效（sudo systemctl restart jellyfin）。

五、使用JellySkin主题库（快速美化）

JellySkin是一套流行的Jellyfin主题库，提供丰富的样式和图标，可通过以下步骤快速应用：

1. 获取JellySkin CSS：访问JellySkin官网或GitHub仓库，下载最新CSS文件（如main.css、logo.css）。
2. 配置自定义CSS：
   • 登录管理界面，进入Dashboard（仪表板）→ General（常规）→ Custom CSS（自定义CSS）。
   • 将下载的CSS文件内容复制粘贴到Custom CSS文本框中（如@import url("https://cdn.jsdelivr.net/npm/jellyskin@latest/dist/main.css");）。
   • 勾选"Enable custom CSS"（启用自定义CSS），点击Save（保存）。
3. 查看效果：刷新Jellyfin界面，JellySkin主题将应用到所有用户。

六、创建自定义主题文件夹（完全自定义）

若需完全独立的主题，可创建自定义主题文件夹并配置：

1. 创建主题目录：在Jellyfin配置目录（如Ubuntu的/etc/jellyfin/themes、CentOS的/etc/jellyfin/themes）下创建新文件夹（如my_custom_theme）。
2. 复制主题文件：将内置主题（如/usr/share/jellyfin/web）或第三方皮肤中的文件复制到新目录（如my_custom_theme）。
3. 编辑配置文件：
   • 在Jellyfin配置目录（如/etc/jellyfin）中找到config.js文件。
   • 添加或修改以下内容，指向自定义主题目录：theme: '/etc/jellyfin/themes/my_custom_theme',。
4. 重启服务：保存config.js后，重启Jellyfin服务（sudo systemctl restart jellyfin）。

七、常见问题解决

1. 主题不生效：检查Jellyfin服务是否重启，或配置文件路径是否正确（如config.js中的theme路径是否存在）。
2. Nginx反向代理问题：若使用Nginx，需在配置文件中添加proxy_set_header Host $host;等头部信息，确保静态资源正确加载。
3. 缺少元数据（如图标）：安装FanartTV插件（通过Jellyfin插件页面），并在媒体库中开启FANARTTV元数据选项。

通过以上步骤，你可根据需求自定义Jellyfin在Linux上的主题，从快速切换到深度定制都能实现。操作时需注意备份，避免数据丢失。