Docker Compose 文件编写示例与国内镜像拉取失败的排查

1. Docker Compose 简介

Docker Compose 是 Docker 提供的一个工具，用于定义和运行多容器应用。它通过 docker-compose.yml 文件定义应用的服务、网络和存储。

2. Docker Compose 文件编写示例

2.1 基础示例

以下是一个简单的 docker-compose.yml 文件，定义了一个 Nginx 容器：

version: '3.8'

services:
  web:
    image: nginx:latest
    ports:
      - "8080:80"
    volumes:
      - ./html:/usr/share/nginx/html
    restart: always

2.2 多服务示例

如果你的应用包含多个容器，比如一个 Web 服务器和一个数据库服务器，可以这样编写：

version: '3.8'

services:
  web:
    image: nginx:latest
    ports:
      - "8080:80"
    depends_on:
      - db

  db:
    image: mysql:5.7
    environment:
      MYSQL_ROOT_PASSWORD: root
      MYSQL_DATABASE: testdb
      MYSQL_USER: user
      MYSQL_PASSWORD: password
    volumes:
      - db_data:/var/lib/mysql
    restart: always

volumes:
  db_data:

3. 国内镜像拉取失败的排查

3.1 确保 Docker 镜像加速器已配置

由于 Docker 官方镜像仓库在国内访问较慢，建议配置国内加速器，例如：

{
  "registry-mirrors": [
    "https://registry.cn-hangzhou.aliyuncs.com",
    "https://hub-mirror.c.163.com"
  ]
}

配置完成后，重启 Docker Desktop，使其生效。

3.2 检查网络连接

如果仍然拉取失败，可以尝试手动拉取镜像：

docker pull nginx:latest

如果拉取失败，可尝试 ping 镜像源，确认网络是否可达：

ping registry.cn-hangzhou.aliyuncs.com

若 ping 失败，可能是 DNS 解析问题，可以修改 DNS 为 8.8.8.8 或 114.114.114.114。

3.3 使用 --network=host 选项

有些网络环境可能导致 Docker 无法访问外部网络，可以尝试使用 --network=host 模式：

docker run --rm --network=host nginx:latest

3.4 代理问题

如果在公司或校园网络环境下，可能需要配置 HTTP 代理。可以在 ~/.docker/config.json 添加：

{
  "proxies": {
    "default": {
      "httpProxy": "http://proxy.example.com:8080",
      "httpsProxy": "http://proxy.example.com:8080",
      "noProxy": "localhost,127.0.0.1"
    }
  }
}

4. 总结

1. Docker Compose 文件用于定义多容器应用，可通过 docker-compose.yml 进行配置。

2. 拉取镜像失败时，建议先配置国内镜像加速器。

3. 如果仍有问题，检查网络连接、代理设置，或使用 --network=host 进行测试。

通过这些方法，可以更高效地使用 Docker Compose 来管理容器化应用。