Heimdall (GitHub: linuxserver/Heimdall)
特点： 一款设计优雅的“应用启动板”，侧重于提供一个视觉友好的界面来管理和访问你的 Web 应用和链接。它的配置和管理相对简单，通过 Web UI 进行。
优点： 界面非常美观，易于使用，图标丰富，适合快速添加和分类网站。
# Heimdall 部署指南
## 前提条件
- **已安装 1Panel**：确保你的服务器上已经安装并运行了 1Panel 面板。
- **已开放端口**：确保服务器防火墙和云服务商的安全组开放了你计划用来访问 Heimdall 的端口（通常是 80 和 443 用于反向代理，或者你直接映射 Heimdall 的端口）。
## 步骤 1：登录 1Panel 后台
在浏览器中输入你的 1Panel 地址和端口（例如 `http://your_server_ip:8080`），然后登录。
## 步骤 2：创建 Docker Compose 编排文件
1. 在 1Panel 左侧菜单中，导航到 **容器 -> 编排**。
2. 点击右上角的 **创建编排** 按钮。
3. 填写编排信息：
- **编排名称**：`heimdall`（或你喜欢的任何名称）
- **项目目录**：建议设置为 `/opt/1panel/apps/heimdall`（或你希望存储 Heimdall 配置文件的路径，1Panel 会自动创建）
- **粘贴编排文件**：
```yaml
version: "3"
services:
heimdall:
image: lscr.io/linuxserver/heimdall:latest # 使用 linuxserver 的官方镜像
container_name: heimdall
environment:
PUID: 1000 # 你的用户ID，通常为 1000
PGID: 1000 # 你的组ID，通常为 1000
TZ: Asia/Shanghai # 设置时区，例如 Asia/Shanghai 或 Asia/Phnom_Penh (根据你服务器所在位置调整)
volumes:
- /opt/1panel/apps/heimdall/config:/config # 将容器内的 /config 映射到宿主机的持久化目录
ports:
- 8000:80 # 宿主机端口:容器内端口。这里将 Heimdall 的 HTTP 80 端口映射到宿主机的 8000 端口
- 8001:443 # 宿主机端口:容器内端口。这里将 Heimdall 的 HTTPS 443 端口映射到宿主机的 8001 端口
restart: unless-stopped
重要说明：
PUID 和 PGID：这是 Linux 用户和组的 ID，用于 Heimdall 容器读写挂载卷的权限。在大多数 Linux 系统上，默认用户的 PUID/PGID 都是 1000。你可以通过在服务器上运行 id -u your_username 和 id -g your_username 来确认。
TZ：务必修改为你的正确时区。例如 Asia/Shanghai (中国上海) 或 Asia/Phnom_Penh (金边)。
volumes：/opt/1panel/apps/heimdall/config 是推荐的持久化数据路径，确保你替换为你希望存储 Heimdall 配置的实际路径。这个路径必须是宿主机上的一个目录。1Panel 通常会为你创建你填写的项目目录，然后你在这个目录下创建 config 子目录。
ports：8000:80 和 8001:443 表示将 Heimdall 容器内部的 80 和 443 端口分别映射到宿主机的 8000 和 8001 端口。你可以根据自己的需求修改宿主机端口（例如，如果你有反向代理，并且不想直接暴露这些端口，可以只映射一个高位端口，然后让反向代理去连接）。
点击 确认 创建编排。
步骤 3：启动编排
- 创建编排后，你会回到编排列表页面。
- 找到你刚刚创建的
heimdall 编排，点击右侧的 启动 按钮。
- 1Panel 会自动拉取 Heimdall 镜像并启动容器。这个过程可能需要一些时间，具体取决于你的网络速度。
步骤 4：访问 Heimdall 界面
一旦编排启动成功，你可以在浏览器中访问 Heimdall：
- 如果按照上面的配置，你可以通过
http://your_server_ip:8000 访问 HTTP 界面。
- 如果你配置了 HTTPS 映射，可以通过
https://your_server_ip:8001 访问 HTTPS 界面。
首次访问时，Heimdall 会让你创建一个管理员账户。
步骤 5：配置反向代理 (可选但推荐)
直接使用 IP 地址和端口访问不方便也不安全（没有 HTTPS）。强烈建议通过 1Panel 的反向代理功能为 Heimdall 配置一个域名和 HTTPS。
- 准备域名：确保你有一个域名（例如
heimdall.yourdomain.com），并且这个域名已经正确地解析到了你的服务器的公网 IP 地址。
- 创建网站：
- 在 1Panel 左侧菜单中，导航到 网站。
- 点击右上角的 创建网站。
- 填写网站信息：
- 站点名称：
heimdall（或你喜欢的名称）
- 域名：
heimdall.yourdomain.com（替换为你的实际域名）
- 运行环境：选择 反向代理。
- 代理地址：输入
http://localhost:8000（这里 localhost 指的是 1Panel 所在的宿主机，8000 是你 Heimdall 映射到宿主机的 HTTP 端口）。
- SSL证书：强烈建议选择 Let's Encrypt 自动申请并安装免费 SSL 证书。
- 防火墙策略：确保已勾选允许 HTTP 和 HTTPS 访问（如果选择 SSL 证书）。
- 点击 确认。
1Panel 会自动配置 Nginx 反向代理并申请 SSL 证书。完成后，你就可以通过 https://heimdall.yourdomain.com 访问你的 Heimdall 仪表盘了！
维护与更新
通过以上步骤，你就能在 1Panel 后台轻松地编排和部署 Heimdall 了。
