henkallsn/tinymediamanager

tinyMediaManager Docker

描述

这是一个包含TinyMediaManager的Docker镜像，提供Web图形界面和VNC图形界面。

![]([]

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

使用说明：

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

使用方法

示例运行命令

bash
docker run -d --name=tinymediamanager \
-v /path/to/tinymediamanager/config:/config \
-v /path/to/media:/media \
-e GROUP_ID=0 -e USER_ID=0 -e TZ=Europe/Madrid \
-p 5800:5800 \
-p 5900:5900 \
henkallsn/tinymediamanager

Portainer栈示例compose配置

bash
---
version: "2.1"
services:
  tinymediamanager:
    image: henkallsn/tinymediamanager
    container_name: TinyMediaManager
    environment:
      - USER_ID=0
      - GROUP_ID=0
      - TZ=Europe/Copenhagen
    volumes:
      # 记得修改路径
      - /path/to/tinymediamanager/config:/config
      # 记得修改路径
      - /path/to/media:/media
    ports:
      # Web图形界面端口
      - 5800:5800
      # VNC端口
      - 5900:5900
    restart: unless-stopped

访问 http://你的主机IP:5800 即可打开TinyMediaManager图形界面。

环境变量

要自定义容器的某些属性，可通过-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）的值就是应提供给容器的ID。

安全

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

可通过SECURE_CONNECTION环境变量启用安全连接。有关如何设置环境变量的更多详细信息，请参见环境变量部分。

启用后，通过浏览器访问时，应用图形界面通过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 CONTAINER sh

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

反向代理

以下部分包含需要添加到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;
		}
	}
}