RPi4b搭配OMV6与Portainer时Heimdall无法正常运行求助

问题概述 #

树莓派4B运行64位Raspbian OS Lite，已部署OMV6 NAS并配置共享文件夹，通过omv-extras安装Docker与Portainer后，Portainer运行正常，但部署Heimdall等自托管服务时出现以下问题：

• 初始Compose文件拉取镜像失败，提示no matching manifest for linux/arm/v8 in the manifest list entries
• 添加platform: linux/arm64后容器显示“运行中”，但指定端口无法访问服务，容器概览无IP/端口信息

错误分析 #

1. 镜像拉取失败原因 #

树莓派4B的ARM64架构在拉取部分镜像时，Docker可能默认匹配linux/arm/v8而非linux/arm64/v8，添加platform: linux/arm64可明确指定架构，解决镜像拉取问题。

2. 容器运行但无法访问的核心问题 #

你的Compose文件存在挂载路径格式错误：原volumes配置仅指定了宿主机路径，未映射到容器内的目标路径，导致容器无法读取/写入配置文件，启动后无法正常提供服务。

修复步骤 #

步骤1：修正Docker Compose文件 #

补充完整的挂载路径映射，同时确保时区、权限参数正确：

---
version: "2.1"
services:
  heimdall:
    image: lscr.io/linuxserver/heimdall:latest
    container_name: heimdall
    platform: linux/arm64
    environment:
      - PUID=1001
      - PGID=100
      - TZ=Europe/Berlin
    volumes:
      - /srv/dev-disk-by-uuid-0ced8ae6-8f59-4918-8894-704b7b4363dc/docker-apps/docker/heimdall/config:/config
    ports:
      - 80:80
      - 443:443
    restart: unless-stopped

• 关键修正：宿主机路径:/config，/config是Heimdall容器默认的配置存储路径
• 保留platform: linux/arm64确保匹配ARM64架构镜像

步骤2：验证宿主机路径权限 #

确保宿主机的heimdall/config目录权限正确，让PUID=1001的用户拥有读写权限：

sudo chown -R 1001:100 /srv/dev-disk-by-uuid-0ced8ae6-8f59-4918-8894-704b7b4363dc/docker-apps/docker/heimdall/config

步骤3：重新部署容器 #

1. 在Portainer中删除现有Heimdall堆栈
2. 使用修正后的Compose文件重新部署
3. 查看容器日志确认无权限或路径错误

步骤4：通用排查方案（适用于其他自托管服务） #

如果其他服务也出现类似问题，按以下顺序排查：

• 检查Compose文件的volumes映射格式，必须是宿主机路径:容器内路径
• 确认镜像支持ARM64架构，必要时添加platform: linux/arm64
• 验证宿主机目录权限与容器的PUID/PGID匹配
• 查看容器日志定位具体启动错误（比如依赖缺失、配置文件读取失败等）

额外说明 #

容器概览中无IP/端口通常是容器未正常启动或网络配置异常，修正挂载路径后，容器正常启动会自动分配虚拟IP并映射端口，此时即可通过树莓派IP+80/443端口访问Heimdall。

内容的提问来源于stack exchange，提问作者unga bunga