Emby 媒体库刮削终极指南：MDCX 与 MDCNG 对比与部署教程

搭建好 Emby 媒体库后，最头疼的问题来了——文件命名不规范，Emby 识别不出来。手动整理几百部视频的元数据简直噩梦。这就是刮削器的价值所在：自动识别视频番号、抓取元数据、下载封面海报、生成 NFO 文件，让 Emby 完美识别每一部作品。本文将详细介绍两大主流刮削工具——MDCX（桌面端）和 MDCNG（Web 端 / Docker），并指导你如何在甲骨文 ARM 服务器上部署。

什么是刮削器？为什么需要它？

当你从 115 网盘下载了一批视频文件，文件名往往是乱码、哈希值或简写编号。Emby 自带的元数据识别引擎（TMDB / IMDb）对这类内容几乎无能为力。结果是：媒体库里一片空白封面、未知标题、缺少演员信息。

刮削器的工作流程：

识别文件名中的番号 → 多源爬取元数据（标题、演员、日期、系列）
→ 下载处理封面海报 → 生成 NFO 文件 + 整理目录 → Emby 完美识别

目前社区中最活跃的两大刮削工具分别是 MDCX（经典桌面端）和 MDCNG（新一代 Web 端）。两者都源自 Movie Data Capture (MDC) 项目生态。

MDCX：经典桌面刮削器

MDCX（GitHub: sqzw-x/mdcx，⭐ 3600+）是 Movie Data Capture 系列最活跃的桌面端 Fork，基于 Python + PyQt 构建，提供 Windows / macOS 图形界面。

核心特性

• 图形界面：PyQt 桌面应用，所见即所得
• 多源刮削：支持 javdb、javbus、mgstage 等主流数据源
• 多种整理模式：硬链接、软链接、复制、移动、原地刮削
• 自定义规则：灵活的文件命名模板和目录结构
• 图片处理：自动下载海报、裁剪、添加水印
• NFO 生成：兼容 Emby / Jellyfin / Kodi 的 Kodi NFO 格式

适用场景

• 在本地电脑上整理视频文件，再上传/同步到服务器
• 习惯桌面 GUI 操作，不想折腾命令行
• Windows / macOS 用户

快速上手

从 Release 页面 下载对应系统的可执行文件，解压后运行 MDCx.exe（Windows）或 MDCx.app（macOS）即可。

基本使用流程：
1. 打开软件 → 设置刮削源（默认即可）
2. 选择输入目录（包含待整理视频）
3. 选择输出目录（Emby 媒体库路径）
4. 配置命名规则（番号-标题/演员）
5. 点击"开始刮削"

局限性：MDCX 是桌面端工具，需要在有 GUI 的系统上运行，无法直接部署在无头服务器（如甲骨文 ARM）上。对于纯服务器场景，推荐使用 MDCNG。

MDCNG：新一代 Web 刮削器

MDCNG（GitHub: mdc-ng/mdc-ng，⭐ 1500+）意为 “MDC Next Generation”，是全新架构的下一代刮削器，Rust 后端 + Next.js 前端，通过 Web 界面管理，天生支持 Docker 和服务器部署。

核心特性

• 30+ 刮削源：覆盖各类视频类型，支持优先级配置和反爬虫策略
• AI 人脸识别裁剪：智能定位人脸区域，自动裁剪海报
• 5 种整理模式：硬链接（推荐）、复制、移动、软链接、原地整理
• 目录监控：自动检测新文件并刮削，支持性能模式和兼容模式
• 演员管理：联动 Emby 自动刮削演员信息和图片，内置演员数据库
• 图片增强：4K/8K 海报、影片类型水印标签，自定义样式
• 智能翻译：OpenAI / Google 等多引擎翻译，内置中文标题库
• 现代 Web 界面：响应式设计、登录认证、主题切换、NSFW 模式

技术优势

• 高性能：Rust 原生性能，多线程并发，刮削速度快
• 轻量化：Docker 镜像 < 300MB，内存占用 < 300MB
• 稳定可靠：内存安全，无 GC 停顿，适合 7×24 运行
• 部署简单：Docker 一键启动，完美适配甲骨文 ARM 服务器

MDCNG Docker Compose 部署教程

承接上篇文章的甲骨文 ARM 服务器环境，我们继续用 Docker Compose 部署 MDCNG。

创建目录和配置文件

# 创建 MDCNG 工作目录
sudo mkdir -p /opt/docker/mdcng

Docker Compose 配置

创建 /opt/docker/mdcng/docker-compose.yml：

version: "3.1"
services:
  mdcng:
    image: mdcng/mdc:latest
    container_name: mdcng
    restart: always
    environment:
      - TZ=Asia/Shanghai
      - PUID=1000
      - PGID=1000
      - MDC_USERNAME=admin         # Web 登录用户名
      - MDC_PASSWORD=*** # Web 登录密码
    volumes:
      - /opt/docker/data/mdcng-config:/config
      - /opt/docker/data/clouddrive2-media:/media  # CloudDrive2 媒体目录
      - /opt/docker/data/emby-config:/emby          # Emby 媒体库（输出目标）
    ports:
      - 9208:9208

networks:
  default:
    name: media-net
    external: true

目录映射说明：

• /config：MDCNG 配置和数据库持久化
• /media：CloudDrive2 挂载的 115 网盘内容（输入源）
• /emby：Emby 媒体库路径（输出目标），刮削整理后的文件放这里

启动并访问

cd /opt/docker/mdcng
docker-compose up -d

# 查看日志确认启动
docker logs -f mdcng

浏览器访问 http://<服务器IP>:9208，输入你设置的用户名和密码登录。

通过 NPM 配置域名访问

登录 Nginx Proxy Manager → Add Proxy Host：

• Domain：mdc.yourdomain.com
• Forward Hostname：mdcng
• Port：9208
• SSL：开启 + Force SSL

刮削实战流程

第一步：配置刮削源

登录 MDCNG → 设置 → 刮削源，根据你的视频类型启用对应的数据源。常用源包括 javdb、javbus、mgstage 等。可以拖拽调整优先级。

第二步：创建刮削任务

进入”手动整理” → 选择输入目录（/media/115/你的视频目录）→ 扫描文件 → 选择要刮削的文件 → 批量执行。

整理模式选择建议：

• 硬链接（推荐）：不占用额外空间，源文件和目标文件共享同一数据块，删除任一方不影响另一方
• 软链接：创建符号链接，适合同文件系统内使用
• 复制：跨文件系统时使用，会占用双倍空间
• 原地整理：直接在源目录生成 NFO，不做文件迁移

推荐目录结构：按演员分文件夹

整理媒体库时，强烈建议按演员分文件夹。这不仅方便浏览和管理，还能让 Emby 的合集和演员视图更加清晰。推荐结构如下：

/emby/媒体库/
├── 演员A/
│   ├── ABC-001/
│   │   ├── ABC-001.mp4
│   │   ├── ABC-001.nfo
│   │   └── folder.jpg
│   └── XYZ-002/
│       └── ...
├── 演员B/
│   ├── DEF-003/
│   └── GHI-004/
└── 未分类/          # 暂时无法识别演员的放这里

在 MDCNG 中配置：进入设置 → 整理规则 → 输出目录模板，使用 {actor} 变量将作品自动归类到演员名文件夹中：

# MDCNG 目录模板示例
/emby/媒体库/{actor}/{number} - {title}

# 实际效果：
/emby/媒体库/演员A/ABC-001 - 作品标题/

MDCX 同理，在命名规则中配置 {actor}/{number} 即可实现自动归类。

这样做的好处：

• Emby 按文件夹扫描时，天然形成”演员 → 作品”的层级，无需额外配置合集
• 手动浏览文件系统时一目了然
• 新增同一演员的作品时自动归入对应文件夹，不会散落各处
• 配合 MDCNG 的演员管理功能，还能自动补充演员头像和简介

第三步：配置目录监控（自动化）

配置好一次后，开启”目录监控”功能即可实现全自动刮削：

监控模式选择：
• 性能模式：实时监听文件变更（适合本地存储）
• 兼容模式：定时轮询检查（适合 115 网盘挂载，推荐）

新增到网盘的文件会被自动检测、刮削、整理到 Emby 媒体库目录，全程无需人工干预。

第四步：Emby 扫描入库

刮削完成后，MDCNG 在目标目录生成了：

输出目录结构示例：
/emby/媒体库/
├── ABC-001/
│   ├── ABC-001.mp4          # 视频文件（硬链接/复制）
│   ├── ABC-001.nfo          # Kodi NFO 元数据
│   ├── folder.jpg            # 封面海报
│   ├── poster.jpg            # 海报图
│   ├── fanart.jpg            # 背景图
│   └── ABC-001-trailer.mp4   # 预告片

在 Emby 后台 → 媒体库 → 扫描库文件，Emby 会自动读取 NFO 文件和图片，媒体库瞬间”丰满”起来。

MDCX vs MDCNG 对比

总结与建议

• 桌面用户、习惯 GUI 操作、偶尔整理 → 选 MDCX
• 服务器用户、甲骨文 ARM、需要 7×24 自动刮削 → 选 MDCNG
• 最佳实践：MDCNG 部署在服务器上 + 开启目录监控 + 兼容模式，搭配 Emby + go-emby2openlist，实现”网盘新增 → 自动刮削 → Emby 识别 → 302 直连播放”的全自动流水线

完整技术栈：

115网盘 → CloudDrive2 挂载 → MDCNG 自动刮削 → Emby 扫描入库
                                           ↓
                                go-emby2openlist 反代 (302直连)
                                           ↓
                                NPM 域名 + HTTPS → 客户端播放

刮削器是媒体库自动化的”最后一公里”。配合前文搭建的甲骨文 ARM 服务器环境，你现在拥有了一套从存储、整理、管理到播放的完整私人流媒体解决方案。