HTPC Manager 是一个为多种HTPC相关应用提供统一前端管理的工具,可通过Web界面集中管理媒体中心应用,支持用户权限映射和跨平台部署。
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
bashdocker 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:
bashid your_user
示例输出:
textuid=1000(your_user) gid=1000(your_user) groups=1000(your_user)
Docker Mods
LinuxServer.io提供多种https://github.com/linuxserver/docker-mods以扩展容器功能。上述徽章链接到该镜像专用及通用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
更新信息
大多数镜像为静态版本,需更新镜像并重建容器以更新应用。以下是更新容器的方法:
通过Docker Compose
更新镜像:
- 所有镜像:
bash
docker-compose pull - 单个镜像:
bash
docker-compose pull htpcmanager
更新容器:
- 所有容器:
bash
docker-compose up -d - 单个容器:
bash
docker-compose up -d htpcmanager
清理旧镜像:
bashdocker image prune
通过Docker Run
更新镜像:
bashdocker pull docker.xuanyuan.run/linuxserver/htpcmanager:latest
停止运行中的容器:
bashdocker stop htpcmanager
删除容器:
bashdocker rm htpcmanager
使用相同参数重建容器(若卷映射正确,/config文件夹及设置将保留)
清理旧镜像:
bashdocker image prune
通过Watchtower自动更新(仅在忘记原始参数时使用)
bashdocker 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/获取更新通知。不推荐或支持其他自动更新容器的工具。
本地构建
如需本地修改镜像进行开发或自定义:
bashgit 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变体:
bashdocker 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: 初始发布
lsiodev 命名空间的其他可用镜像:
lsiodev/radarr
lsiodev/webtop
lsiodev/jellyfin
lsiodev/ombi
lsiodev/emby
lsiodev/piper
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 htpcmanager 镜像标签
DockerHub 原生拉取命令
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务