huaihuai0406/tinymediamanager

tinymediamanager-docker

基于Alpine Linux构建的轻量TinyMediaManager容器镜像，集成中文字体支持，提供完整GUI功能，已在Synology、QNAP等设备验证可用。

镜像概述

本镜像基于jlesage的GUI应用基础镜像，实现TinyMediaManager的容器化部署，支持通过Web（5800端口）或VNC（5900端口）访问界面，专注于媒体文件的元数据管理与整理。

核心功能

1. 媒体元数据刮削：自动获取电影/剧集的海报、简介、演员等信息
2. 多端访问：支持Web浏览器和VNC客户端两种交互方式
3. 无人值守模式：通过脚本执行自动化任务（如更新电影、刮削新文件）
4. 中文适配：内置中文字体，解决中文显示问题

使用场景

• 家庭NAS媒体库的元数据整理
• 个人媒体服务器的自动化刮削任务
• 批量处理新增媒体文件的元数据更新

配置说明

部署示例

Docker Run命令

bash
docker run -d --name=tinymediamanager \
-v /本地路径/config:/config \  # 配置文件存储目录
-v /本地路径/media:/media \    # 媒体文件目录
-e GROUP_ID=0 -e USER_ID=0 -e TZ=Asia/Shanghai \  # 时区建议改为Asia/Shanghai
-p 5800:5800 \                  # Web访问端口
-p 5900:5900 \                  # VNC访问端口
huaihuai0406/tinymediamanager:latest

访问 http://你的主机IP:5800 即可进入GUI界面。

无人值守脚本运行

bash
docker run --rm --name=tinymediamanagerscript \
-v /本地路径/config:/config \
-v /本地路径/media:/media \
-e GROUP_ID=0 -e USER_ID=0 -e TZ=Asia/Shanghai \
huaihuai0406/tinymediamanager:latest /config/tinyMediaManagerCMD.sh -updateMovies -scrapeNew

--rm 表示任务完成后自动删除容器。

环境变量

关键环境变量说明：

数据卷映射

端口映射

用户/组ID设置

为避免权限问题，需将 USER_ID 和 GROUP_ID 设为本地用户ID。通过 id <用户名> 命令获取：

bash
id 你的用户名

输出中的 uid 和 gid 即为需设置的值。

安全设置

• 加密连接：设置 SECURE_CONNECTION=1 启用HTTPS和VNC SSL。
• VNC密码：通过 VNC_PASSWORD 或 /config/.vncpass_clear 文件设置密码。

NGINX反向代理配置

基于主机名路由

nginx
map $http_upgrade $connection_upgrade {
    default upgrade;
    ''      close;
}

upstream tinymediamanager {
    server 127.0.0.1:5800;  # 替换为容器所在主机IP
}

server {
    server_name tinymediamanager.yourdomain.com;

    location / {
        proxy_pass http://tinymediamanager;
    }

    location /websockify {
        proxy_pass http://tinymediamanager;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection $connection_upgrade;
        proxy_read_timeout 86400;
    }
}

基于URL路径路由

nginx
map $http_upgrade $connection_upgrade {
    default upgrade;
    ''      close;
}

upstream tinymediamanager {
    server 127.0.0.1:5800;  # 替换为容器所在主机IP
}

server {
    location = /tinymediamanager {return 301 $scheme://$http_host/tinymediamanager/;}
    location /tinymediamanager/ {
        proxy_pass [***]
        location /tinymediamanager/websockify {
            proxy_pass [***]
            proxy_http_version 1.1;
            proxy_set_header Upgrade $http_upgrade;
            proxy_set_header Connection $connection_upgrade;
            proxy_read_timeout 86400;
        }
    }
}