Emby.CustomCssJS 插件配置指南：从零开始定制你的媒体服务器界面

项目概览

你正在查看的是一个专为Emby媒体服务器设计的开源插件，它能让你像给房间换装修一样轻松定制服务器界面和功能。通过简单的代码编辑，你可以改变按钮位置、调整颜色风格，甚至添加新的交互功能。这个工具就像是给你的Emby服务器安装了一个"自定义控制面板"，所有修改都会实时生效。

⚠️ 重要提示：本插件基于mediabrowser.server.core 4.8.0.24-beta版本开发，使用前请确保你的Emby服务器与此版本兼容。

环境部署

准备工作清单

你需要提前准备这些工具和环境：

• 运行中的Emby服务器（推荐Docker版emby/embyserver:beta镜像）
• Git命令行工具（用于获取项目文件）
• 文件传输工具（如WinSCP）
• 基础文本编辑器（如记事本或VS Code）

环境部署流程

1️⃣ 获取项目文件
请执行以下命令克隆项目代码库到本地计算机：

git clone https://gitcode.com/gh_mirrors/em/Emby.CustomCssJS

💡 技巧提示：如果克隆速度慢，可以尝试使用国内Git加速服务，或直接下载项目ZIP压缩包。

2️⃣ 部署服务端组件
【文件传输】将以下两个核心文件上传到Emby服务器的指定目录：

• src/Emby.CustomCssJS.dll → 上传至/volume1/@appdata/EmbyServer/plugins
• src/CustomCssJS.js → 上传至system/dashboard-ui/modules

3️⃣ 修改前端配置
【代码编辑】打开Emby服务器上的system/dashboard-ui/app.js文件，找到包含Promise.all(list.map(loadPlugin))的代码段，在其上方添加：

list.push("./modules/CustomCssJS.js"),

4️⃣ 重启服务
请执行Emby服务器重启操作，使插件生效。Docker环境可使用以下命令：

docker restart emby-server  # 请将"emby-server"替换为你的容器名称

功能配置

多平台部署指南

桌面客户端配置

1. 将src/CustomCssJS.js复制到客户端的electronapp/plugins目录
2. 重启客户端应用即可自动加载插件

移动应用（安卓）配置

1. 复制src/CustomCssJS.js到assets/www/modules目录
2. 修改assets/www/app.js文件，添加：

   list.push("./modules/CustomCssJS.js"),
   

3. 编辑assets/www/native/android/apphost.js，将features.restrictedplugins的值改为false

快速配置方案

如果你使用Docker版Emby服务器，可以通过以下一键脚本完成部署：

wget -O script.sh --no-check-certificate https://raw.githubusercontent.com/Shurelol/Emby.CustomCssJS/main/src/script.sh && bash script.sh

💡 技巧提示：执行脚本前请确保你的服务器已安装wget工具，Debian/Ubuntu系统可通过sudo apt install wget安装。

安全验证

功能验证步骤

1. 打开Emby管理界面，检查左侧导航栏是否出现"自定义JS和CSS"选项
2. 点击进入插件页面，尝试输入简单CSS代码（如body { background: #f0f0f0; }）
3. 刷新页面查看样式是否生效，验证插件是否正常工作

⚠️ 安全警示

• XSS风险警告：自定义代码可能包含恶意脚本，请只使用信任的代码片段
• 数据存储说明：所有配置信息保存在浏览器的localStorage中，清除浏览器数据会导致配置丢失
• 恢复方案：若因错误配置导致无法访问Emby，可清除以下localStorage键值恢复：
  • customcssServerConfig_${sercerID}
  • customjsServerConfig_${sercerID}
  • customcssLocalConfig
  • customjsLocalConfig

常见问题排查

• 插件不显示：检查config文件夹权限是否为Emby服务可读写
• 样式不生效：确认CustomCssJS.js文件路径是否正确，浏览器控制台是否有报错
• 客户端不加载：移动应用需重新打包APK，桌面客户端需确认文件放置位置

通过以上步骤，你已经完成了Emby.CustomCssJS插件的完整部署。现在可以开始探索自定义界面的无限可能，打造专属于你的媒体服务器体验！