TinyMediaManager 群晖 Container Manager 部署文档

简介

TinyMediaManager（简称TMM），用于媒体文件元数据刮削，自动抓取电影/剧集海报、简介、演员信息，生成.nfo元数据文件，可被Jellyfin、Immich等媒体服务器读取。

一、准备工作

  1. 在File Station创建媒体目录，存放电影视频文件。
  2. 创建Docker项目目录，用于存放TMM配置数据。
  3. 记录媒体目录路径，后续用于挂载。

二、docker-compose.yml

services:
  tinymediamanager:
    image: tinymediamanager/tinymediamanager:latest
    container_name: tinymediamanager
    restart: always
    ports:
      - "4000:4000"
    volumes:
      - ./data:/data
      - /volume3/FTP:/media
    environment:
      - TZ=Asia/Shanghai
      - USER_ID=0
      - GROUP_ID=0

说明：/volume3/FTP替换为NAS内实际媒体文件夹路径。

三、部署步骤

  1. 打开群晖Container Manager，新建项目。
  2. 将上述内容粘贴至docker-compose.yml。
  3. 启动项目，等待镜像拉取与容器启动完成。
  4. 浏览器访问 http://NAS内网IP:4000，进入TMM网页端。

四、媒体库添加

  1. 左侧切换至【电影】，打开【媒体库目录】。
  2. 添加路径 /media，保存设置。
  3. 点击【更新数据源】，扫描目录内所有视频文件。

五、元数据刮削基础设置

  1. 打开【设置】→【电影】→【元数据刮削】→【高级选项】
    • 首选语言：中文 (中国) (zh)
    • 勾选TMDB、IMDb评分源
    • 开启【自动刮削匹配】，相似度指数保持75
  2. 【元数据刮削默认设置】勾选需要抓取内容：标题、年份、剧情、演员、海报、粉丝艺术图等。
  3. 【NFO设置】开启NFO文件写入，元数据会保存在视频同目录。

六、批量刮削操作

  1. 电影列表使用快捷键Ctrl+A全选全部影片。
  2. 右键选择【搜索并刮削选定电影（自动匹配）】。
  3. 刮削源选择TMDB，语言中文，确认开始批量刮削。

    文件名规范（影片名+年份）可全自动匹配；文件名模糊会弹出候选窗口人工选择。

七、群晖定时任务（自动扫描+刮削新增影片）

1. 创建计划任务

  1. 群晖【控制面板】→【任务计划程序】→【创建】→【计划的脚本任务】
  2. 常规：任务名称自定义，运行用户选择root
  3. 计划：重复每天，设置执行时间，推荐凌晨5点
  4. 任务设置，用户定义脚本：
    docker exec tinymediamanager tinyMediaManager movie --updateAll --scrapeNew

    脚本作用：扫描媒体库，自动刮削本次扫描发现的新电影。

2. 任务测试

保存任务后，选中任务点击【运行】手动触发，在TMM页面查看扫描与刮削日志，验证脚本是否正常工作。

电视剧库可新建独立定时任务，脚本：

docker exec tinymediamanager tinyMediaManager tvshow --updateAll --scrapeNew

八、使用要点

  1. 新增视频文件后，可手动点击【更新数据源】立即扫描。
  2. 元数据、海报图片会直接写入视频所在文件夹，兼容主流媒体服务器。
  3. 相似度阈值不建议调低，容易出现影片识别错误。

九、常见问题

  1. Permission denied：目录权限不足，容器使用USER_ID=0以root身份运行，或配置对应目录读写权限。
  2. 刮削无中文信息：元数据刮削高级选项，首选语言修改为中文。
  3. 定时任务不执行：任务必须使用root用户运行，确认容器名称和脚本内名称保持一致。

关于音乐媒体说明

TinyMediaManager 免费版仅支持电影、电视剧元数据刮削，不支持音乐（MP3/FLAC等音频）。 如需对音乐库抓取专辑封面、歌手、专辑元数据：

  1. MusicBrainz Picard：批量修改音频内置标签与封面。

  2. Navidrome：音乐服务器，自带音乐元数据刮削能力。