如何等待外部Docker服务健康后再启动另一个容器？（Pi-Hole&Homepage场景）

下面提供几种可行的方法，解决跨独立Docker Compose文件的服务依赖启动问题：

方法1：在Homepage启动命令中添加健康检查等待逻辑 #

直接在Homepage的docker-compose.yml中修改启动命令，让它先循环检查Pi-Hole的健康状态，确认正常后再启动服务。

1. 确保Pi-Hole容器和Homepage容器处于同一Docker网络（如果没有，先创建自定义网络：docker network create pihole-homepage，然后在两个docker-compose.yml中都添加networks: default: external: name: pihole-homepage）。
2. 修改Homepage的docker-compose.yml的服务配置：

services:
  homepage:
    image: ghcr.io/gethomepage/homepage:latest
    # 替换成你的其他配置（端口、卷挂载等）
    ports:
      - "3000:3000"
    volumes:
      - ./homepage-config:/app/config
    # 等待Pi-Hole健康状态为正常后启动Homepage
    command: sh -c "until curl -s http://pihole/admin/api.php?status | grep -q 'enabled'; do echo '等待Pi-Hole就绪...'; sleep 5; done; exec npm start"
    restart: unless-stopped

注：如果Pi-Hole的健康检查端点不同，可替换成检查容器健康状态的命令：until docker inspect --format="{{.State.Health.Status}}" pihole | grep -q "healthy"; do sleep 5; done，但这种方式需要Homepage容器能访问Docker主机的Docker API（需挂载/var/run/docker.sock:/var/run/docker.sock）。

方法2：合并为同一个Docker Compose文件 #

如果没有必须分开的理由，将两个服务合并到同一个docker-compose.yml，利用depends_on的健康检查条件：

services:
  pihole:
    image: pihole/pihole:latest
    # Pi-Hole的基础配置
    ports:
      - "53:53/tcp"
      - "53:53/udp"
      - "80:80/tcp"
    volumes:
      - ./pihole-data:/etc/pihole
      - ./pihole-dnsmasq:/etc/dnsmasq.d
    environment:
      - TZ=Asia/Shanghai
      - WEBPASSWORD=your-password
    # 配置Pi-Hole的健康检查
    healthcheck:
      test: ["CMD", "curl", "-s", "http://localhost/admin/api.php?status"]
      interval: 10s
      timeout: 5s
      retries: 5
    restart: unless-stopped

  homepage:
    image: ghcr.io/gethomepage/homepage:latest
    ports:
      - "3000:3000"
    volumes:
      - ./homepage-config:/app/config
    # 依赖Pi-Hole且必须等待其健康状态为正常才启动
    depends_on:
      pihole:
        condition: service_healthy
    restart: unless-stopped

方法3：用Systemd服务管理容器启动顺序 #

通过Systemd服务定义启动依赖，确保Pi-Hole容器健康后再启动Homepage：

1. 创建Pi-Hole的Systemd服务文件（/etc/systemd/system/pihole.service）：

[Unit]
Description=Pi-Hole Docker Container
Requires=docker.service
After=docker.service

[Service]
Restart=always
WorkingDirectory=/path/to/pihole-compose-folder
ExecStart=/usr/bin/docker-compose up
ExecStop=/usr/bin/docker-compose down

[Install]
WantedBy=multi-user.target

2. 创建Homepage的Systemd服务文件（/etc/systemd/system/homepage.service）：

[Unit]
Description=Homepage Docker Container
Requires=pihole.service
After=pihole.service

[Service]
Restart=always
WorkingDirectory=/path/to/homepage-compose-folder
# 等待Pi-Hole健康状态为healthy
ExecStartPre=/bin/sh -c 'until docker inspect --format="{{.State.Health.Status}}" pihole | grep -q "healthy"; do sleep 5; done'
ExecStart=/usr/bin/docker-compose up
ExecStop=/usr/bin/docker-compose down

[Install]
WantedBy=multi-user.target

3. 启用并启动服务：

systemctl daemon-reload
systemctl enable pihole.service homepage.service
systemctl start pihole.service homepage.service

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