Docker部署Pi-hole遇linux/mipsle架构不兼容问题求助

错误背景与原因 #

官方Pi-hole Docker镜像不支持MIPS（mipsle）架构，执行启动命令时触发报错：no matching manifest for linux/mipsle in the manifest list entries。已有社区用户分享了MIPS适配的Pi-hole方案，需修改docker-compose.yml调用该非官方适配代码。

现有操作与配置 #

1. 当前docker-compose.yml配置 #

version: "3.3"

# More info at https://github.com/pi-hole/docker-pi-hole/ and https://docs.pi-hole.net/
services:
  pihole:
    container_name: pihole
    image: pihole/pihole:2021.09
    hostname: pihole
    environment:
      TZ: SE
      # WEBPASSWORD: 'set a secure password here or it will be random'
    # Volumes store your data between container upgrades
    volumes:
      - './pihole/etc-pihole/:/etc/pihole/'
      - './pihole/etc-dnsmasq.d/:/etc/dnsmasq.d/'
      - './pihole/var-log/:/var/log'
      - './pihole/etc-cont-init.d/10-fixroutes.sh:/etc/cont-init.d/10-fixroutes.sh'
    # Recommended but not required (DHCP needs NET_ADMIN)
    #   https://github.com/pi-hole/docker-pi-hole#note-on-capabilities
    cap_add:
      - NET_ADMIN
    restart: unless-stopped
    networks:
      internal:
      lan:
        ipv4_address: 192.168.1.3

networks:
  internal:
  lan:
    name: lan
    driver: macvlan
    driver_opts:
      parent: br-lan.20
    ipam:
      config:
        - subnet: 192.168.1.0/24

2. 创建卷目录命令 #

mkdir -p ./pihole/etc-pihole/
mkdir -p ./pihole/etc-dnsmasq.d/
mkdir -p ./pihole/var-log/
mkdir -p ./pihole/var-log/lighttpd
chown 33:33 ./pihole/var-log/lighttpd
mkdir -p ./pihole/etc-cont-init.d/

3. 设置路由命令 #

echo '#!/usr/bin/with-contenv bash
set -e

echo "fixing routes"
ip route del default
ip route add default via 172.18.0.1
echo "done fixing routes"' >> ./pihole/etc-cont-init.d/10-fixroutes.sh
chmod 755 ./pihole/etc-cont-init.d/10-fixroutes.sh

4. 启动容器命令 #

cd ~
docker-compose up -d pihole

解决方案指导 #

修改docker-compose.yml适配MIPS架构 #

1. 替换镜像源：将配置中的image: pihole/pihole:2021.09替换为社区适配的MIPS镜像。如果社区提供了公开镜像，直接填写对应的镜像名称（格式为用户名/镜像名:标签）；若需自行构建，参考社区方案的Dockerfile在本地构建镜像后，将image字段设为你构建的镜像名。
2. 验证架构兼容性：通过docker inspect <镜像名>命令确认镜像支持linux/mipsle架构。
3. 保留原有配置：卷挂载、环境变量、网络设置、权限配置等内容可完全保留，这些与架构无关，无需调整。

注意事项 #

• 非官方镜像可能存在维护滞后问题，使用前需确认是否匹配你需要的Pi-hole版本。
• 自行构建镜像时，需确保Docker环境支持MIPS架构交叉编译，或直接在MIPS设备上完成构建。

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