tinymediamanager/tinymediamanager

tinyMediaManager Docker 镜像使用指南

概述

tinyMediaManager 提供基于 Debian Buster 的实验性官方 Docker 镜像（旨在确保最大兼容性）。该镜像包含所有必要组件（如最新版 libmediainfo、FFmpeg 等），可提供最佳使用体验，适用于各类 x86_64 设备。通过此镜像，你可部署完整功能的 tinyMediaManager 实例，并通过 web/VNC 进行远程访问。

使用说明

1. 端口映射

• 将本地任意端口映射到容器的 4000 端口，用于 web 访问（基于 noVNC）。

2. 数据卷映射

• 核心数据卷：需将本地文件夹映射到容器的 /data 目录，用于存储 tinyMediaManager 的所有本地数据（如 data、logs、cache、backups 等）。若不映射此目录，升级镜像时所有配置和数据会丢失。
• 媒体文件卷：需将本地媒体文件所在目录映射到容器的 /media/xxx 目录（xxx 可自定义，需与本地媒体类型对应）。例如：
  • 本地电影目录 /mnt/movies → 容器内 /media/movies
  • 本地剧集目录 /mnt/tvshows → 容器内 /media/tvshows
• 自定义刮削器：若需添加自定义元数据刮削器（scrapers），需将存放自定义插件的本地文件夹映射到容器的 /app/addons 目录。
• HTTP API 端口：若使用 v4.3 及以上版本并需启用 HTTP API，需额外映射 HTTP API 端口。
• 自定义启动参数：若需配置自定义启动参数，需映射本地的 /app/launcher-extra.yml 文件（配置方法见 [官方文档] ）。

示例运行命令

通过以下 Docker 命令快速启动容器：

bash
docker run \
    --name=tinymediamanager \
    -p 4000:4000 \
    -v </path/to/local/data/>:/data \
    -v </path/to/movies>:/media/movies \
    -v </path/to/tvshows>:/media/tvshows \
    -v </path/to/addons/>:/app/addons \
    docker.xuanyuan.run/tinymediamanager/tinymediamanager:latest

启动后，通过 `[] 访问 tinyMediaManager。

示例 Compose 文件

若使用 Docker Compose 管理，可参考以下配置（适用于 version: "2.1"）：

CODE_TOKEN_1

数据卷说明

以下卷必须映射，否则可能导致功能异常或数据丢失：

• /data：存储配置、日志、缓存等核心数据，不映射会导致升级镜像时数据丢失。
• /media/xxx：媒体文件目录，需按实际媒体类型（如 movies、tvshows）映射。
• /app/addons：存放自定义刮削器插件（如有）。
• /app/launcher-extra.yml：自定义启动参数文件（如需），需添加以下内容以确保正常运行：
  CODE_TOKEN_2

注意：所有映射的本地卷需确保容器有读写权限。

配置参数

可通过环境变量调整容器配置，参数说明如下：

权限设置

使用数据卷（-v 参数）时，若本地用户 ID（UID）/组 ID（GID）与容器内默认用户不匹配，可能导致文件读写权限问题（如容器无法访问媒体文件）。解决方法：通过 USER_ID 和 GROUP_ID 环境变量指定容器运行用户的 UID/GID，确保与本地媒体文件所有者一致。

获取本地用户 UID/GID

在主机终端执行以下命令（将 <username> 替换为本地媒体文件所有者的用户名）：
CODE_TOKEN_3
输出示例：
CODE_TOKEN_4
其中 uid 即为 USER_ID，gid 即为 GROUP_ID，填入 Compose 文件或 run 命令的环境变量即可。

剪贴板使用

由于浏览器安全限制，本地剪贴板无法直接同步到 tinyMediaManager 容器内。若需复制/粘贴内容，需通过 noVNC 的剪贴板功能：

1. 打开 web 界面后，点击窗口左侧的 noVNC 控制面板（图标为齿轮）。
2. 在控制面板中使用剪贴板功能，手动输入或粘贴内容进行同步。

通过以上步骤，即可快速部署并使用 tinyMediaManager Docker 镜像，管理本地媒体文件。