Heimdall 仪表板的指南。Heimdall 是一个开源的自托管仪表板应用程序，旨在将所有你常用的 Web 服务链接聚合在一个地方，提供美观且可定制的界面

• 安装 Docker 引擎：参考官方文档 https://docs.docker.com/engine/install/
• 安装 Docker Compose：参考官方文档 https://docs.docker.com/compose/install/

创建项目目录：

mkdir -p ~/heimdall && cd ~/heimdall

创建 docker-compose.yml 文件： 使用文本编辑器（如 nano 或 vim）创建文件：

nano docker-compose.yml

将以下内容粘贴到文件中：

version: '3'
services:
heimdall:
image: lscr.io/linuxserver/heimdall:latest
container_name: heimdall
restart: unless-stopped
environment:
– PUID=1000 # 替换为你的用户ID (通常1000是第一个普通用户)
– PGID=1000 # 替换为你的组ID (通常1000是第一个普通用户的组)
– TZ=Asia/Shanghai # 替换为你的时区
volumes:
– ./config:/config # 将配置文件保存在当前目录下的config文件夹中
ports:
– 8080:80 # 将容器内部的80端口映射到宿主机的8080端口。你可以将8080改为其他可用端口，如80。

• 重要参数说明：
  • PUID/PGID：确保容器有正确的权限访问你的配置文件。通常 1000 是第一个普通用户的 ID。你可以使用命令 id <用户名> 来查看你的 UID 和 GID。
  • TZ：设置正确的时区。
  • volumes：./config:/config 将容器内的配置目录挂载到宿主机的当前目录下的 config 文件夹。这样即使容器重启或更新，你的配置（添加快捷方式、设置等）也不会丢失。
  • ports：8080:80 表示访问宿主机的 8080 端口就相当于访问容器内部的 80 端口。如果你想直接使用 80 端口（默认 HTTP 端口），请将其改为 80:80。 如果 80 端口已被占用（如 Nginx/Apache），请选择一个未被占用的端口，例如 8080:80 或 8888:80。

保存并退出编辑器： 在 nano 中按 Ctrl + O 保存，按 Enter 确认文件名，再按 Ctrl + X 退出。

启动 Heimdall 容器：

docker-compose up -d

这个命令会拉取 Heimdall 镜像（如果本地没有）并在后台运行容器。

通过 IP 地址和端口访问： 打开你的 Web 浏览器，访问服务器的 IP 地址和你配置的端口：

http://<你的服务器IP>:<端口号>

例如，如果你映射的是 8080 端口且服务器 IP 是 192.168.1.100，则访问 http://192.168.1.100:8080。

初始设置： 首次访问会看到一个欢迎界面和一些示例应用。你可以：

• 点击右上角的 + 号添加你自己的应用程序（服务）。
• 输入名称、图标（可搜索内置图标库或上传自定义图标）、URL（服务的访问地址）等。
• 点击右上角的齿轮图标进入设置，可以修改仪表板名称、密码保护（可选）、主题、语言等。

server {
listen 80;
server_name dashboard.yourdomain.com; # 替换为你的域名

location / {
proxy_pass http://localhost:8080; # 替换为你的Heimdall容器在宿主机映射的端口
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}

ln -s /etc/nginx/sites-available/heimdall.conf /etc/nginx/sites-enabled/
nginx -t # 测试配置语法

systemctl reload nginx