TMM Install Banner

TinyMediaManager Ubuntu 安装与配置：手把手搭好你的媒体库预处理中心

上一篇文章介绍了 TMM 是什么，这篇来实操。

我会讲两种安装方式：直接安装（适合桌面环境）和 Docker 部署（适合服务器/NAS 无头运行）。你可以根据自己的情况选。

方式一：Ubuntu 直接安装

TMM 是 Java 写的，但 v4 以后自带了 Java 运行时，不需要额外装 JDK/JRE——解压即用。

1. 下载

去官方下载站 release.tinymediamanager.org 或 GitHub Releases 页面下载 Linux 版本：

Bash
# 下载最新版（以 v5.2.12 为例）
wget https://release.tinymediamanager.org/v5.2.12/tinyMediaManager-5.2.12-linux.zip

2. 解压

Bash
unzip tinyMediaManager-5.2.12-linux.zip -d /opt/tinymediamanager
cd /opt/tinymediamanager

3. 运行

Bash
./tinyMediaManager

第一次启动会弹出向导界面：选择语言、主题（暗色/亮色）、更新检查等。

4. 创建桌面图标

如果你想在应用菜单里启动：

Bash
cat > ~/.local/share/applications/tinyMediaManager.desktop <<EOF
[Desktop Entry]
Type=Application
Terminal=false
Name=tinyMediaManager
Icon=/opt/tinymediamanager/tmm.png
Exec=/opt/tinymediamanager/tinyMediaManager
Categories=AudioVideo;
EOF

5. 挂载你的媒体目录

TMM 不会帮你移动文件，它只读取和写入元数据。确保你的电影/电视剧目录 TMM 有读写权限：

Bash
# 如果媒体文件在 /mnt/media/movies 和 /mnt/media/tvshows
chown -R $USER:$USER /mnt/media

然后在 TMM 的设置中添加对应的媒体源。

6. 如果需要代理

TMM 支持在设置中单独配置刮削源的代理——如果你访问 TMDB 需要科学上网，可以在「设置 → 连接」里配置 HTTP 代理。

这一条是中国用户的刚需。

方式二：Docker 部署（推荐服务器/无头模式）

如果你的媒体服务器跑在无桌面的 Ubuntu 服务器或 NAS 上，Docker 是更好的选择。

docker-compose.yml

Yaml
version: "2.1"
services:
  tinymediamanager:
    image: tinymediamanager/tinymediamanager:latest
    container_name: tmm
    environment:
      - USER_ID=1000
      - GROUP_ID=1000
      - ALLOW_DIRECT_VNC=true
      - LC_ALL=zh_CN.UTF-8
      - LANG=zh_CN.UTF-8
      - PASSWORD=your_vnc_password
      - TZ=Asia/Shanghai
    volumes:
      - ./tmm_data:/data
      - /path/to/movies:/media/movies
      - /path/to/tvshows:/media/tv_shows
    ports:
      - 5900:5900   # VNC
      - 4000:4000   # Web 界面（TMM v5+）
    restart: unless-stopped

启动：

Bash
docker-compose up -d

访问方式

Docker 容器内跑了一个 VNC 服务器，你可以用 VNC 客户端连接 localhost:5900 操作图形界面。

密码就是上面 PASSWORD 环境变量设置的值。

对于 TMM v5 及以上版本，还支持 Web 界面：浏览器打开 `http://localhost:4000`，也能操作。

提示：Docker 版的 TMM 是给「必须在后台跑」的场景设计的。如果你能用桌面版，体验更好。

基础配置：让 TMM 认识你的媒体库

启动 TMM 后，第一件事就是添加媒体源。

添加电影目录

菜单栏 → 设置 → 电影 → 在「媒体目录」标签页，点击「添加」，选择你的电影目录。

比如你的电影存在 /media/movies，就添加这个路径。

添加电视剧目录

同样的操作：设置 → 电视节目 → 添加媒体目录。

选择刮削源

设置 → 电影 → 刮削器，选择元数据来源：

  • TheMovieDB（推荐，数据最全）
  • IMDb
  • OFDb（德国电影较多）
  • MovieMeter（荷兰电影较多）

语言建议选 zh-CN，这样刮削到的标题、简介都是中文。

设置 → 电影 → 艺术作品，选择海报/背景图的来源：

  • TheMovieDB
  • Fanart.tv

NFO 设置

设置 → 电影 → NFO，确保以下选项是勾选状态：

  • ✅ 写入 NFO
  • ✅ 使用 Kodi/Emby/Jellyfin 兼容格式

这样刮削完成后，每部电影目录下都会生成一个 .nfo 文件，里面包含完整的元数据（XML 格式）。Emby/Jellyfin 扫描时直接读取 NFO，不需要联网。

使用流程

配置完成后，日常工作流就三步：

1. 更新媒体库

主界面点击「更新媒体库」→「更新所有媒体目录」。TMM 会扫描目录，识别影片文件和现有的 NFO。

首次扫描几千部电影可能需要一些时间，因为要分析每个文件。后续扫描会快很多——只会检查新增或变动的文件。

2. 搜索并刮削

选中所有电影（Ctrl+A），点击「搜索并刮削」。

TMM 会联网查询 TMDB，下载元数据和海报。如果自动匹配正确，几秒就完成一部。如果匹配失败，会弹窗让你手动搜索。

3. 在媒体服务器中刷新

回到 Emby/Jellyfin，对媒体库执行「扫描文件系统」或「刷新元数据」。因为 NFO 文件已经存在，扫描几乎是瞬时的。

和 Emby/Jellyfin 的配合技巧

最常用的配合方式是：

  1. TMM 做元数据预处理：新的电影文件放到媒体目录后，在 TMM 里刮削，生成 NFO 和海报
  2. Emby/Jellyfin 直接读取本地数据：关闭 Emby 的自动刮削，让它只读取本地 NFO

在 Emby 中这样配置：

Emby 服务器 → 媒体库 → 你的电影库 → 设置 → 元数据下载器：取消勾选所有在线刮削器，只保留「本地 NFO」。

这样 Emby 永远不会联网刮削——所有的元数据都由 TMM 一手包办，准确率由你掌控。

常见问题

启动后窗口一片空白？

某些 Linux 桌面环境下，Java/Swing 的渲染可能有问题。

解决： 在启动时强制指定渲染管道：

Bash
./tinyMediaManager -Dsun.java2d.opengl=true

或者在终端中设置环境变量：

Bash
export _JAVA_OPTIONS="-Dsun.java2d.opengl=true"
./tinyMediaManager

提示 libmediainfo 不可用？

Bash
sudo apt install libmediainfo-dev

刮削速度很慢？

  • 检查网络连接，TMDB 可能需要代理
  • 第一次刮削大库确实慢，后续增量刮削会快得多
  • Docker 版首次刮削建议用 VNC 操作，后续可以命令行自动化

字幕下载用不了？

2024 年起 OpenSubtitles 需要 VIP 账号才能下载字幕。免费用户无法通过 API 下载。

小结

TMM 的 Ubuntu 安装很简单——不管是直接装还是 Docker 部署，十分钟就能搞定。

它的价值不在于安装本身，而在于建立一套工作流：新电影入库 → TMM 刮削 → Emby/Jellyfin 读取 → 观看到结束。一旦跑顺了，你的媒体库维护就进入了「无人值守模式」。

下一篇我会讲 TMM 的进阶玩法：批量整理技巧、HTTP API 自动化、以及如何用脚本实现全自动流程。

最后修改： 2026年7月6日

作者

评论

发表评论

您的邮箱地址不会被公开。