LinuxServer.io提供的HTPCManager容器,用于管理家庭影院电脑(HTPC)的媒体内容及相关功能。
linuxserver/htpcmanager
镜像概述和主要用途
https://github.com/HTPC-Manager/HTPC-Manager 是一个用于多种HTPC相关应用的前端管理界面,由LinuxServer.io团队提供容器化支持。该容器化解决方案提供了便捷的部署方式和丰富的功能特性,适合家庭影院个人电脑(HTPC)用户集中管理各类媒体应用。
LinuxServer.io团队的容器发布特点包括:
- 定期及时的应用更新
- 简单的用户映射(PGID, PUID)
- 带有s6覆盖的自定义基础镜像
- 每周基础操作系统更新,在整个LinuxServer.io生态系统中共享通用层,以最小化空间使用、停机时间和带宽消耗
- 定期安全更新
核心功能和特性
- 集中化管理界面:为各类HTPC应用提供统一的前端访问入口
- 多架构支持:兼容x86-64和arm64架构
- 用户权限控制:通过PUID和PGID实现容器内用户与宿主机用户的权限映射
- 时区配置:支持自定义时区设置
- 持久化存储:配置文件可通过卷挂载实现持久化
- 安全可靠:定期更新和安全补丁,确保应用安全性
支持的架构
该镜像利用Docker manifest实现多平台支持。只需拉取lscr.io/linuxserver/htpcmanager:latest即可获取适合您架构的正确镜像,也可通过标签拉取特定架构的镜像。
支持的架构:
| 架构 | 可用 | 标签 |
|---|---|---|
| x86-64 | ✅ | amd64-<version tag> |
| arm64 | ✅ | arm64v8-<version tag> |
使用场景和适用范围
- 家庭影院PC系统的集中化管理
- 媒体服务器的Web界面统一入口
- 多HTPC应用的整合与简化操作
- 家庭媒体中心的便捷管理解决方案
应用设置
Web界面位于8085端口。镜像未包含Smartmontools和psutil,可安全忽略日志中的相关警告错误。
使用方法和配置说明
Docker Compose (推荐)
yaml--- services: htpcmanager: image: docker.xuanyuan.run/linuxserver/htpcmanager:latest container_name: htpcmanager environment: - PUID=1000 - PGID=1000 - TZ=Etc/UTC volumes: - /path/to/htpcmanager/config:/config ports: - 8085:8085 restart: unless-stopped
Docker CLI
bashdocker run -d \ --name=htpcmanager \ -e PUID=1000 \ -e PGID=1000 \ -e TZ=Etc/UTC \ -p 8085:8085 \ -v /path/to/htpcmanager/config:/config \ --restart unless-stopped \ docker.xuanyuan.run/linuxserver/htpcmanager:latest
参数说明
容器通过运行时参数进行配置,格式为<外部>:<内部>。
| 参数 | 功能 |
|---|---|
-p 8085:8085 | 应用Web界面端口映射 |
-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设置
所有LinuxServer.io镜像都提供了通过可选的-e UMASK=022设置来覆盖容器内服务的默认umask的能力。请注意,umask不是chmod,它基于其值减去权限而非添加权限。
用户/组标识符
使用卷(-v标志)时,宿主机OS和容器之间可能出现权限问题。通过指定用户PUID和组PGID可以避免此问题。
确保宿主机上的任何卷目录都由您指定的相同用户拥有,权限问题将迎刃而解。
此处PUID=1000和PGID=1000,可使用id your_user命令查找您的用户ID和组ID:
bashid your_user
示例输出:
textuid=1000(your_user) gid=1000(your_user) groups=1000(your_user)
Docker Mods
我们发布了各种https://github.com/linuxserver/docker-mods以启用容器内的附加功能。可通过上方动态徽章访问此镜像可用的Mods列表以及可应用于任何LinuxServer.io镜像的通用Mods。
支持信息
-
容器运行时的Shell访问:
bashdocker exec -it htpcmanager /bin/bash -
实时监控容器日志:
bashdocker logs -f htpcmanager -
容器版本号:
bashdocker inspect -f '{{ index .Config.Labels "build_version" }}' htpcmanager -
镜像版本号:
bashdocker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/htpcmanager:latest
更新信息
大多数LinuxServer.io镜像是静态的、版本化的,需要更新镜像并重新创建容器来更新内部应用。除了相关readme.md中特别说明的情况外,不建议或支持在容器内更新应用。
通过Docker Compose更新
-
更新镜像:
-
所有镜像:
bashdocker-compose pull -
单个镜像:
bashdocker-compose pull htpcmanager
-
-
更新容器:
-
所有容器:
bashdocker-compose up -d -
单个容器:
bashdocker-compose up -d htpcmanager
-
-
移除旧的悬空镜像:
bashdocker image prune
通过Docker Run更新
-
更新镜像:
bashdocker pull docker.xuanyuan.run/linuxserver/htpcmanager:latest -
停止运行中的容器:
bashdocker stop htpcmanager -
删除容器:
bashdocker rm htpcmanager -
使用上述相同的docker run参数重新创建新容器(如果正确映射到主机文件夹,
/config文件夹和设置将被保留) -
移除旧的悬空镜像:
bashdocker image prune
镜像更新通知 - Diun (Docker Image Update Notifier)
我们推荐使用https://crazymax.dev/diun/进行更新通知。不推荐或支持使用其他自动更新容器的工具。
本地构建
如需为开发目的或自定义逻辑对这些镜像进行本地修改:
bashgit clone https://github.com/linuxserver/docker-htpcmanager.git cd docker-htpcmanager docker build \ --no-cache \ --pull \ -t lscr.io/linuxserver/htpcmanager:latest .
可使用lscr.io/linuxserver/qemu-static在x86_64硬件上构建ARM变体,反之亦然:
bashdocker run --rm --privileged docker.xuanyuan.run/linuxserver/qemu-static --reset
注册后,可使用-f Dockerfile.aarch64指定要使用的dockerfile。
版本历史
- 27.06.24: - 基于Alpine 3.20重建
- 08.01.24: - 基于Alpine 3.19重建
- 25.08.23: - 基于Alpine 3.18重建
- 04.07.23: - 弃用armhf架构
- 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 镜像标签
DockerHub 原生拉取命令
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务