ubuntu jellyfin自定义皮肤

Ubuntu 下 Jellyfin 自定义皮肤的实用方案

一 前置准备与注意事项

• 建议先备份：导出配置、记录当前外观设置，便于回滚。
• 变更生效方式：多数外观改动需要刷新网页；涉及插件或系统文件时需重启服务（如执行：sudo systemctl restart jellyfin）。
• 兼容性：自定义 CSS/JS 可能影响性能与稳定性，且随版本升级可能失效，建议小步迭代、逐项验证。

二 方法一 使用 Skin Manager 插件一键换肤（推荐）

• 安装插件
  • 进入 控制台 > 插件 > 存储库，添加插件清单 URL：https://raw.githubusercontent.com/danieladov/JellyfinPluginManifest/master/manifest.json。
  • 在插件页安装 Skin Manager，安装完成后重启 Jellyfin（sudo systemctl restart jellyfin）。
• 选择并应用皮肤
  • 打开 控制台 > 插件 > Skin Manager，从列表中选择喜欢的皮肤并保存。
  • 若希望网页、手机、电视等所有客户端统一生效，点击右上角头像 > 显示，取消勾选 “禁用服务器提供的自定义 CSS”，再次保存。
• 常见问题
  • 插件页空白或选项未显示：多刷新几次，必要时重启服务。
  • 想恢复默认：在 Skin Manager 选择第一个默认皮肤，或重新勾选 “禁用服务器提供的自定义 CSS”。

三 方法二 通过自定义 CSS 快速美化

• 内置入口
  • 进入 控制台 > 常规 > 自定义 CSS 代码，将主题 CSS 粘贴保存并刷新页面即可生效。
• 示例主题
  • JellyFlix（Netflix 风格）
    • 基础版：

      @import url("https://cdn.jsdelivr.net/gh/prayag17/JellyFlix@latest/default.css");
      

    • 带 Logo 版：

      @import url("https://cdn.jsdelivr.net/gh/prayag17/JellyFlix@latest/default.css");
      @import url("https://cdn.jsdelivr.net/gh/prayag17/JellyFlix@latest/addons/Logo.css");
      

    • 配色扩展（蓝色/紫色）：

      @import url("https://cdn.jsdelivr.net/gh/prayag17/JellyFlix@9.0.4/addons/jf-blue.css");
      @import url("https://cdn.jsdelivr.net/gh/prayag17/JellyFlix@9.0.4/addons/jf-purple.css");
      

  • JellySkin（可叠加渐变与 Logo）

    @import url('https://cdn.jsdelivr.net/npm/jellyskin@latest/dist/main.css');
    @import url('https://cdn.jsdelivr.net/gh/prayag17/JellySkin/addons/Gradients/nightSkyGradient.css');
    @import url('https://cdn.jsdelivr.net/gh/prayag17/JellySkin/addons/Logo.css');
    

• 使用提示
  • 若使用 Skin Manager，通常建议在其设置中启用皮肤后，关闭 “禁用服务器提供的自定义 CSS”，避免样式冲突。
  • 自定义代码建议分段注释与逐项启用，便于定位问题。

四 方法三 手动替换前端资源或上传主题包（进阶）

• 适用场景：需要深度定制或离线环境。
• 基本思路
  • 获取皮肤文件（常见为 .zip 或 .css），按需上传至服务器（如 /var/www/html/themes），或编辑 Jellyfin 前端资源目录（常见路径 /usr/share/jellyfin/web）。
  • 在 控制台 > 外观/主题 中选择或添加新主题并应用；如修改了系统文件，执行 sudo systemctl restart jellyfin 使改动生效。
• 风险提示
  • 直接修改安装目录文件在升级时可能被覆盖，务必做好备份与版本记录。