如何在centos上自定义jellyfin主题

在 CentOS 上自定义 Jellyfin 主题的可选方案

一 快速方案 使用自定义 CSS

• 入口路径：登录 Jellyfin 管理后台 → 控制台 → 常规 → 自定义 CSS（不同版本可能显示为 仪表板 → 常规 → 自定义 CSS）。
• 操作方式：将你的 CSS 粘贴到文本框并保存，样式会全局生效于当前主题之上，适合进行配色、字体、间距等界面微调。
• 版本差异：菜单名称在不同版本中可能略有差异，但“自定义 CSS”的位置基本一致。
• 示例（将顶部导航栏改为深蓝）：

  /* 顶部导航栏背景 */
  .header {
    background-color: #0b3d91 !important;
  }
  /* 侧边栏背景 */
  .sidebar {
    background-color: #1a1a1a !important;
  }
  /* 按钮主色 */
  .btn-primary {
    background-color: #0b3d91 !important;
    border-color: #0a336d !important;
  }
  

• 建议：每次修改少量样式并逐项验证，避免大段覆盖导致布局异常。

二 进阶方案 安装第三方皮肤

• 准备皮肤包：下载第三方皮肤（通常为 .zip 文件）。
• 放置皮肤包：将皮肤包上传到 Jellyfin 可访问的目录，例如 /var/www/html/themes。
• 导入并启用：在 Jellyfin 管理后台 → 设置 → 外观 → 主题（或 Themes）中，点击 Add theme，选择上传的皮肤包并启用。
• 适用场景：需要整体替换配色、布局、图标风格时使用；不同皮肤对 Jellyfin 版本有兼容性要求，建议优先选择活跃维护的仓库。

三 深度方案 修改前端资源文件

• 资源路径：Jellyfin 的前端静态资源通常位于 /usr/share/jellyfin/web（具体路径以实际安装为准）。
• 操作步骤：
  • 备份原始文件（例如：sudo cp -a /usr/share/jellyfin/web /usr/share/jellyfin/web.bak）。
  • 按需修改 CSS/JS/HTML 资源（如覆盖样式、调整模板结构）。
  • 重启服务以生效：sudo systemctl restart jellyfin。
• 风险提示：升级 Jellyfin 时前端资源可能被覆盖，需重新应用修改或维护补丁；不建议在生产环境直接改动二进制分发文件。

四 维护与排错建议

• 备份与回滚：在进行任何主题改动前，先备份相关目录或数据库；出现问题时优先恢复到备份。
• 生效方式：使用“自定义 CSS”通常即时生效；替换前端资源或修改服务端文件后需重启 Jellyfin 服务。
• 版本兼容：皮肤与自定义代码需与 Jellyfin 版本匹配，升级前先在测试环境验证。
• 安全与权限：上传皮肤包或编辑文件时，注意 目录权限 与 SELinux 策略，避免因权限问题导致 403 或无法读取资源。