htpcmanager

Htpcmanager Docker Image

lsiodev

HTPC Manager 是一个为多种HTPC相关应用提供统一前端管理的工具,可通过Web界面集中管理媒体中心应用,支持用户权限映射和跨平台部署。

下载次数: 0状态:社区镜像维护者:lsiodev仓库类型:镜像最近更新:

linuxserver/htpcmanager

镜像概述

https://github.com/HTPC-Manager/HTPC-Manager 是一个为多种HTPC(家庭影院个人电脑)相关应用提供统一前端管理的工具。LinuxServer.io团队提供的此镜像具有以下特点:

  • 定期及时的应用更新
  • 简单的用户权限映射(PGID、PUID)
  • 基于s6 overlay的自定义基础镜像
  • 每周基础操作系统更新,通过通用层减少空间占用、停机时间和带宽消耗
  • 定期安全更新

支持的架构

该镜像利用Docker manifest实现多平台支持。只需拉取 lscr.io/linuxserver/htpcmanager:latest 即可自动获取适合您架构的镜像,也可通过标签指定特定架构。

架构支持情况标签
x86-64✅amd64-<版本标签>
arm64✅arm64v8-<版本标签>
armhf❌

应用设置

Web界面可通过端口8085访问。镜像未包含Smartmontools和psutil,日志中相关警告可安全忽略。

使用方法

以下提供docker-compose(推荐)和docker cli两种部署方式。

docker-compose

yaml
---
version: "2.1"
services:
  htpcmanager:
    image: docker.xuanyuan.run/linuxserver/htpcmanager:latest
    container_name: htpcmanager
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
    volumes:
      - /path/to/appdata/config:/config
    ports:
      - 8085:8085
    restart: unless-stopped

docker cli

bash
docker run -d \
  --name=htpcmanager \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -p 8085:8085 \
  -v /path/to/appdata/config:/config \
  --restart unless-stopped \
  docker.xuanyuan.run/linuxserver/htpcmanager:latest

参数说明

容器通过运行时参数进行配置,格式为<外部>:<内部>。

参数功能
-p 8085应用WebUI端口
-e PUID=1000用户ID - 详见下方说明
-e PGID=1000组ID - 详见下方说明
-e TZ=Etc/UTC指定时区,参考时区列表
-v /config配置文件存储路径

来自文件的环境变量(Docker secrets)

可通过特殊前缀FILE__从文件设置环境变量:

bash
-e FILE__MYVAR=/run/secrets/mysecretvariable

这将根据/run/secrets/mysecretvariable文件内容设置MYVAR环境变量。

应用运行的Umask设置

所有镜像支持通过-e UMASK=022覆盖默认umask设置。注意umask是权限减法而非加法,详情参考umask说明。

用户/组标识符

使用卷(-v标志)时,主机与容器间可能出现权限问题。通过指定PUID(用户ID)和PGID(组ID)可避免此问题。确保主机卷目录归属于指定用户。

使用id your_user命令获取您的PUID和PGID:

bash
id your_user

示例输出:

text
uid=1000(your_user) gid=1000(your_user) groups=1000(your_user)

Docker Mods

LinuxServer.io提供多种https://github.com/linuxserver/docker-mods以扩展容器功能。上述徽章链接到该镜像专用及通用mods列表。

支持信息

容器运行时Shell访问

bash
docker exec -it htpcmanager /bin/bash

实时监控容器日志

bash
docker logs -f htpcmanager

容器版本号

bash
docker inspect -f '{{ index .Config.Labels "build_version" }}' htpcmanager

镜像版本号

bash
docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/htpcmanager:latest

更新信息

大多数镜像为静态版本,需更新镜像并重建容器以更新应用。以下是更新容器的方法:

通过Docker Compose

更新镜像:

  • 所有镜像:
    bash
    docker-compose pull
    
  • 单个镜像:
    bash
    docker-compose pull htpcmanager
    

更新容器:

  • 所有容器:
    bash
    docker-compose up -d
    
  • 单个容器:
    bash
    docker-compose up -d htpcmanager
    

清理旧镜像:

bash
docker image prune

通过Docker Run

更新镜像:

bash
docker pull docker.xuanyuan.run/linuxserver/htpcmanager:latest

停止运行中的容器:

bash
docker stop htpcmanager

删除容器:

bash
docker rm htpcmanager

使用相同参数重建容器(若卷映射正确,/config文件夹及设置将保留)

清理旧镜像:

bash
docker image prune

通过Watchtower自动更新(仅在忘记原始参数时使用)

bash
docker run --rm \
  -v /var/run/docker.sock:/var/run/docker.sock \
  docker.xuanyuan.run/containrrr/watchtower \
  --run-once htpcmanager

警告:不建议将Watchtower用作现有Docker容器的自动更新解决方案。长期来看,推荐使用https://docs.linuxserver.io/general/docker-compose。

镜像更新通知 - Diun(Docker Image Update Notifier)

提示:推荐使用https://crazymax.dev/diun/获取更新通知。不推荐或支持其他自动更新容器的工具。

本地构建

如需本地修改镜像进行开发或自定义:

bash
git clone https://github.com/linuxserver/docker-htpcmanager.git
cd docker-htpcmanager
docker build \
  --no-cache \
  --pull \
  -t lscr.io/linuxserver/htpcmanager:latest .

可使用multiarch/qemu-user-static在x86_64硬件上构建ARM变体:

bash
docker run --rm --privileged docker.xuanyuan.run/multiarch/qemu-user-static:register --reset

注册后,使用-f Dockerfile.aarch64指定ARM64构建文件。

版本历史

  • 25.08.23: 基于Alpine 3.18重建
  • 04.07.23: 弃用armhf架构(详见https://www.linuxserver.io/blog/a-farewell-to-arm-hf)
  • 13.02.23: 基于Alpine 3.17重建,迁移至s6v3
  • 24.08.22: 基于Alpine 3.15重建,使用linuxserver.io wheel仓库
  • 08.04.21: 修复构建问题
  • 10.02.21: 基于Alpine 3.13重建
  • 26.10.20: 基于Alpine 3.12重建,使用python3,变更上游项目
  • 19.12.19: 基于Alpine 3.11重建
  • 28.06.19: 基于Alpine 3.10重建
  • 23.03.19: 切换至新基础镜像,迁移至arm32v7标签
  • 22.02.19: 基于Alpine 3.9重建
  • 16.01.19: 添加流水线逻辑和多架构支持
  • 17.08.18: 基于Alpine 3.8重建
  • 12.12.17: 基于Alpine 3.7重建
  • 20.07.17: 内部git拉取替代运行时拉取
  • 25.05.17: 基于Alpine 3.6重建
  • 07.02.17: 基于Alpine 3.5重建
  • 14.10.16: 添加版本层信息
  • 26.09.16: 从基础镜像移除后重新添加cherrypy
  • 10.09.16: 向README添加层徽章
  • 28.08.16: 向README添加徽章
  • 08.08.16: 基于Alpine Linux重建
  • 14.01.15: 从运行命令中移除硬编码日志级别,通过WebUI设置
  • 19.09.15: 初始发布

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

轩辕镜像加速拉取命令点我查看更多 htpcmanager 镜像标签

docker pull docker.xuanyuan.run/lsiodev/htpcmanager:<标签>

DockerHub 原生拉取命令

docker pull lsiodev/htpcmanager:<标签>
专业版 · 高速稳定拉取镜像
50GB 仅 ¥8/年
高速镜像下载在线技术支持专业版保障服务可用付费会员免广告