# docker加速脚本

**Repository Path**: qs0010/docker-acceleration-script

## Basic Information

- **Project Name**: docker加速脚本
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-29
- **Last Updated**: 2026-03-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Docker加速使用说明

## 简介

本脚本实现了Docker镜像拉取的加速功能，通过gh.sixyin.com加速网站拉取镜像，同时保持官方镜像名称。

## 功能特点

- 自动使用gh.sixyin.com加速域名拉取Docker镜像
- 支持多种镜像仓库：Docker官方、ghcr.io、quay.io、Kubernetes等
- 拉取成功后自动将镜像tag为官方名称
- 保持与标准Docker命令的兼容性

## 使用方法

### 一键安装命令

```bash
bash -c "mkdir -p /etc/docker && curl -o /etc/docker/docker_pull_wrapper.sh https://gitee.com/qs0010/docker-acceleration-script/raw/master/docker_pull_wrapper.sh && chmod +x /etc/docker/docker_pull_wrapper.sh && echo -e '\nalias docker=/etc/docker/docker_pull_wrapper.sh' >> ~/.bashrc" && source ~/.bashrc
```

### 临时使用

在每次使用前执行以下命令：

```bash
alias docker='/etc/docker/docker_pull_wrapper.sh'
```

### 永久使用

将以下内容添加到你的shell配置文件（如~/.bashrc或~/.zshrc）：

```bash
alias docker='/etc/docker/docker_pull_wrapper.sh'
```

然后执行：

```bash
source ~/.bashrc  # 或 source ~/.zshrc
```

## 示例

### 拉取Docker官方镜像

```bash
docker pull nginx
# 实际执行: docker pull gh.sixyin.com/nginx
# 然后自动tag为: nginx
```

### 拉取用户镜像

```bash
docker pull user/image
# 实际执行: docker pull gh.sixyin.com/user/image
# 然后自动tag为: user/image
```

### 拉取ghcr.io镜像

```bash
docker pull ghcr.io/user/image
# 实际执行: docker pull gh.sixyin.com/ghcr.io/user/image
# 然后自动tag为: ghcr.io/user/image
```

### 拉取Quay.io镜像

```bash
docker pull quay.io/org/image
# 实际执行: docker pull gh.sixyin.com/quay.io/org/image
# 然后自动tag为: quay.io/org/image
```

### 拉取Kubernetes镜像

```bash
docker pull registry.k8s.io/pause:3.8
# 实际执行: docker pull gh.sixyin.com/registry.k8s.io/pause:3.8
# 然后自动tag为: registry.k8s.io/pause:3.8
```

## 注意事项

1. 脚本会自动检测是否已经使用了加速域名，避免重复添加
2. 脚本只对`docker pull`命令进行处理，其他Docker命令会直接传递给原始docker命令
3. 拉取失败时会显示错误信息并退出
4. 脚本需要执行权限，已通过`chmod +x`设置

## 故障排除

如果遇到拉取失败的情况，请检查：

1. 网络连接是否正常
2. 镜像名称是否正确
3. gh.sixyin.com加速网站是否可访问

## 查看脚本内容

```bash
cat /etc/docker/docker_pull_wrapper.sh
```