docker-embyhack

通过简单的 docker-compose 命令，您就能快速搭建并激活自己的 Emby 服务器。

温馨提示：如果您的经济条件允许，请考虑购买 Emby Premiere 来支持开发者。

🚀 快速上手

1. 下载 Release：请从 Releases 页面 下载最新的 docker-embyhack.zip 文件。
2. 解压文件：解压后，您会得到 docker-compose.yml 文件和一个 system/ 文件夹。
3. 修改配置：主要调整 docker-compose.yml 文件中的媒体库路径映射。
4. 启动服务：在文件所在目录运行 docker-compose up -d 命令，即可启动 Emby 服务。

⚠️ 注意

自带的默认验证地址 https://mb3admin.megm.workers.dev/ 运行在 cloudflare workers ，不保证长期可用（可能受 DNS 污染、服务商限制等因素影响）。
为了获得更稳定的体验，你也可以使用下面的自定义构建方法。

⚙️ 配置说明

在启动服务前，您需要修改 docker-compose.yml 文件，将服务器上的媒体路径挂载到容器中。

请修改 volumes 部分，将 /path/to/your/movies 和 /path/to/your/tvshows 替换为您服务器上的实际路径。

services:
  emby:
    # ... 其他配置 ...
    volumes:
      # emby 的配置目录
      - ./config:/config

      # 按需配置媒体目录
      - ./data:/data
      - ./path/to/your/movies:/movies # 电影媒体库，请修改为您的实际路径
      - ./path/to/your/tvshows:/tv # 电视剧媒体库，请修改为您的实际路径

      # 以下为系统数据，请勿修改
      - ./system/Emby.Web.dll:/app/emby/system/Emby.Web.dll:ro
      ...

---

🛠️ 自定义构建（可选）

此方法能让你自己创建验证服务。

步骤 1：创建您的验证服务器

使用 Cloudflare Worker 是最简单的方式：

1. 登录您的 Cloudflare 账户，进入 "Workers & Pages" 并创建一个新的 Worker。
2. 将本项目 mocks/worker.js 文件中的代码完整复制到 Worker 中。
3. 保存并部署该 Worker，即可获得一个专属 URL。请务必在 URL 末尾加上斜杠 /，最终格式应为 https://your-worker.workers.dev/。
4. （可选）如果 workers.dev 域名在您所在区域不可用，可以在 Worker 后台绑定自定义域名。

其他本地部署方案（适用于内网环境）：

• Nginx 配置示例: mocks/nginx.conf
• Caddy 配置示例: mocks/Caddyfile

步骤 2：通过 GitHub Actions 自定义构建

1. Fork 本仓库：点击页面右上角的 "Fork" 按钮，将此项目复制到您的 GitHub 账户下。
2. 触发构建：在 Fork 后的仓库页面，进入 "Actions" 标签页，选择 "Release" 工作流，点击 "Run workflow"。
3. 输入参数：在 your_mb3admin_replacement_url 输入框中，填入上一步创建的 Cloudflare Worker URL。
4. 下载产物：等待 Action 运行完成，下载打包好的 docker-embyhack.zip 文件。

步骤 3：部署

解压 docker-embyhack.zip 文件，修改 docker-compose.yml 配置后，执行 docker-compose up -d 命令即可启动。

---

❓ 常见问题 (FAQ)

Q1: 为什么需要验证服务器？

A: Emby 客户端与服务器默认会向 mb3admin.com 发送请求以验证 Emby Premiere 许可证。

本项目通过将此请求重定向到一个模拟的验证服务器来激活功能。您可以选择使用公共服务器，或为了稳定性自行搭建。

Q2：为什么要映射 Emby 文件，而不是用中间人攻击 (MITM) 方案？

旧方案的不足

传统的中间人攻击（MITM）方案问题不少。

它不仅需要复杂的 HTTPS 证书管理（得定期更新和信任证书），还限制了 Docker 网络模式的灵活性（比如没法用 network_mode=host）。

这使得网络配置复杂，并且容易遇到 Docker DNS 不稳定等网络故障，增加了部署难度和潜在问题。

新方案的优势

新方案通过直接修改 Emby 内部文件来替换认证地址，彻底解决了这些问题，且改动极小。

它无需证书管理，网络配置更自由、更稳定，可以直接使用 host network，不依赖 Docker DNS，同时大幅减少了故障点。这让部署更简单，体验也更流畅。

Q3: 关于“Support Emby”的提示？

A: 进入 Emby 后台管理页面时，会在“设置”中看到一个“Support Emby”的提示。

请放心，这个提示可以随时折叠，并且不会在播放页面显示，完全不影响正常使用。

添加此提示仅为提醒大家，如果条件允许，请多多支持正版。