coolasice1999/tmm

TinyMediaManager Docker镜像

镜像概述

这是一个功能完整的TinyMediaManager Docker容器，包含GUI界面，基于Alpine Linux（体积小巧），已在Synology和QNAP设备上测试通过，适用于所有x86_64设备。感谢@jlesage提供的GUI应用基础镜像。

核心功能

• 提供TinyMediaManager完整GUI功能，用于整理电影、电视剧等媒体文件的元数据
• 支持通过Web（5800端口）或VNC（5900端口）访问界面
• 基于Alpine Linux，镜像体积小且高效
• 支持持久化存储配置和媒体文件
• 可自定义环境变量（如用户ID、时区、窗口尺寸等）

使用场景

• Synology、QNAP等NAS设备上部署，管理个人媒体库
• 个人服务器或电脑上搭建媒体元数据管理系统
• 需要远程访问媒体管理界面的场景

配置说明

部署示例

bash
docker run -d --name=tinymediamanager \
-v /share/Container/tinymediamanager/config:/config \
-v /share/Container/tinymediamanager/media:/media \
-e GROUP_ID=0 -e USER_ID=0 -e TZ=Europe/Madrid \
-p 5800:5800 \
-p 5900:5900 \
docker.xuanyuan.run/romancin/tinymediamanager:latest

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

环境变量

通过-e参数传递环境变量，格式为<变量名>=<值>：

数据卷

通过-v参数映射数据卷，格式为<主机目录>:<容器目录>[:权限]：

端口映射

通过-p参数映射端口：

用户/组ID

为避免权限问题，可通过USER_ID和GROUP_ID指定应用运行的用户/组。在主机上执行id <用户名>获取ID：

bash
id myuser

输出示例：uid=1000(myuser) gid=1000(myuser) ...，将USER_ID=1000和GROUP_ID=1000传递给容器。

安全

• 加密连接：设置SECURE_CONNECTION=1启用HTTPS（Web）和SSL VNC。
• 证书：默认使用自签名证书，可在/config/certs目录替换为自定义证书。
• VNC密码：通过VNC_PASSWORD或/config/.vncpass_clear文件设置（最多8字符），建议启用加密连接。

反向代理配置

基于主机名路由（NGINX）

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

upstream tinymediamanager {
	server 127.0.0.1:5800;
}

server {
	server_name tinymediamanager.domain.tld;

	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）

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

upstream tinymediamanager {
	server 127.0.0.1:5800;
}

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

容器Shell访问

bash
docker exec -ti tinymediamanager sh