romancin/tinymediamanager

tinymediamanager-docker

用于创建包含TinyMediaManager及GUI界面的Docker容器的仓库。

!docker pulls !docker stars ![Donate]([***]

最新版本：

!Docker Image Version (latest semver) !docker size

!Docker Image Version (tag latest semver) !docker size

如果从v3迁移到v4，请先备份数据。建议创建新的主机目录映射新配置，并将v3版本的"/config/data"文件夹复制到新目录。 请查看官方升级文档：[***]

这是一个功能完整的TinyMediaManager Docker镜像。

基于Alpine Linux，体积非常小。

已在Synology和QNAP上测试可用，但应适用于任何x86_64设备。

感谢@jlesage提供出色的GUI应用基础镜像。

使用说明

• 将本地端口映射到5800用于Web访问
• 将本地端口映射到5900用于VNC访问
• 将本地卷映射到/config（存储配置数据）
• 将本地卷映射到/media（访问媒体文件）

示例运行命令

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 \
romancin/tinymediamanager:v4-latest

通过http://你的主机IP:5800访问TinyMediaManager GUI。

可用镜像标签

环境变量

要自定义容器的某些属性，可通过-e参数传递以下环境变量（每个变量一个）。参数值格式为<变量名>=<值>。

数据卷

下表描述容器使用的数据卷。通过-v参数设置映射，格式为<主机目录>:<容器目录>[:权限]。

端口

下表列出容器使用的端口，可通过-p参数映射到主机（每个端口一个映射），格式为<主机端口>:<容器端口>。容器内端口不可更改，主机端口可任意指定。

用户/组ID

使用数据卷（-v标志）时，主机和容器之间可能出现权限问题。例如，容器内的用户可能在主机上不存在，导致主机无法正常访问共享卷上的文件和文件夹。

为避免问题，可指定应用运行的用户。

通过USER_ID和GROUP_ID环境变量将用户ID和组ID传递给容器。

要找到正确的ID，在主机上以拥有数据卷的用户身份执行以下命令：

id <用户名>

输出类似：

uid=1000(myuser) gid=1000(myuser) groups=1000(myuser),4(adm),24(cdrom),27(sudo),46(plugdev),113(lpadmin)

其中uid（用户ID）和gid（组ID）即为应传递给容器的值。

安全

默认情况下，应用GUI通过未加密连接（HTTP或VNC）访问。

可通过SECURE_CONNECTION环境变量启用安全连接。详见环境变量部分了解如何设置环境变量。

启用后，通过浏览器访问应用GUI时使用HTTPS连接，所有HTTP访问自动重定向到HTTPS。

使用VNC客户端时，VNC连接通过SSL加密。注意，少数VNC客户端支持此方式，SSVNC是其中之一。

证书

容器需要以下证书文件。默认情况下，如缺失会生成并使用自签名证书。所有文件均为PEM编码的x509证书。

注意：为避免浏览器或VNC客户端出现证书有效性警告/错误，请确保提供自己的有效证书。

注意：证书文件会被监控，检测到更改时相关守护进程会自动重启。

VNC密码

可通过以下两种方式指定密码以限制应用访问：

• 使用VNC_PASSWORD环境变量。
• 在/config卷的根目录创建.vncpass_clear文件，文件中包含明文密码。容器启动时，文件内容会被加密并移至.vncpass。

VNC密码的安全级别取决于两点：

• 通信通道类型（加密/未加密）。
• 主机访问的安全性。

使用VNC密码时，强烈建议启用安全连接，防止密码在未加密通道中明文传输。

注意：密码限制为8个字符。此限制来自远程帧缓冲协议RFC（见7.2.2节）。超过限制的字符将被忽略。

Shell访问

要获取运行中容器的shell访问，执行以下命令：

docker exec -ti 容器名或ID sh

其中容器名或ID是创建容器时使用的ID或名称（例如tinymediamanager）。

反向代理

以下是需要添加到NGINX配置以反向代理到此容器的配置。

反向代理服务器可基于主机名或URL路径路由HTTP请求。

基于主机名路由

在此场景中，每个主机名路由到不同的应用/容器。

例如，假设反向代理服务器与容器运行在同一台机器上。服务器会将所有发送到tinymediamanager.domain.tld的HTTP请求代理到127.0.0.1:5800的容器。

以下是添加到NGINX配置的相关配置元素：

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

upstream tinymediamanager {
	# 如果反向代理服务器与Docker容器不在同一台机器上，此处使用Docker主机的IP。
	# 确保根据容器的5800端口在主机上的映射调整端口。
	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路径路由

在此场景中，主机名相同，但使用不同的URL路径路由到不同的应用/容器。

例如，假设反向代理服务器与容器运行在同一台机器上。服务器会将所有server.domain.tld/tinymediamanager的HTTP请求代理到127.0.0.1:5800的容器。

以下是添加到NGINX配置的相关配置元素：

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

upstream tinymediamanager {
	# 如果反向代理服务器与Docker容器不在同一台机器上，此处使用Docker主机的IP。
	# 确保根据容器的5800端口在主机上的映射调整端口。
	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;
		}
	}
}

支持与联系

容器使用遇到问题或有疑问？请https://github.com/romancin/tinymediamanager4-docker/issues/new%E3%80%82