htpcmanager Docker 镜像功能介绍
htpcmanager 是一个为家庭影院电脑(Home Theater PC, HTPC)设计的管理工具,它提供了一个轻量级的 Web 用户界面,用于监控和管理各种应用。通过 htpcmanager,用户可以集中管理如 Plex、Sonarr、Radarr、Tautulli、Nextcloud 等媒体服务器和下载任务,查看电影播放状态、管理下载队列等。
实际应用场景
- 媒体管理:集中管理媒体服务器,如 Plex,方便用户访问和播放媒体文件。
- 下载管理:集成下载管理器,如 Sonarr 和 Radarr,用于自动化管理和下载电影、电视节目。
- 监控与报告:监控系统状态,如 CPU 使用率、磁盘空间等,并生成报告。
- 数据同步:通过集成如 Nextcloud 等应用,实现数据的同步和共享。
Docker CLI 方式搭建 htpcmanager
拉取镜像:
docker pull linuxserver/htpcmanager
运行容器:
docker run -d \ --name=htpcmanager \ -e PUID=1000 \ -e PGID=1000 \ -e TZ=Europe/London \ -p 80:80 \ -v /path/to/appdata:/config \ linuxserver/htpcmanager
-d
:以 detached 模式运行容器。--name=htpcmanager
:设置容器的名称。-e PUID=1000
和-e PGID=1000
:设置容器的用户 ID 和组 ID,通常与宿主机的用户 ID 和组 ID 相匹配。-e TZ=Europe/London
:设置容器的时区。-p 80:80
:将容器的 80 端口映射到宿主机的 80 端口,用于 Web 访问。-v /path/to/appdata:/config
:将宿主机的目录挂载到容器中,用于持久化存储配置文件。
Docker Compose 方式搭建 htpcmanager
创建
docker-compose.yml
文件:version: '3' services: htpcmanager: image: linuxserver/htpcmanager environment: PUID: 1000 PGID: 1000 TZ: Europe/London volumes: - /path/to/appdata:/config ports: - "80:80" restart: unless-stopped
version: '3'
:指定 Docker Compose 文件的版本。services
:定义服务。image
:指定使用的 Docker 镜像。environment
:设置环境变量。volumes
:定义卷,用于数据持久化。ports
:映射端口。restart: unless-stopped
:设置容器的重启策略。
启动服务:
docker-compose up -d
参数解释
PUID
和PGID
:用于指定运行容器的用户和组 ID,通常设置为宿主机的用户 ID 和组 ID,以便正确处理文件权限。TZ
:设置容器的时区,以确保时间相关的功能(如定时任务)正确运行。volumes
:定义数据卷,用于存储配置文件和数据,以便在容器重启后保留。ports
:映射容器端口到宿主机,使外部可以访问容器中运行的应用程序。restart
:定义容器的重启策略,unless-stopped
表示除非明确停止,否则容器将始终运行。