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 仪表盘了！

维护与更新

更新 Heimdall：
1. 在 1Panel 的 容器 -> 编排 页面，找到 heimdall 编排。
2. 点击右侧的停止按钮。
3. 点击 更新镜像 按钮，1Panel 会拉取最新版本的 Heimdall 镜像。
4. 点击启动按钮。
备份数据：Heimdall 的所有数据都存储在 /opt/1panel/apps/heimdall/config（或你设置的卷路径）目录下。定期备份这个目录非常重要！你可以通过 1Panel 的文件管理功能进行备份。

通过以上步骤，你就能在 1Panel 后台轻松地编排和部署 Heimdall 了。