linuxserver/heimdall
linuxserver/heimdall 是一款轻量高效的Docker应用仪表板镜像，专为集中管理各类Web服务、应用和工具设计。支持自定义布局、分类整理与图标显示，可将常用服务（如NAS管理、智能家居平台、媒体服务器等）整合为直观入口，实现一键快速访问。采用响应式界面，适配电脑、平板及手机设备，操作简单且资源占用低，是个人服务器、家庭实验室或多服务环境下优化访问体验的理想工具。
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
LinuxServer.io 容器介绍：Heimdall
LinuxServer.io 团队简介
[LinuxServer.io] 团队专注于提供高质量 Docker 容器，其容器具有以下特点：
- 定期、及时的应用更新
- 便捷的用户权限映射（通过 PGID、PUID）
- 基于 s6 overlay 的自定义基础镜像
- 每周基础系统更新，通过跨生态通用层减少存储空间占用、 downtime 及带宽消耗
- 定期安全更新
社区与支持渠道
- [博客] ：容器使用指南、教程及技术观点
- ：实时社区交流与团队支持
- [Discourse] ：社区论坛
- [GitHub] ：所有代码仓库源码
- [Open Collective] ：支持我们的***或预算贡献平台
linuxserver/heimdall 容器
[![Scarf.io pulls] ] [![GitHub Stars] ] [![Docker Pulls] ]
[Heimdall] 是一款轻量工具，用于集中管理常用网站和 Web 应用链接。其核心设计理念是简洁，可作为浏览器起始页，还支持集成 Google、Bing 或 DuckDuckGo 搜索栏。
![heimdall]
支持的架构
容器通过 Docker manifest 实现多平台支持，拉取 lscr.io/linuxserver/heimdall:latest 即可自动匹配对应架构，也可通过标签指定：
| 架构 | 支持状态 | 标签格式 |
|---|---|---|
| x86-64 | ✅ | amd64-<version tag> |
| arm64 | ✅ | arm64v8-<version tag> |
版本标签
容器提供以下标签，请注意开发版可能不稳定：
| 标签 | 支持状态 | 说明 |
|---|---|---|
| latest | ✅ | Heimdall 稳定版发行版 |
| development | ✅ | GitHub 2.x 分支的最新提交版本 |
应用配置
基础访问
通过 `[] 访问 Web 界面。
启用密码保护
容器支持通过 htpasswd 实现密码保护，步骤如下：
- 在主机执行命令生成 htpasswd 文件（替换
<username>为自定义用户名，按提示输入密码）：
CODE_TOKEN_0 - 编辑
/config/nginx/site-confs/default.conf，取消basic auth相关行的注释。 - 重启容器使配置生效。
使用方法
可通过 docker-compose（推荐）或 docker cli 启动容器。
[!NOTE]
除非标记为“可选”，否则所有参数均为必填项。
docker-compose
CODE_TOKEN_1
docker cli
CODE_TOKEN_2
参数说明
| 参数 | 作用说明 |
|---|---|
-p 80:80 | HTTP 访问端口映射 |
-p 443:443 | HTTPS 访问端口映射 |
-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:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"