Docker引擎配置和容器镜像加速

Docker引擎（提供 docker 命令（区分于 crictl））是一个非常好用的容器工具，可以用来做很多有趣的事情，包括快速测试和构建一致的开发测试环境。

但要想使用好它必须经过一些最基本的配置，可以通过创建并编辑 /etc/docker/daemon.json 文件进行配置。

下面是一个基本的配置。

{
    "live-restore": true,
    "log-driver": "json-file",
    "log-opts": {
        "max-size": "100m",
        "max-file": "3"
    },
    "registry-mirrors": ["https://docker.example.com/"]
}

释义：

log-driver 指定容器日志格式为json；

log-opts 里分别使用max-size和max-file指定了日志文件大小和数量；

registry-mirrors 指定了容器镜像的镜像地址；

这样的基本配置就足够了。

因为众所周知的原因，Docker官方的镜像仓库 hub.docker.com 无法访问并拉取镜像，因此我们需要通过网络代理来访问。

参考地址：https://docs.docker.com/config/daemon/proxy/

处理方法：

1. 打开并编辑文件 /etc/docker/daemon.json
2. 添加以下内容：

        "proxies": {
            "http-proxy": "socks5://10.8.1.7:3127",
            "https-proxy": "socks5://10.8.1.7:3127",
            "no-proxy": "127.0.0.0/8,ccr.ccs.tencentyun.com"
        }

除了通过编辑 /etc/docker/daemon.json 文件之外，可以通过创建 /etc/systemd/system/docker.service.d/http-proxy.conf 文件来实现类似的操作：

[Service]
Environment="HTTP_PROXY=socks5://10.8.1.7:3127"
Environment="HTTPS_PROXY=socks5://10.8.1.7:3127"
Environment="NO_PROXY=localhost,127.0.0.1,*.local"

使用镜像加速（代理服务），例如这个项目：https://github.com/DaoCloud/public-image-mirror/tree/main。

使用方法：

docker run -d -P m.daocloud.io/docker.io/library/nginx
# 或
docker run -d -P m.daocloud.io/library/nginx

添加到 /etc/docker/daemon.json

{
  "registry-mirrors": [
    "https://docker.m.daocloud.io"
  ]
}

# /etc/docker/daemon.json
cat >/etc/docker/daemon.json<<'eof'
{
    "live-restore": true,
        "log-driver": "json-file",
        "log-opts": {
            "max-size": "100m",
            "max-file": "3"
        },
        "proxies": {
            "http-proxy": "socks5://10.8.1.7:3127",
            "https-proxy": "socks5://10.8.1.7:3127",
            "no-proxy": "127.0.0.0/8,ccr.ccs.tencentyun.com"
        }
}
eof

--

另附一份南京大学的镜像加速，来源：https://doc.nju.edu.cn/books/e1654?shelf=1

开源镜像

mirror.nju.edu.cn

镜像

域名：

服务：

GCR

Google Container Registry

gcr.io

将 gcr.io 替换为 gcr.nju.edu.cn 即可。

如

docker pull gcr.io/cadvisor/cadvisor:v0.39.3

替换为

docker pull gcr.nju.edu.cn/cadvisor/cadvisor:v0.39.3

k8s.gcr.io

将 k8s.gcr.io 替换为 gcr.nju.edu.cn/google-containers 即可。

如

docker pull k8s.gcr.io/kube-proxy:v1.18.6

替换为

docker pull gcr.nju.edu.cn/google-containers/kube-proxy:v1.18.6

GHCR

Github Container Registry

ghcr.io

将 ghcr.io 替换为 ghcr.nju.edu.cn 即可。

如

docker pull ghcr.io/github/super-linter:latest

替换为

docker pull ghcr.nju.edu.cn/github/super-linter:latest

GLCR

GitLab Container Registry

registry.gitlab.com

将 registry.gitlab.com 替换为 glcr.nju.edu.cn 即可。

如

docker pull registry.gitlab.com/pipeline-components/yamllint

替换为

docker pull glcr.nju.edu.cn/pipeline-components/yamllint

NGC

NVIDIA NGC Catalog

nvcr.io

将 nvcr.io 替换为 nvcr.nju.edu.cn 或 ngc.nju.edu.cn 即可。

如

docker pull nvcr.io/nvidia/cuda

替换为

docker pull nvcr.nju.edu.cn/nvidia/cuda

Quay

Quay Container Registry

quay.io

将 quay.io 替换为 quay.nju.edu.cn 即可。

如

docker pull quay.io/prometheus/prometheus:latest

替换为

docker pull quay.nju.edu.cn/prometheus/prometheus:latest

K8s

Kubernetes's container image registry

registry.k8s.io

将 registry.k8s.io 替换为 k8s.nju.edu.cn 即可。

如

docker pull registry.k8s.io/busybox

替换为

docker pull k8s.nju.edu.cn/busybox

Go

注意，开源镜像同时提供 go 二进制文件下载，具体文件请参考链接。

go 配置方式比较简单，执行以下命令：

go env -w GO111MODULE=on ## 启用 Go Modules 功能
go env -w GOPROXY="https://repo.nju.edu.cn/go/,direct" ## 配置代理
go env | grep GOPROXY ## linux 确认配置
go env |findstr "GOPROXY" ## windows 确认配置

如有私有模块，可以通过以下命令特殊设置：

go env -w GOPRIVATE="*.nju.edu.cn"

Maven

采用官方 maven central + gradle-plugin 混合形式。gradle 和 maven 使用的是同一个仓库，不过配置方法略有区别。

maven 配置指南

全局配置

配置当前登录用户使用南大镜像站，如果未修改过 maven 的默认配置文件位置，请如下操作：

• linux 用户在终端中输入以下命令:

  mkdir ~/.m2
  vim ~/.m2/settings.xml

• windows 用户在 powershell (或者pwsh中) 输入以下命令：

  mkdir ~/.m2
  cd ~/.m2
  notepad settings.xml

如果打开的文件为空，粘贴以下内容：

<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
    <mirrors>
       <mirror>
            <id>nju_mirror</id>
            <mirrorOf>*</mirrorOf>
            <url>https://repo.nju.edu.cn/maven/</url>
        </mirror>
    </mirrors>
</settings>

如果已经有内容，则在 mirrors 节点加入子节点 (对于 mirrorOf 值相同的节点，只有首个子节点生效)：

<mirror>
    <id>nju_mirror</id>
    <mirrorOf>*</mirrorOf>
    <url>https://repo.nju.edu.cn/maven/</url>
</mirror>

保存退出即可使用。

项目配置

如果只在某个项目中使用，则在项目的 pom.xml 中配置：

<project>
    ......[其他配置]
    <repositories>
        <repository>
            <id>nju</id>
            <url>https://repo.nju.edu.cn/maven/</url>
            <releases>
                <enabled>true</enabled>
            </releases>
            <snapshots>
                <enabled>false</enabled>
            </snapshots>
        </repository>
    </repositories>
</project>

gradle-plugin 配置指南

注意，开源镜像同时提供 gradle 二进制文件下载，将项目文件下的 gradle\wapper\gradle-wrapper.properties 的 distributionUrl 修改为 http://mirror.nju.edu.cn/gradle/gradle-[version].zip 即可，详细版本请参考链接。

全局配置

配置当前登录用户使用南大镜像站，如果未修改过 gradle 的默认配置文件位置，请如下操作:

• linux 用户在终端中输入以下命令:

  mkdir ~/.gradle
  vim ~/.gradle/init.gradle

• windows 用户在 powershell (或者pwsh中) 输入以下命令:

  mkdir ~/.gradle
  cd ~/.gradle
  notepad init.gradle

覆盖写入以下内容:

allprojects {
    buildscript {
        repositories {
            def NJU_REPOSITORY_URL = 'https://repo.nju.edu.cn/maven/'
            all { ArtifactRepository repo ->
                if (repo instanceof MavenArtifactRepository) {
                    def url = repo.url.toString()
                    if (url.startsWith('https://repo1.maven.org/maven2')) {
                        project.logger.lifecycle "Repository ${repo.url} replaced by $NJU_REPOSITORY_URL."
                        remove repo
                    }
                    if (url.startsWith('https://jcenter.bintray.com/')) {
                        project.logger.lifecycle "Repository ${repo.url} deleted."
                        remove repo
                    }
                    if (url.startsWith('https://dl.google.com/dl/android/maven2/')) {
                        project.logger.lifecycle "Repository ${repo.url} deleted."
                        remove repo
                    }
                    if (url.contains('plugins.gradle.org/m2')) {
                        project.logger.lifecycle "Repository ${repo.url} deleted."
                        remove repo
                    }
                }
            }
            maven { url NJU_REPOSITORY_URL }
            mavenLocal()
        }
    }
    repositories {
        def NJU_REPOSITORY_URL = 'https://repo.nju.edu.cn/maven/'
        all { ArtifactRepository repo ->
            if (repo instanceof MavenArtifactRepository) {
                def url = repo.url.toString()
                if (url.startsWith('https://repo1.maven.org/maven2')) {
                    project.logger.lifecycle "Repository ${repo.url} replaced by $NJU_REPOSITORY_URL."
                    remove repo
                }
                if (url.startsWith('https://jcenter.bintray.com/')) {
                    project.logger.lifecycle "Repository ${repo.url} deleted."
                    remove repo
                }
                if (url.startsWith('https://dl.google.com/dl/android/maven2/')) {
                    project.logger.lifecycle "Repository ${repo.url} deleted."
                    remove repo
                }
                if (url.contains('plugins.gradle.org/m2')) {
                    project.logger.lifecycle "Repository ${repo.url} deleted."
                    remove repo
                }
            }
        }
        maven { url NJU_REPOSITORY_URL }
        mavenLocal()
    }
}

如果已经运行过 gradle ，请先执行一次 gradle --stop 命令关闭所有 gradle 的 daemon， 然后重新运行即可。

项目配置

如果只在某个项目中使用，则在项目的 build.gradle 中配置:

buildscript {
    repositories {
        maven { url 'https://repo.nju.edu.cn/maven/' }
    }
}
plugins {
    ...[你需要用的 gradle 插件]
}
allprojects {
    repositories {
        maven { url 'https://repo.nju.edu.cn/maven/' }
    }
}

注意这样可能有时候无法通过镜像下载部分 gradle 插件。

npm

Node Package Manager

南大源采用了腾讯云和官方源的混合代理形式。

npm 配置指南

临时使用

npm install [packageName] --registry=https://repo.nju.edu.cn/repository/npm/

使用此命令可以临时使用南大源下载指定包。

设置为默认源

使用一下命令修改默认源：

npm config set registry https://repo.nju.edu.cn/repository/npm/ ## 修改源

npm 私服

南京大学 npm 仓库同时提供 npm 包托管服务，本校师生可以将自己编写的 js 脚本打包后发布到仓库中让其他人使用。此仓库文件不会同步到其他镜像源。

从仓库获取文件

将上面提到的仓库地址改为 https://repo.nju.edu.cn/repository/npm-nju/ 即可。

使用此仓库请注意:

• 此仓库会优先从官方库和其他源中获取包，如果你发布了同名包，会被其他来源的同名包覆盖，因此请不要也禁止发布同名包或者名称相近包；
• 当仓库网络出现问题或者上游源出现问题时，可能会导致你下载到仓库其他人发布的同名包，这可能不是你想要的，甚至有风险（pypi 仓库则没有此问题）；
• 如果发现和上游仓库同名包，请填写统计表，管理员将会定期删除；
• 如果发现恶意同名包或者类似包，请填写统计表，管理员将核实后采取措施。

向仓库提交文件

1. 使用 npm 登陆：

   npm adduser --registry https://repo.nju.edu.cn/repository/npm-releases/

   其中，邮箱推荐使用南大邮箱，账号密码为统一身份认证账号密码。

2. 在项目的 package.json 中加入以下内容：

     "publishConfig": {
       "registry" : "https://repo.nju.edu.cn/repository/npm-releases/"
     },

3. 配置 package.json 中的其他配置项。

4. 配置 .npmignore 指定你不想发布的文件（夹）。

5. 构建并推送：

   npm run build
   npm publish

yarn 配置指南

yarn config set registry https://repo.nju.edu.cn/repository/npm/ ## 修改源

yarn 发布的过程和 npm 类似，不过 yarn login 的时候不需要输入密码，在每次发布的时候输入，具体内容请查看 yarn publish 的文档。

--