heimdall

linuxserver/heimdall Docker 镜像

linuxserver/heimdall 是一款轻量高效的Docker应用仪表板镜像,专为集中管理各类Web服务、应用和工具设计。支持自定义布局、分类整理与图标显示,可将常用服务(如NAS管理、智能家居平台、媒体服务器等)整合为直观入口,实现一键快速访问。采用响应式界面,适配电脑、平板及手机设备,操作简单且资源占用低,是个人服务器、家庭实验室或多服务环境下优化访问体验的理想工具。

1.2千 次收藏下载次数: 0状态:社区镜像维护者:LinuxServer.io 社区镜像仓库类型:镜像最近更新:
下载命令
点击查看

LinuxServer.io 容器介绍:Heimdall

LinuxServer.io 团队简介

[LinuxServer.io] 团队专注于提供高质量 Docker 容器,其容器具有以下特点:

  • 定期、及时的应用更新
  • 便捷的用户权限映射(通过 PGID、PUID)
  • 基于 s6 overlay 的自定义基础镜像
  • 每周基础系统更新,通过跨生态通用层减少存储空间占用、 downtime 及带宽消耗
  • 定期安全更新

社区与支持渠道

  • [博客] :容器使用指南、教程及技术观点
  • :实时社区交流与团队支持
  • [Discourse] :社区论坛
  • [GitHub] :所有代码仓库源码
  • [Open Collective] :支持我们的***或预算贡献平台

linuxserver/heimdall 容器

[ ] [ ] [ ]

[Heimdall] 是一款轻量工具,用于集中管理常用网站和 Web 应用链接。其核心设计理念是简洁,可作为浏览器起始页,还支持集成 Google、Bing 或 DuckDuckGo 搜索栏。

支持的架构

容器通过 Docker manifest 实现多平台支持,拉取 lscr.io/linuxserver/heimdall:latest 即可自动匹配对应架构,也可通过标签指定:

架构支持状态标签格式
x86-64✅amd64-<version tag>
arm64✅arm64v8-<version tag>

版本标签

容器提供以下标签,请注意开发版可能不稳定:

标签支持状态说明
latest✅Heimdall 稳定版发行版
development✅GitHub 2.x 分支的最新提交版本

应用配置

基础访问

通过 `[] 访问 Web 界面。

启用密码保护

容器支持通过 htpasswd 实现密码保护,步骤如下:

  1. 在主机执行命令生成 htpasswd 文件(替换 <username> 为自定义用户名,按提示输入密码):
    CODE_TOKEN_0
  2. 编辑 /config/nginx/site-confs/default.conf,取消 basic auth 相关行的注释。
  3. 重启容器使配置生效。

使用方法

可通过 docker-compose(推荐)或 docker cli 启动容器。

[!NOTE]
除非标记为“可选”,否则所有参数均为必填项。

docker-compose

CODE_TOKEN_1

docker cli

CODE_TOKEN_2

参数说明

参数作用说明
-p 80:80HTTP 访问端口映射
-p 443:443HTTPS 访问端口映射
-e PUID=1000用户ID,用于解决权限问题(通过 id your_user 命令获取)
-e PGID=1000组ID,同上
-e TZ=Etc/UTC时区,参考 时区列表
-e ALLOW_INTERNAL_REQUESTS=false是否允许访问内网IP(未暴露公网或已认证的实例可设为 true)
-v /config配置文件持久化目录

环境变量文件(Docker Secrets)

支持通过文件传递环境变量,格式为 FILE__变量名=文件路径,例如:
CODE_TOKEN_3
变量值将从 /run/secrets/mysecretvariable 文件读取。

Umask 权限设置

可通过 -e UMASK=022 覆盖默认 umask(权限掩码),请注意 umask 是权限减法而非加法,详情参考 umask 说明。

用户/组ID(PUID/PGID)

挂载卷时,主机与容器可能出现权限冲突。通过指定 PUID/PGID(与主机用户一致)可避免该问题。使用 id your_user 命令获取当前用户的 UID/GID:
CODE_TOKEN_4

Docker Mods

可通过 [Docker Mods] 扩展容器功能,支持 Heimdall 专用 Mod 和通用 Mod。

支持信息

容器操作

  • 进入容器命令行:
    CODE_TOKEN_5
  • 实时查看日志:
    CODE_TOKEN_6

版本查询

  • 容器版本:
    CODE_TOKEN_7
  • 镜像版本:
    CODE_TOKEN_8

更新方法

容器需通过更新镜像并重建来升级应用,以下是具体步骤:

通过 docker-compose

  • 更新镜像:
    CODE_TOKEN_9
  • 重启容器:
    CODE_TOKEN_10
  • 清理旧镜像:
    CODE_TOKEN_11

通过 docker run

  • 更新镜像:
    CODE_TOKEN_12
  • 停止并删除旧容器:
    CODE_TOKEN_13
  • 用原参数重建容器(配置文件在 /config 中,会自动保留)
  • 清理旧镜像:
    CODE_TOKEN_14

镜像更新通知

推荐使用 [Diun] 监控镜像更新,不建议使用自动更新工具。

本地构建

如需修改镜像源码:
CODE_TOKEN_15
跨架构构建(如 x86_64 构建 ARM)需先注册 QEMU:
CODE_TOKEN_16
然后使用对应架构的 Dockerfile(如 -f Dockerfile.aarch64)。

版本历史

  • 2025.07.20:基于 Alpine 3.22 重构,支持 PHP 环境变量传递。
  • 2024.06.27:基于 Alpine 3.20 重构,旧用户需更新 nginx 配置以避免 http2 警告。
  • 2024.03.07:启用 opcache 并禁用文件重新验证。
  • 2023.12.23:基于 Alpine 3.19 重构,使用 PHP 8.3。
  • 2023.05.25:基于 Alpine 3.18 重构,移除 armhf 支持。
  • 2022.11.14:基于 Alpine 3.15 重构,使用 PHP 8,调整 nginx 配置结构。
  • 2018.02.12:初始版本发布。

镜像拉取方式

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

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

docker pull docker.xuanyuan.run/linuxserver/heimdall:<标签>

DockerHub 原生拉取命令

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