linuxserver/heimdall

LinuxServer.io 容器介绍：Heimdall

LinuxServer.io 团队简介

LinuxServer.io 团队专注于提供高质量 Docker 容器，其容器具有以下特点：

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

社区与支持渠道

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

linuxserver/heimdall 容器

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

!heimdall

支持的架构

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

版本标签

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

应用配置

基础访问

通过 `[***] 访问 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

参数说明

环境变量文件（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：初始版本发布。