CINXE.COM

<!DOCTYPE html><html lang="zh"><head> <meta name="nav-disable" content="flex"> <link rel="icon" href="https://img.alicdn.com/imgextra/i2/O1CN01rTJFA01PLtrABdzju_!!6000000001825-55-tps-16-16.svg" type="image/x-icon"> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1"> <meta http-equiv="Cache-Control" content="no-siteapp"> <meta name="renderer" content="webkit"> <meta http-equiv="x-ua-compatible" content="ie=edge,chrome=1"> <meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1, maximum-scale=1, user-scalable=no"> <meta name="applicable-device" content="pc,mobile"> <meta name="nav-config" content="footer=default"> <meta name="data-spm" content="a2c4g"> <meta name="aplus-core" content="aplus.js"> <meta name="aplus-ajax" content="chksum"> <meta name="aplus-waiting" content="MAN"> <meta name="aplus-pvhash" content="1"> <script> window.pageStartTime = Date.now(); </script> <title>配置镜像加速器_容器镜像服务(ACR)-阿里云帮助中心</title> <link rel="canonical" href="https://help.aliyun.com/zh/acr/user-guide/accelerate-the-pulls-of-docker-official-images"> <meta name="keywords" content="Docker镜像加速,镜像拉取,下载加速,加速器地址"> <meta name="description" content="由于运营商网络原因，会导致您拉取Docker Hub镜像变慢，甚至下载失败。为此，阿里云容器镜像服务ACR提供了官方的镜像加速器，从而加速官方镜像的下载。"> <meta name="last-modified" content="2024-12-13T17:09:43+08:00"> <meta name="date" content="2017-10-20T02:39:31+08:00"> <link href="https://g.alicdn.com/aliyun-help/help-portal-fe/0.10.5/css/index.css" rel="stylesheet"> <script> window.globalData = { nodeId: "60750", } window.$ACE_TRACKER_CONFIG ={ "enableHistory":true, "enableHash":false } </script> <script> window.__ICE_SSR_ENABLED__=true; window.__ICE_APP_DATA__={}; window.__ICE_PAGE_PROPS__={"docDetailData":{"storeData":{"alias":"/acr/user-guide/accelerate-the-pulls-of-docker-official-images","nodeId":null,"data":{"lastModifiedTime":1734080983000,"keywords":"Docker镜像加速,镜像拉取,下载加速,加速器地址","docTitle":"官方镜像加速","language":"zh","seoTitle":"配置镜像加速器_容器镜像服务(ACR)-阿里云帮助中心","title":"官方镜像加速","content":"<div lang=\"zh\" class=\"icms-help-docs-content\">\n<main id=\"concept-2047800\"><p id=\"shortdesc-y6p-ooi-kpv\" data-tag=\"shortdesc\" class=\"shortdesc\">由于运营商网络原因，会导致您拉取<span class=\"help-letter-space\"></span>Docker Hub<span class=\"help-letter-space\"></span>镜像变慢，甚至下载失败。为此，阿里云容器镜像服务<span class=\"help-letter-space\"></span>ACR<span class=\"help-letter-space\"></span>提供了官方的镜像加速器，从而加速官方镜像的下载。</p><div data-tag=\"conbody\" id=\"conbody-rmn-7ir-1dt\" class=\"conbody\"><section data-tag=\"section\" id=\"section-puw-wqe-dy2\" data-type=\"section\" class=\"section\"><div id=\"ddc745301atht\" type=\"important\" class=\"note note-important\"><div class=\"note-icon-wrapper\"><i class=\"icon-note note important\"></i></div><div class=\"noteContentSpan\"><strong>重要 </strong><ul id=\"b4a91bbbb0aaq\"><li id=\"287695590b9u3\"><p id=\"a7f224701ai93\">镜像加速器是面向个人开发者的服务，仅限于支持个人开发场景，不允许有再次封装或商业用途。</p></li><li id=\"d9ae75d3fcice\"><p id=\"ca69158fd4rse\">根据<span class=\"help-letter-space\"></span>Docker<span class=\"help-letter-space\"></span>公司政策，2020<span class=\"help-letter-space\"></span>年<span class=\"help-letter-space\"></span>11<span class=\"help-letter-space\"></span>月<span class=\"help-letter-space\"></span>01<span class=\"help-letter-space\"></span>日起将逐步向<span class=\"help-letter-space\"></span>Docker Hub<span class=\"help-letter-space\"></span>匿名和免费用户实施速率和拉取请求次数限制。ACR<span class=\"help-letter-space\"></span>镜像加速器无法保证一定拉取到<span class=\"help-letter-space\"></span>latest<span class=\"help-letter-space\"></span>最新的镜像版本，建议您指定镜像版本拉取。关于<span class=\"help-letter-space\"></span>Docker Hub<span class=\"help-letter-space\"></span>拉取请求次数限制的详细介绍，请参见<span class=\"help-letter-space\"></span><a href=\"https://docs.docker.com/docker-hub/download-rate-limit/\" id=\"xref-6eg-zj4-dkx\" class=\"\" target=\"_blank\">Download rate limit</a>。</p></li><li id=\"db2da024d55o8\"><p id=\"f2f3e43cccypl\">面向生产环境使用场景，为避免<span class=\"help-letter-space\"></span>Docker<span class=\"help-letter-space\"></span>访问网络问题导致的镜像拉取失败，建议您在生产环境中慎重考虑对<span class=\"help-letter-space\"></span>Docker Hub<span class=\"help-letter-space\"></span>容器镜像的依赖。详情请参见<a href=\"#ae177dafd2kur\" id=\"9536a8f929iyf\" title=\"\" class=\"xref\">使用说明</a>。</p></li></ul></div></div></section><section id=\"76e56d39c4909\" class=\"section\"><h2 id=\"ae177dafd2kur\">使用说明</h2><p id=\"1abd83237dktr\">自<span class=\"help-letter-space\"></span>2024<span class=\"help-letter-space\"></span>年<span class=\"help-letter-space\"></span>07<span class=\"help-letter-space\"></span>月<span class=\"help-letter-space\"></span>02<span class=\"help-letter-space\"></span>日起，ACR<span class=\"help-letter-space\"></span>对镜像加速功能的使用范围进行了调整：</p><ul id=\"b146fd58dfcrf\"><li id=\"48a95728f5sya\"><p id=\"dfa99e61cf1be\">仅限阿里云用户在具备公网访问的阿里云产品上使用该镜像加速能力。</p></li><li id=\"a61546b8b6eut\"><p id=\"49518ce1d43kg\">仅支持通过镜像加速器拉取限定范围内的容器镜像。</p></li></ul><h3 id=\"c03425b300xjv\">Docker Hub<span class=\"help-letter-space\"></span>拉取失败<b>解决方案</b></h3><p id=\"b797581477k00\">由于运营商网络等不稳定因素可能导致镜像加速器无法成功拉取到指定版本的容器镜像，建议您在生产环境中谨慎使用依赖于<span class=\"help-letter-space\"></span>Docker Hub<span class=\"help-letter-space\"></span>的容器镜像。为了降低因网络问题引起的风险，您可以采取以下措施：</p><ul id=\"155465a3de2b6\"><li data-spm-anchor-id=\"0.0.0.i8.369e3d33vukwDS\" id=\"6f1605f2ecvfc\"><p id=\"c0a3fe2be93pw\">使用<a href=\"https://help.aliyun.com/zh/acr/user-guide/subscribe-to-image-tags\" id=\"b5945ffb22q13\" title=\"\" class=\"xref\">订阅海外源镜像</a>功能：将<span class=\"help-letter-space\"></span>Docker Hub<span class=\"help-letter-space\"></span>等海外镜像仓库中的镜像同步到企业版实例中。</p></li><li data-spm-anchor-id=\"0.0.0.i9.369e3d33vukwDS\" id=\"9edc99371f4ez\"><p id=\"c959dd0607069\"><a href=\"https://help.aliyun.com/zh/ack/ack-managed-and-ack-dedicated/user-guide/cross-domain-accelerated-pulling-container-images\" id=\"0675b0f0011yw\" title=\"\" class=\"xref\">跨域加速拉取容器镜像</a>：通过配置<span class=\"help-letter-space\"></span>GA<span class=\"help-letter-space\"></span>实例，实现网络加速，并跨域访问待拉取的海外镜像仓库。</p></li><li id=\"9630c14f25nh3\"><p uuid=\"lxcno9q4xxofss5av4\" id=\"b795881816rh5\">使用官方支持的基础镜像：建议使用阿里云<a href=\"https://help.aliyun.com/zh/acr/user-guide/artifact-center\" id=\"3ad67bd81bufr\" title=\"\" class=\"xref\">制品中心</a>提供的官方支持的容器基础镜像，以确保稳定性和安全性。</p></li></ul></section><section data-tag=\"section\" id=\"section-9tt-j3m-d2f\" data-type=\"section\" class=\"section\"><h2 data-tag=\"title\" id=\"title-txz-efu-kre\" class=\"title\">步骤一：获取镜像加速器地址</h2><p data-tag=\"p\" id=\"p-c43-tjz-h8c\" class=\"p\">ACR<span class=\"help-letter-space\"></span>会为每一个账号（阿里云账号或<span class=\"help-letter-space\"></span>RAM<span class=\"help-letter-space\"></span>用户）生成一个镜像加速器地址，配置镜像加速器前，您需要获取镜像加速器地址。</p><ol id=\"90f388daf27a3\"><li id=\"f8d981fba72f7\"><p data-tag=\"p\" id=\"p-ovs-krs-im1\" class=\"p\">登录<a href=\"https://cr.console.aliyun.com\" id=\"xref-70x-g3p-72z\" class=\"\" target=\"_blank\">容器镜像服务控制台</a>。</p></li><li id=\"bd0e690cbccfm\"><p id=\"f4143ca079lyc\">在左侧导航栏选择<span data-tag=\"menucascade\" id=\"menucascade-dmd-zap-kyy\" class=\"menucascade\"><b data-tag=\"uicontrol\" id=\"uicontrol-ag0-0tc-ufy\" class=\"uicontrol\">镜像工具</b> > <b data-tag=\"uicontrol\" id=\"uicontrol-lot-vm5-f2w\" class=\"uicontrol\">镜像加速器</b></span></p></li><li id=\"e0485d8f765p0\"><p id=\"eef13bee72kz0\">在<b data-tag=\"uicontrol\" id=\"uicontrol-pvg-zkg-q57\" class=\"uicontrol\">镜像加速器</b>页面获取<b data-tag=\"uicontrol\" id=\"328d3c501aoyd\" class=\"uicontrol\">加速器地址</b>。</p></li></ol></section><h2 id=\"e5fb051535p20\"><b>步骤二：配置镜像</b>加速器</h2><p id=\"77341589a1vxq\">Docker<span class=\"help-letter-space\"></span>和<span class=\"help-letter-space\"></span>Containerd<span class=\"help-letter-space\"></span>的镜像加速器配置方法有所不同。您可以根据具体情况选择合适的配置方式。关于<span class=\"help-letter-space\"></span>Docker Hub<span class=\"help-letter-space\"></span>镜像仓库拉取失败请参见<span class=\"help-letter-space\"></span><a href=\"#c03425b300xjv\" id=\"5f6a5c4d017fi\" title=\"\" class=\"xref\">Docker Hub<span class=\"help-letter-space\"></span>拉取失败解决方案</a>。</p><section id=\"b240b2162egpp\" data-tag=\"tabbed-content-box\" outputclass=\"tabbed-content-box\" class=\"tabbed-content-box section\"><section id=\"3f3899f8da4mz\" class=\"section\"><h2 data-tag=\"title\" id=\"df2f013a1ez0f\" class=\"title\">配置<span class=\"help-letter-space\"></span>Docker<span class=\"help-letter-space\"></span>运行时镜像加速器</h2><p id=\"2156c8d9aby9p\">您可以先使用<code data-tag=\"code\" code-type=\"xCode\" class=\"code\">docker --version</code>查看<span class=\"help-letter-space\"></span>Docker<span class=\"help-letter-space\"></span>的版本，然后根据实际情况选择不同的配置方式。</p><h3 id=\"64fd8449aczcq\"><b data-tag=\"uicontrol\" id=\"uicontrol-hat-53v-r9d\" class=\"uicontrol\">新版本<span class=\"help-letter-space\"></span>Docker（1.10<span class=\"help-letter-space\"></span>及以上）</b></h3><p id=\"5bc0e1966f669\">创建并编辑<code data-tag=\"code\" class=\"code blog-code\" data-spm-anchor-id=\"0.0.0.i22.369e3d33lBx01r\" code-type=\"xCode\">/etc/docker/daemon.json</code>文件（如果文件不存在，则创建）：</p><pre data-tag=\"codeblock\" id=\"721cdb648ddhe\" outputclass=\"language-json\" code-type=\"xCode\" class=\"pre codeblock language-json\"><code>{\n \"registry-mirrors\": [\"<镜像加速器地址>\"]\n} </code></pre><p data-tag=\"p\" id=\"50314451e7n8l\" class=\"p\">然后重启<span class=\"help-letter-space\"></span>Docker Daemon。</p><h3 data-tag=\"p\" id=\"6360c44327amz\" outputclass=\"h3\" class=\"p h3\"><b data-tag=\"uicontrol\" id=\"uicontrol-2cx-ub2-8d0\" class=\"uicontrol\">旧版本<span class=\"help-letter-space\"></span>Docker</b></h3><p data-tag=\"p\" id=\"6b22e88e84t36\" class=\"p\">您需要根据不同的操作系统修改对应的配置文件。</p><ul data-tag=\"ul\" id=\"76ece15d023gy\" class=\"ul\"><li data-tag=\"li\" id=\"9174612725d3u\" class=\"li\"><p id=\"f345f08b08ous\">Ubuntu 12.04 - 14.04 </p><p data-tag=\"p\" id=\"e7bf0e3943dpx\" class=\"p\">Ubuntu<span class=\"help-letter-space\"></span>的配置文件的位置在<span data-tag=\"filepath\" id=\"filepath-9df-tm6-loi\" class=\"filepath\">/etc/default/docker</span><span class=\"help-letter-space\"></span>目录下。您只需要在这个配置文件中添加加速器的配置项，重启<span class=\"help-letter-space\"></span>Docker<span class=\"help-letter-space\"></span>即可。</p><pre data-tag=\"codeblock\" id=\"acecc46de2t96\" outputclass=\"language-shell\" code-type=\"xCode\" class=\"pre codeblock language-shell\"><code>echo \"DOCKER_OPTS=\\\"\\$DOCKER_OPTS --registry-mirror=<your accelerate address>\\\"\" | sudo tee -a /etc/default/docker\nsudo service docker restart </code></pre></li><li data-tag=\"li\" id=\"03ae4ba8c6p7o\" class=\"li\"><p id=\"2bc58f69976gi\">Ubuntu 15.04 - 15.10 </p><p data-tag=\"p\" id=\"78a1945272tby\" class=\"p\">Ubuntu<span class=\"help-letter-space\"></span>的配置文件的位置在<span data-tag=\"filepath\" id=\"filepath-b8w-5oo-ii0\" class=\"filepath\">/etc/systemd/system/docker.service.d/</span>目录下。在这个目录下创建任意的<span data-tag=\"filepath\" id=\"filepath-ge8-lak-f71\" class=\"filepath\">*.conf</span><span class=\"help-letter-space\"></span>文件即可作为配置文件。然后在这个配置文件中添加加速器的配置项，之后重启<span class=\"help-letter-space\"></span>Docker<span class=\"help-letter-space\"></span>即可。</p><pre data-tag=\"codeblock\" id=\"bbfce2a168lv8\" outputclass=\"language-shell\" code-type=\"xCode\" class=\"pre codeblock language-shell\"><code>sudo mkdir -p /etc/systemd/system/docker.service.d\nsudo tee /etc/systemd/system/docker.service.d/mirror.conf <<-'EOF'\n[Service]\nExecStart=\nExecStart=/usr/bin/docker daemon -H fd:// --registry-mirror=<your accelerate address>\nEOF\nsudo systemctl daemon-reload\nsudo systemctl restart docker </code></pre></li><li data-tag=\"li\" id=\"fed2b09eefcr8\" class=\"li\"><p id=\"5d282372d1qel\">CentOS 7 </p><p data-tag=\"p\" id=\"053ce9fd512zg\" class=\"p\">CentOS<span class=\"help-letter-space\"></span>的配置方式略微复杂，需要先将默认的配置文件（<span data-tag=\"filepath\" id=\"filepath-0xr-6zg-xe4\" class=\"filepath\">/lib/systemd/system/docker.service</span>）复制到<span data-tag=\"filepath\" id=\"filepath-z86-uhf-ngk\" class=\"filepath\">/etc/systemd/system/docker.service</span>。然后再将加速器地址添加到配置文件的启动命令中，之后重启<span class=\"help-letter-space\"></span>Docker<span class=\"help-letter-space\"></span>即可。</p><pre data-tag=\"codeblock\" id=\"57cb6cffcaf00\" outputclass=\"language-shell\" code-type=\"xCode\" class=\"pre codeblock language-shell\"><code>sudo cp -n /lib/systemd/system/docker.service /etc/systemd/system/docker.service\nsudo sed -i \"s|ExecStart=/usr/bin/docker daemon|ExecStart=/usr/bin/docker daemon --registry-mirror=<your accelerate address>|g\" /etc/systemd/system/docker.service\nsudo sed -i \"s|ExecStart=/usr/bin/dockerd|ExecStart=/usr/bin/dockerd --registry-mirror=<your accelerate address>|g\" /etc/systemd/system/docker.service\nsudo systemctl daemon-reload\nsudo service docker restart </code></pre></li><li data-tag=\"li\" id=\"ead3c266f7n05\" class=\"li\"><p id=\"729a66a6d18l9\">Redhat 7 </p><p data-tag=\"p\" id=\"469cf69defk6c\" class=\"p\">Red Hat 7<span class=\"help-letter-space\"></span>配置加速器，需要编辑<span data-tag=\"filepath\" id=\"filepath-y7g-l1k-mkj\" class=\"filepath\">/etc/sysconfig/docker</span><span class=\"help-letter-space\"></span>配置文件。在<span data-tag=\"ph\" id=\"7a4c91bf96dbp\" class=\"ph\"><code data-tag=\"code\" code-type=\"xCode\" class=\"code\">OPTIONS</code></span>配置项中添加加速器配置<span data-tag=\"ph\" id=\"9c78d6d7794gn\" class=\"ph\"><code data-tag=\"code\" code-type=\"xCode\" class=\"code\">--registry-mirror=<your accelerate address></code></span>。最后执行<span data-tag=\"ph\" id=\"06829f6af8y3l\" class=\"ph\"><code data-tag=\"code\" code-type=\"xCode\" class=\"code\">sudo service docker restart</code></span>命令以重启<span class=\"help-letter-space\"></span>Docker Daemon。</p></li><li data-tag=\"li\" id=\"91a663f292bhn\" class=\"li\"><p id=\"cd54651669xsc\">Redhat 6/CentOS 6 </p><p data-tag=\"p\" id=\"cea574942e300\" class=\"p\">在这两个系统上无法直接安装<span class=\"help-letter-space\"></span>Docker，需要升级内核。</p><p data-tag=\"p\" id=\"7d30c627cbhgh\" class=\"p\">配置加速器时需要编辑<span data-tag=\"filepath\" id=\"filepath-ooz-c1c-r07\" class=\"filepath\">/etc/sysconfig/docker</span><span class=\"help-letter-space\"></span>配置文件。在<span data-tag=\"ph\" id=\"087cd946c143w\" class=\"ph\"><code data-tag=\"code\" code-type=\"xCode\" class=\"code\">other_args</code></span>配置项中添加加速器配置<span data-tag=\"ph\" id=\"8c719a41bf2on\" class=\"ph\"><code data-tag=\"code\" code-type=\"xCode\" class=\"code\">--registry-mirror=<your accelerate address></code></span>。最后执行<span data-tag=\"ph\" id=\"c40eb20fa3c5l\" class=\"ph\"><code data-tag=\"code\" code-type=\"xCode\" class=\"code\">sudo service docker restart</code></span>命令以重启<span class=\"help-letter-space\"></span>Docker Daemon。</p></li><li data-tag=\"li\" id=\"8670711d3aw1u\" class=\"li\"><p id=\"aa13f26849vzp\">Docker Toolbox （Windows、Mac）</p><p data-tag=\"p\" id=\"fc673f952dcs2\" class=\"p\">在<span class=\"help-letter-space\"></span>Windows、Mac<span class=\"help-letter-space\"></span>系统上使用<span class=\"help-letter-space\"></span>Docker Toolbox<span class=\"help-letter-space\"></span>的话，推荐做法是在创建<span class=\"help-letter-space\"></span>Linux<span class=\"help-letter-space\"></span>虚拟机的时候，就将加速器的地址配置进去。</p><pre data-tag=\"codeblock\" id=\"ae81f7bbd6ww3\" outputclass=\"language-shell\" code-type=\"xCode\" class=\"pre codeblock language-shell\"><code>docker-machine create --engine-registry-mirror=<your accelerate address> -d virtualbox default\ndocker-machine env default\neval \"$(docker-machine env default)\"\ndocker info </code></pre><p data-tag=\"p\" id=\"fc24ed8f85yju\" class=\"p\">如果您已经通过<span class=\"help-letter-space\"></span>docker-machine<span class=\"help-letter-space\"></span>创建了虚拟机的话，则需要通过登录该虚拟机来修改配置。</p><ol data-tag=\"ol\" id=\"8fb9f10b200u5\" class=\"ol\"><li data-tag=\"li\" id=\"a0deb1c37fyi7\" class=\"li\"><p id=\"13dc0b78591wk\">执行<span data-tag=\"ph\" id=\"2ba08339b432z\" class=\"ph\"><code data-tag=\"code\" code-type=\"xCode\" class=\"code\">docker-machine ssh <machine-name></code></span>命令以登录虚拟机。</p></li><li data-tag=\"li\" id=\"36e99f151dg05\" class=\"li\"><p id=\"02c5ecb690o8c\">修改<span data-tag=\"filepath\" id=\"filepath-h2g-xzr-jo9\" class=\"filepath\">/var/lib/boot2docker/profile</span><span class=\"help-letter-space\"></span>文件，将<span data-tag=\"ph\" id=\"6e09296cbdy0z\" class=\"ph\"><code data-tag=\"code\" code-type=\"xCode\" class=\"code\">--registry-mirror=<your accelerate address></code></span>添加到<span data-tag=\"ph\" id=\"0555439c96899\" class=\"ph\"><code data-tag=\"code\" code-type=\"xCode\" class=\"code\">EXTRA_ARGS</code></span>中。</p></li><li data-tag=\"li\" id=\"a2ada7cc03pio\" class=\"li\"><p id=\"73d5cb1180vik\">执行<span data-tag=\"ph\" id=\"e1078d6917yxb\" class=\"ph\"><code data-tag=\"code\" code-type=\"xCode\" class=\"code\">sudo /etc/init.d/docker restart</code></span>命令以重启<span class=\"help-letter-space\"></span>Docker<span class=\"help-letter-space\"></span>服务。</p></li></ol></li></ul></section><section id=\"645741d7b6sia\" class=\"section\"><h2 data-tag=\"title\" id=\"4766fe99e4g5f\" class=\"title\">配置<span class=\"help-letter-space\"></span>Containerd<span class=\"help-letter-space\"></span>运行时镜像加速器</h2><p id=\"c02768d5e3nha\">Containerd<span class=\"help-letter-space\"></span>在启动时指定默认的配置文件路径为<code data-tag=\"code\" class=\"code blog-code\" code-type=\"xCode\">/etc/containerd/config.toml</code>，后续所有镜像仓库相关的配置可以在该文件中进行热加载，无需重启<span class=\"help-letter-space\"></span>Containerd。如果您使用不同的路径，可以根据实际情况进行调整。</p><ol data-tag=\"ol\" id=\"ol-34h-sly-2mo\" class=\"ol\"><li data-tag=\"li\" id=\"li-wkg-q04-a2z\" class=\"li\"><p id=\"e7842cdd1elfq\">确保配置文件包含<code data-tag=\"code\" class=\"code blog-code\" data-spm-anchor-id=\"0.0.0.i44.369e3d33noKCLh\" code-type=\"xCode\">config_path</code>。</p><p id=\"398d74db57n0n\">执行以下命令，确认默认配置文件中是否存在<code data-tag=\"code\" class=\"code blog-code\" code-type=\"xCode\">config_path </code>配置（例如<code data-tag=\"code\" class=\"code blog-code\" code-type=\"xCode\">\"/etc/containerd/cert.d\"</code>）。</p><pre code-type=\"xCode\" id=\"509a4991ackw6\" data-tag=\"codeblock\" outputclass=\"language-bash\" class=\"pre codeblock language-bash\"><code>cat /etc/containerd/config.toml |grep config_path -C 5</code></pre><p id=\"bc8088f170ldc\">如果不存在，您可以在默认配置文件中添加以下配置。</p><div type=\"note\" id=\"c737660d06216\" class=\"note note-note\"><div class=\"note-icon-wrapper\"><i class=\"icon-note note note\"></i></div><div class=\"noteContentSpan\"><strong>说明 </strong><p id=\"58bf7c6446yih\">若已有<span data-tag=\"ph\" id=\"3d97884e75a7r\" class=\"ph\"><code data-tag=\"code\" code-type=\"xCode\" class=\"code\">[plugins.\"io.containerd.grpc.v1.cri\".registry]</code></span>，则在下面只需添加<code data-tag=\"code\" code-type=\"xCode\" class=\"code\">config_path</code>，注意缩进。若没有，则可以在任意地方写入。</p></div></div><pre code-type=\"xCode\" id=\"fbab4e761bncs\" data-tag=\"codeblock\" outputclass=\"language-json\" class=\"pre codeblock language-json\"><code> [plugins.\"io.containerd.grpc.v1.cri\".registry]\n config_path = \"/etc/containerd/certs.d\"</code></pre></li><li id=\"198659b34115a\"><p id=\"f3add5850azv8\">检查<code data-tag=\"code\" class=\"code blog-code\" code-type=\"xCode\">mirror</code>相关配置。</p><p id=\"6ee95e5093aad\">检查<code data-tag=\"code\" class=\"code blog-code\" code-type=\"xCode\">/etc/containerd/config.toml</code>配置文件中是否存在与<code data-tag=\"code\" code-type=\"xCode\" class=\"code\">mirror</code>相关的配置。如果已存在，请进行清理，以避免冲突。</p><pre code-type=\"xCode\" id=\"c8d4f154c9sel\" data-tag=\"codeblock\" outputclass=\"language-json\" class=\"pre codeblock language-json\"><code>[plugins.\"io.containerd.grpc.v1.cri\".registry.mirrors]\n [plugins.\"io.containerd.grpc.v1.cri\".registry.mirrors.\"docker.io\"]\n endpoint = [\"https://registry-1.docker.io\"]</code></pre></li><li id=\"9565322bfeoqt\"><p id=\"661cc352de6go\">重启<code data-tag=\"code\" class=\"code blog-code\" code-type=\"xCode\">containerd</code>（可选）。</p><p id=\"5de0eaf764bwp\">如果默认配置文件发生更改，则可执行以下命令，重启<span class=\"help-letter-space\"></span>Containerd。</p><pre code-type=\"xCode\" id=\"d2a167c50csxi\" data-tag=\"codeblock\" outputclass=\"language-bash\" class=\"pre codeblock language-bash\"><code>systemctl restart containerd</code></pre><p id=\"10549d3ce7ubx\">若启动失败，执行以下命令。检查失败原因，通常是配置文件仍有冲突导致，您可以依据报错做相应调整。</p><pre code-type=\"xCode\" id=\"e630e5adf03yo\" data-tag=\"codeblock\" outputclass=\"language-bash\" class=\"pre codeblock language-bash\"><code>journalctl -u containerd</code></pre></li><li data-tag=\"li\" id=\"ce64c5b3c4cbm\" class=\"li\"><p id=\"4043c5860e6a8\">创建镜像加速器配置文件。</p><p id=\"e58996b7edosu\">使用以下内容在指定的<span class=\"help-letter-space\"></span><span data-tag=\"parmname\" id=\"113c0f0a9exir\" class=\"parmname\">config_path</span><span class=\"help-letter-space\"></span>路径下创建<span class=\"help-letter-space\"></span><span data-tag=\"filepath\" id=\"a5f9084973dx2\" class=\"filepath\">docker.io/hosts.toml</span><span class=\"help-letter-space\"></span>文件，创建后的文件路径为<code data-tag=\"code\" code-type=\"xCode\" class=\"code\">/etc/containerd/certs.d/docker.io/hosts.toml</code>。</p><pre code-type=\"xCode\" id=\"e7f0fc9584o7l\" data-tag=\"codeblock\" outputclass=\"language-bash\" class=\"pre codeblock language-bash\"><code>server = \"https://registry-1.docker.io\"\n\n[host.\"$(镜像加速器地址，如<span class=\"help-letter-space\"></span>https://xxx.mirror.aliyuncs.com)\"]\n capabilities = [\"pull\", \"resolve\", \"push\"]</code></pre></li><li data-tag=\"li\" id=\"3c7b2b48822fw\" class=\"li\"><p id=\"3be19effdafvm\">拉取<span class=\"help-letter-space\"></span>Docker<span class=\"help-letter-space\"></span>镜像验证加速是否生效。如未生效，请参见<span class=\"help-letter-space\"></span><a href=\"https://github.com/containerd/containerd/blob/main/docs/hosts.md\" id=\"61c7b3d802ucu\" class=\"\" target=\"_blank\">Reference</a>。</p></li></ol></section></section></div></main>\n\n</div>","path":"https://help.aliyun.com/zh/acr/user-guide/accelerate-the-pulls-of-docker-official-images","productNodeVO":{"level":3,"docTitle":"容器镜像服务","id":60716,"title":"容器镜像服务","url":"/zh/acr/"},"alias":"/acr/user-guide/accelerate-the-pulls-of-docker-official-images","showType":1,"taskStatus":"NO_TASK_AVAILABLE","website":"cn","level":6,"developerUrl":"https://developer.aliyun.com/group/kubernetes/","nodeType":1,"version":37,"url":"/zh/acr/user-guide/accelerate-the-pulls-of-docker-official-images","tags":[{"value":"1","key":"accept","desc":"已承接"},{"value":false,"key":"autoTranslation","desc":"非自动翻译"},{"value":60750,"key":"nodeId","desc":"文档ID"}],"userVO":{},"recommendDocs":[{"scm":"20140722.H_2847130._.ID_2847130-OR_rec-V_1","title":"新个人版实例使用限制","nodeId":2847130,"url":"https://help.aliyun.com/zh/acr/user-guide/individual-edition-instance-independent-domain-name-capacity-limit?scm=20140722.H_2847130._.ID_2847130-OR_rec-V_1"},{"scm":"20140722.H_60743._.ID_60743-OR_rec-V_1","title":"Docker基本操作","nodeId":60743,"url":"https://help.aliyun.com/zh/acr/getting-started/basic-operations-on-docker?scm=20140722.H_60743._.ID_60743-OR_rec-V_1"},{"scm":"20140722.H_198212._.ID_198212-OR_rec-V_1","title":"使用个人版实例推送拉取镜像","nodeId":198212,"url":"https://help.aliyun.com/zh/acr/user-guide/use-a-container-registry-personal-edition-instance-to-push-and-pull-images?scm=20140722.H_198212._.ID_198212-OR_rec-V_1"},{"scm":"20140722.H_60997._.ID_60997-OR_rec-V_1","title":"构建仓库与镜像","nodeId":60997,"url":"https://help.aliyun.com/zh/acr/user-guide/create-a-repository-and-build-images?scm=20140722.H_60997._.ID_60997-OR_rec-V_1"},{"scm":"20140722.H_414209._.ID_414209-OR_rec-V_1","title":"镜像同步加速","nodeId":414209,"url":"https://help.aliyun.com/zh/acr/user-guide/accelerate-image-replication?scm=20140722.H_414209._.ID_414209-OR_rec-V_1"},{"scm":"20140722.H_2806734._.ID_2806734-OR_rec-V_1","title":"【产品变更】ACR镜像加速器功能调整公告","nodeId":2806734,"url":"https://help.aliyun.com/zh/acr/product-overview/product-change-acr-mirror-accelerator-function-adjustment-announcement?scm=20140722.H_2806734._.ID_2806734-OR_rec-V_1"},{"scm":"20140722.H_60761._.ID_60761-OR_rec-V_1","title":"Docker登录、推送和拉取失败常见问题","nodeId":60761,"url":"https://help.aliyun.com/zh/acr/support/faq-about-errors-of-docker-login-docker-push-and-docker-pull?scm=20140722.H_60761._.ID_60761-OR_rec-V_1"},{"scm":"20140722.H_257112._.ID_257112-OR_rec-V_1","title":"什么是容器镜像服务ACR","nodeId":257112,"url":"https://help.aliyun.com/zh/acr/product-overview/what-is-container-registry?scm=20140722.H_257112._.ID_257112-OR_rec-V_1"}],"directoryPath":{"children":[{"children":[{"children":[{"level":6,"docTitle":"官方镜像加速","id":60750,"title":"官方镜像加速","url":"/zh/acr/user-guide/accelerate-the-pulls-of-docker-official-images"}],"level":5,"docTitle":"镜像工具","id":348824,"title":"镜像工具","url":"/zh/acr/user-guide/image-tool/"}],"level":4,"docTitle":"操作指南","id":2391466,"title":"操作指南","url":"/zh/acr/user-guide/"}],"level":3,"docTitle":"容器镜像服务","id":60716,"title":"容器镜像服务","url":"/zh/acr/"},"productUrl":"https://www.aliyun.com/product/acr","nodeId":60750,"desc":"由于运营商网络原因，会导致您拉取Docker Hub镜像变慢，甚至下载失败。为此，阿里云容器镜像服务ACR提供了官方的镜像加速器，从而加速官方镜像的下载。"},"breadcrumb":[{"level":3,"docTitle":"容器镜像服务","id":60716,"title":"容器镜像服务","url":"/zh/acr/"},{"level":4,"docTitle":"操作指南","id":2391466,"title":"操作指南","url":"/zh/acr/user-guide/"},{"level":5,"docTitle":"镜像工具","id":348824,"title":"镜像工具","url":"/zh/acr/user-guide/image-tool/"},{"level":6,"docTitle":"官方镜像加速","id":60750,"title":"官方镜像加速","url":"/zh/acr/user-guide/accelerate-the-pulls-of-docker-official-images"}],"isMachineTranslation":false,"showNoteTip":false,"isNotFound":false,"helpResponseCode":200,"redirectUrl":"","helpDocVersion":1}}}; </script><link href="https://g.alicdn.com/code/npm/@ali??hmod-ace-2023-box/0.1.0/index.css,hmod-aliyun-com-global-nav-search/0.6.5/index.css,hmod-aliyun-com-global-nav/0.2.20/index.css" rel="stylesheet"/> <link href="https://g.alicdn.com/code/npm/@ali??hmod-ace-2023-box/0.1.0/index.css,hmod-ace-2024-global-footer/0.1.1/index.css" rel="stylesheet"/> </head> <body><script> with(document)with(body)with(insertBefore(createElement("script"),firstChild))setAttribute("exparams","category=&userid=&aplus&yunid=&&trid=213e365217411060670575674eca54&asid=AQAAAACTK8dnR3ZjVgAAAAAaw621kKD9Cg==",id="tb-beacon-aplus",src=(location>"https"?"//g":"//g")+".alicdn.com/alilog/mlog/aplus_v2.js") </script> <header><div id="aa49b28e70b6bd34838e39b241a7a68f"><div class="_18a32969382a277c44015217fbc5cb5a_box"><div class="fe4a1cf887cb106496bab02aa3f053f2_pc de5ef2fee09ebcb2b1dcaf0c982523bc_theme bdac01e7d42089a1161e0315c2a68512_reset" data-ai-assistant-text-selection-tooltip="disabled"><header class="c16fe8f3d0c4160ba7978e31342174b7_container "><a href="https://www.aliyun.com/" class="_3f46140aade30bc61f3012933357c477_logo c16fe8f3d0c4160ba7978e31342174b7_logo" data-tracker-content="LOGO" data-spm="d_logo"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 4608 1024" width="88"><path d="M3266.56 773.12h327.68v-102.4h-327.68v-102.4H3584V35.84H2846.72v532.48h317.44v102.4h-327.68v102.4h327.68v112.64h-353.28v102.4h814.08v-102.4h-353.28v-112.64zM3276.8 138.24h215.04v112.64H3276.8V138.24z m0 215.04h215.04V460.8H3276.8V353.28zM3174.4 460.8h-215.04V353.28H3174.4V460.8z m0-209.92h-215.04V138.24H3174.4v112.64zM537.6 445.44H1075.2v122.88H537.6z"></path><path d="M1341.44 5.12h-353.28L1075.2 128l256 81.92c46.08 15.36 76.8 61.44 76.8 107.52v389.12c0 46.08-30.72 92.16-76.8 107.52l-256 81.92-87.04 122.88h353.28c148.48 0 266.24-117.76 266.24-266.24V276.48c0-148.48-117.76-271.36-266.24-271.36zM276.48 814.08c-46.08-15.36-76.8-61.44-76.8-107.52V317.44c0-46.08 30.72-92.16 76.8-107.52l256-81.92L619.52 5.12H266.24C117.76 5.12 0 128 0 276.48v471.04c0 148.48 117.76 266.24 266.24 266.24h353.28l-87.04-122.88-256-76.8zM2493.44 250.88h-261.12v537.6h261.12V250.88z m-107.52 430.08h-56.32V353.28h56.32v327.68zM1848.32 988.16h102.4V138.24h107.52L1996.8 419.84v102.4h61.44v225.28c0 15.36-10.24 25.6-25.6 25.6h-25.6v102.4h51.2c56.32 0 102.4-46.08 102.4-102.4v-358.4H2099.2l61.44-281.6v-102.4h-312.32v957.44z"></path><path d="M2206.72 138.24H2560v660.48c0 46.08-35.84 87.04-87.04 87.04h-76.8v102.4h107.52c87.04 0 163.84-71.68 163.84-163.84V138.24h35.84v-102.4h-496.64v102.4zM3763.2 40.96h737.28v102.4H3763.2zM4541.44 527.36v-102.4H3727.36v102.4h204.8l-163.84 358.4v102.4h691.2c30.72 0 51.2-25.6 51.2-51.2 0-10.24 0-15.36-5.12-20.48l-87.04-194.56h-112.64l76.8 163.84h-496.64l163.84-358.4h491.52z"></path></svg></a><div class="e76910c82efe8556eb8a6ce6019c5d00_container"><button class="e76910c82efe8556eb8a6ce6019c5d00_controller"><i class="ee52067fb65534cb06d3b35f654f5441_icon c0d2b2426f4e619b0e0a3897f1b4cfdb-button_left"></i></button><div class="e76910c82efe8556eb8a6ce6019c5d00_menu-warp"><nav class="_6bd4655fd97b17a7b684887be1d4e2a4_menus"><a class="_6bd4655fd97b17a7b684887be1d4e2a4_menu " href="https://www.aliyun.com/product/tongyi" data-spm="d_menu_0">大模型</a><a class="_6bd4655fd97b17a7b684887be1d4e2a4_menu " href="https://www.aliyun.com/product/list" data-spm="d_menu_1">产品</a><button class="_6bd4655fd97b17a7b684887be1d4e2a4_menu " data-spm="d_menu_2">解决方案</button><a class="_6bd4655fd97b17a7b684887be1d4e2a4_menu " href="https://www.aliyun.com/resources" data-spm="d_menu_3">文档与社区</a><a class="_6bd4655fd97b17a7b684887be1d4e2a4_menu " href="https://www.aliyun.com/benefit" data-spm="d_menu_4">权益中心</a><a class="_6bd4655fd97b17a7b684887be1d4e2a4_menu " href="https://www.aliyun.com/price" data-spm="d_menu_5">定价</a><a class="_6bd4655fd97b17a7b684887be1d4e2a4_menu " href="https://market.aliyun.com/" data-spm="d_menu_6">云市场</a><a class="_6bd4655fd97b17a7b684887be1d4e2a4_menu " href="https://partner.aliyun.com/management/v2" data-spm="d_menu_7">合作伙伴</a><a class="_6bd4655fd97b17a7b684887be1d4e2a4_menu " href="https://www.aliyun.com/service" data-spm="d_menu_8">支持与服务</a><a class="_6bd4655fd97b17a7b684887be1d4e2a4_menu " href="https://www.aliyun.com/about" data-spm="d_menu_9">了解阿里云</a></nav></div><button class="e76910c82efe8556eb8a6ce6019c5d00_controller"><i class="ee52067fb65534cb06d3b35f654f5441_icon c0d2b2426f4e619b0e0a3897f1b4cfdb-button_right"></i></button></div><div class="c16fe8f3d0c4160ba7978e31342174b7_search-wrap"><div class="global-nav-search _626567c051250ffe2f303af907d3fc83_global-nav-search"><div class="global-search-container _626567c051250ffe2f303af907d3fc83_global-nav-search-desktop-container"></div><div class="_626567c051250ffe2f303af907d3fc83_global-nav-search-mobile-container"><a class="_626567c051250ffe2f303af907d3fc83_search-button" href="https://www.aliyun.com/search"><span role="img" class="_9a1d73bbcd1a80626a31035a12410804_icon _626567c051250ffe2f303af907d3fc83_search-button-icon"><svg width="1em" height="1em" viewBox="0 0 32 32" focusable="false" color="currentColor" fill="currentColor" class="" data-icon="search"><g fill-rule="evenodd" stroke-width="1"><path d="M14,4 C15.3558127,4 16.653362,4.26210485 17.8926477,4.78631455 C19.0891275,5.29241739 20.1485621,6.00666269 21.0709515,6.92905045 C21.9933389,7.8514363 22.7075837,8.91087023 23.213686,10.1073523 C23.7378953,11.3466396 24,12.6441889 24,14 C24,15.3558159 23.737896,16.6533658 23.2136879,17.8926497 C22.838225,18.7802852 22.3482024,19.5924969 21.7436199,20.3292847 L27.7071819,26.2928467 L26.2929688,27.7070599 L20.3294201,21.7435112 C19.592603,22.3481382 18.7803456,22.8381971 17.8926477,23.2136879 C16.6533607,23.737896 15.3558114,24 14,24 C12.6441879,24 11.3466384,23.737896 10.1073513,23.2136879 C8.91087246,22.7075844 7.85143844,21.9933383 6.92904925,21.0709496 C6.00666173,20.1485621 5.29241653,19.0891282 4.78631365,17.8926477 C4.26210455,16.6533613 4,15.3558121 4,14 C4,12.6441879 4.26210451,11.3466388 4.78631353,10.1073527 C5.29241594,8.91087262 6.00666118,7.85143844 6.92904925,6.92905021 C7.85143812,6.00666118 8.91087198,5.2924157 10.1073508,4.78631377 C11.3466366,4.26210459 12.6441863,4 14,4 Z M14,6 C11.7910172,6 9.90543811,6.78108788 8.34326267,8.34326363 C6.78108756,9.90543874 6,11.7910175 6,14 C6,16.2089825 6.78108756,18.0945616 8.34326267,19.6567373 C9.90543779,21.2189124 11.7910169,22 14,22 C16.2089844,22 18.0945635,21.2189128 19.6567373,19.6567383 C21.2189124,18.0945644 22,16.208985 22,14 C22,11.7910175 21.2189124,9.9054389 19.6567373,8.3432641 C18.0945622,6.78108803 16.2089831,6 14,6 Z"></path></g></svg></span></a></div></div></div><div class="_466a0cb95cb7813386faf52f1dca1156_container"><button class="_466a0cb95cb7813386faf52f1dca1156_item"><i class="ee52067fb65534cb06d3b35f654f5441_icon c0d2b2426f4e619b0e0a3897f1b4cfdb-intl"></i></button><button class="_466a0cb95cb7813386faf52f1dca1156_item"><i class="ee52067fb65534cb06d3b35f654f5441_icon c0d2b2426f4e619b0e0a3897f1b4cfdb-contact _2b88897e79e906382c0bd9ee52b33c40_icon"></i></button><a class="_466a0cb95cb7813386faf52f1dca1156_item _2d3ef330b3f8055912d355b9a255bfcf_btn global-nav-ai-assistant" href="https://www.aliyun.com/ai-assistant" data-spm="dai_assistant" target="_blank"><div class="LogoStyled-aliyun-service-ai-assistant-8096__sc-1qhy9yu-0 cTwoqf"><div class="ai-assistant-brand-logo-icon"></div><div class="ai-assistant-brand-logo-tooltip "><div class="ai-assistant-logo-tooltip-content">AI 助理</div></div></div></a><a class="_466a0cb95cb7813386faf52f1dca1156_item" href="https://beian.aliyun.com/" target="_blank" data-spm="d_beian">备案</a><a class="_466a0cb95cb7813386faf52f1dca1156_item" href="https://home.console.aliyun.com/" target="_blank" rel="nofollow" data-spm="d_console">控制台</a><span class="d93ece8cfc5aebf2fd264608e956db0e_loading"></span></div></header></div><div class="fe4a1cf887cb106496bab02aa3f053f2_mobile de5ef2fee09ebcb2b1dcaf0c982523bc_theme bdac01e7d42089a1161e0315c2a68512_reset"></div><div class="_18a32969382a277c44015217fbc5cb5a_box"></div></div></div></header> <div id="app"><div class="MainLayout--mainContainer--T7VyS0L" id="docs-container"><div class="MainLayout--helpBodyHead--WaAdRhj"><div class="HelpBodyHead--helpBodyHeadBox--HYlv4D7 help-body-head" data-spm="help-sub-nav"><div class="HelpBodyHead--helpBodyHead--P3Pk2U4 help-body-head-content"><div class="HelpBodyHead--helpHeadDocName--gntFssw"><a href="/" data-spm="d_logo">文档</a></div><div class="TabList--tabListContainer--B9nztnf"></div><div class="HelpBodyHead--bodyHeadRight--vGcxD7X"><div class="HelpBodyHead--helpBodyBoxHeaderSearch--zU8Pkno"><div class="TopSearch--helpTopSearch--mfaux4L help-search" data-spm="d_help_search"><div class="TopSearch--helpTopSearchBtn--p4xi3nv help-search-btn"><span>输入文档关键字查找</span><i class="TopSearch--searchIcon--wjY7t7t help-iconfont help-icon-sousuoicon"></i></div></div></div></div></div></div></div><div class="PcLayout--docsContainer--DmnyXRs"><div class="PcLayout--mobileHelpBodyHead--q5cfaco"><div class="HelpBodyHead--mobileHeadBlank--CVMGJNc"></div></div><div class="PcLayout--aliyunAppLayout--w3f1Oh2"><nav class="aliyun-docs-menu" id="aliyun-docs-menu"><div class="Menu--helpMenuBox--rvBkNtL" style="width:300px"><div class="Menu--helpMenuInnerBox--ug8hNia aliyun-docs-toc-content" style="width:300px"><div class="Menu--helpMenuDrag--W0G51Pn help-menu-drag-box"></div><div class="Menu--helpMenu--NtCAOFi"><div class="Menu--helpMenuTop--sW3oCtd"><div class="help-menu-title"> <a class="menu-title-text" href="/zh/acr/">容器镜像服务</a> </div><span class="Menu--iconBox--aiGPySP"><i class="help-iconfont help-icon-mulushu-shouqiicon Menu--iconFold--OWcQCnw"></i></span></div><div class="help-menu-subproduct"></div><div class="MenuSearch--collapseActionBar--RGvhX68"><div class="MenuSearch--searchContainer--HaaEp1U"><div class="MenuSearch--searchInputWrapper--TzFxFLF"><i class="help-iconfont help-icon-sousuoicon"></i><input placeholder="在目录中筛选" class="MenuSearch--searchInput--RHPwQ0V"></div></div></div><div class="help-menu-scroll-container Menu--menuContent--yZh5e8Y" data-spm="help-menu-undefined"><ul id="common-menu-container"> <li id="2391465" class="Menu--level1--UN3zYr3"> <a href="/zh/acr/product-overview/"> <i class="iconfont icon-close-arrow"></i> <span class="Menu--menuItemText--a6B4ZGH">产品概述</span> </a> </li> <li id="60720" class="Menu--level1--UN3zYr3"> <a href="/zh/acr/getting-started/"> <i class="iconfont icon-close-arrow"></i> <span class="Menu--menuItemText--a6B4ZGH">快速入门</span> </a> </li> <li id="2391466" class="Menu--level1--UN3zYr3"> <a href="/zh/acr/user-guide/"> <i class="iconfont icon-close-arrow"></i> <span class="Menu--menuItemText--a6B4ZGH">操作指南</span> </a> </li> <li id="2391467" class="Menu--level1--UN3zYr3"> <a href="/zh/acr/use-cases/"> <i class="iconfont icon-close-arrow"></i> <span class="Menu--menuItemText--a6B4ZGH">实践教程</span> </a> </li> <li id="2835241" class="Menu--level1--UN3zYr3"> <a href="/zh/acr/security-and-compliance/"> <i class="iconfont icon-close-arrow"></i> <span class="Menu--menuItemText--a6B4ZGH">安全合规</span> </a> </li> <li id="2391468" class="Menu--level1--UN3zYr3"> <a href="/zh/acr/developer-reference/"> <i class="iconfont icon-close-arrow"></i> <span class="Menu--menuItemText--a6B4ZGH">开发参考</span> </a> </li> <li id="2391469" class="Menu--level1--UN3zYr3"> <a href="/zh/acr/support/"> <i class="iconfont icon-close-arrow"></i> <span class="Menu--menuItemText--a6B4ZGH">服务支持</span> </a> </li> <li id="2391470" class="Menu--level1--UN3zYr3"> <a href="/zh/acr/videos/"> <i class="iconfont icon-close-arrow"></i> <span class="Menu--menuItemText--a6B4ZGH">视频专区</span> </a> </li> </ul></div></div></div><div class="Menu--productList--SsQU8sf" style="display:none"><div class="ProductList--allProducts--Cpyf6bU"><div class="ProductList--allProductsHead--MeeTG5_"><div class="ProductList--allProductsSearchWrapper--OKEHZgy"><div class="ProductList--allProductsSearch--abkWbSn"><span class="ProductList--searchIcon--MP25K3d"><i class="help-iconfont help-icon-sousuoicon"></i></span><input placeholder="输入文档关键字查找"></div></div></div><div class="ProductList--allProductsBody--JZw6xAE"></div></div></div></div></nav><main class="aliyun-docs-view" id="aliyun-docs-view"><div class="ProductDetail--contentWrapper--iCunrBZ"><section class="aliyun-docs-content" style="height:auto"><header class="aliyun-docs-view-header"><div class="Header--topBar--LXfTLL5"><div class="BreadCrumb--breadcrumb--cbt4qaF"><div class="BreadCrumb--breadcrumb--cbt4qaF"> <a href="/">首页</a> <span class="BreadCrumb--arrow--FD7AzzB"> <i class="iconfont icon-right-arrow"></i> </span> <a href="/zh/acr/">容器镜像服务</a> <span class="BreadCrumb--arrow--FD7AzzB"> <i class="iconfont icon-right-arrow"></i> </span> <a href="/zh/acr/user-guide/">操作指南</a> <span class="BreadCrumb--arrow--FD7AzzB"> <i class="iconfont icon-right-arrow"></i> </span> <a href="/zh/acr/user-guide/image-tool/">镜像工具</a> <span class="BreadCrumb--arrow--FD7AzzB"> <i class="iconfont icon-right-arrow"></i> </span> <span>官方镜像加速</span> </div></div></div><div class="Header--title--iTk2tUo"><h1>官方镜像加速</h1><div class="Header--actionBar--dvzFYrk"><div class="Header--left--x8TGxDL"><span class="Header--updateTime--YXGPhcZ">更新时间：</span></div><div class="Header--right--l4TSW1E"><div class="Header--linkButton--LpCRs1O"><div class="OuterUrl--outUrl--ZFzJIhk"><a href="https://www.aliyun.com/product/acr" target="_blank" rel="noreferrer">产品详情</a></div></div><div class="Contact--contactButton--TBwTX5R"><span class="Contact--favoritesBtn--J8mRVBp" title="收藏本文档" data-spm-click="gostr=/aliyun;locaid=collect"><i class="help-iconfont help-icon-like"></i></span><a href="/my_favorites.html">我的收藏</a></div></div></div></div></header><div class="pc-markdown-container unionContainer" id="pc-markdown-container"><div class="markdown-body"><div lang="zh" class="icms-help-docs-content"> <main id="concept-2047800"><p id="shortdesc-y6p-ooi-kpv" data-tag="shortdesc" class="shortdesc">由于运营商网络原因，会导致您拉取<span class="help-letter-space"></span>Docker Hub<span class="help-letter-space"></span>镜像变慢，甚至下载失败。为此，阿里云容器镜像服务<span class="help-letter-space"></span>ACR<span class="help-letter-space"></span>提供了官方的镜像加速器，从而加速官方镜像的下载。</p><div data-tag="conbody" id="conbody-rmn-7ir-1dt" class="conbody"><section data-tag="section" id="section-puw-wqe-dy2" data-type="section" class="section"><div id="ddc745301atht" type="important" class="note note-important"><div class="note-icon-wrapper"><i class="icon-note note important"></i></div><div class="noteContentSpan"><strong>重要 </strong><ul id="b4a91bbbb0aaq"><li id="287695590b9u3"><p id="a7f224701ai93">镜像加速器是面向个人开发者的服务，仅限于支持个人开发场景，不允许有再次封装或商业用途。</p></li><li id="d9ae75d3fcice"><p id="ca69158fd4rse">根据<span class="help-letter-space"></span>Docker<span class="help-letter-space"></span>公司政策，2020<span class="help-letter-space"></span>年<span class="help-letter-space"></span>11<span class="help-letter-space"></span>月<span class="help-letter-space"></span>01<span class="help-letter-space"></span>日起将逐步向<span class="help-letter-space"></span>Docker Hub<span class="help-letter-space"></span>匿名和免费用户实施速率和拉取请求次数限制。ACR<span class="help-letter-space"></span>镜像加速器无法保证一定拉取到<span class="help-letter-space"></span>latest<span class="help-letter-space"></span>最新的镜像版本，建议您指定镜像版本拉取。关于<span class="help-letter-space"></span>Docker Hub<span class="help-letter-space"></span>拉取请求次数限制的详细介绍，请参见<span class="help-letter-space"></span><a href="https://docs.docker.com/docker-hub/download-rate-limit/" id="xref-6eg-zj4-dkx" class="" target="_blank">Download rate limit</a>。</p></li><li id="db2da024d55o8"><p id="f2f3e43cccypl">面向生产环境使用场景，为避免<span class="help-letter-space"></span>Docker<span class="help-letter-space"></span>访问网络问题导致的镜像拉取失败，建议您在生产环境中慎重考虑对<span class="help-letter-space"></span>Docker Hub<span class="help-letter-space"></span>容器镜像的依赖。详情请参见<a href="#ae177dafd2kur" id="9536a8f929iyf" title="" class="xref">使用说明</a>。</p></li></ul></div></div></section><section id="76e56d39c4909" class="section"><h2 id="ae177dafd2kur">使用说明</h2><p id="1abd83237dktr">自<span class="help-letter-space"></span>2024<span class="help-letter-space"></span>年<span class="help-letter-space"></span>07<span class="help-letter-space"></span>月<span class="help-letter-space"></span>02<span class="help-letter-space"></span>日起，ACR<span class="help-letter-space"></span>对镜像加速功能的使用范围进行了调整：</p><ul id="b146fd58dfcrf"><li id="48a95728f5sya"><p id="dfa99e61cf1be">仅限阿里云用户在具备公网访问的阿里云产品上使用该镜像加速能力。</p></li><li id="a61546b8b6eut"><p id="49518ce1d43kg">仅支持通过镜像加速器拉取限定范围内的容器镜像。</p></li></ul><h3 id="c03425b300xjv">Docker Hub<span class="help-letter-space"></span>拉取失败<b>解决方案</b></h3><p id="b797581477k00">由于运营商网络等不稳定因素可能导致镜像加速器无法成功拉取到指定版本的容器镜像，建议您在生产环境中谨慎使用依赖于<span class="help-letter-space"></span>Docker Hub<span class="help-letter-space"></span>的容器镜像。为了降低因网络问题引起的风险，您可以采取以下措施：</p><ul id="155465a3de2b6"><li data-spm-anchor-id="0.0.0.i8.369e3d33vukwDS" id="6f1605f2ecvfc"><p id="c0a3fe2be93pw">使用<a href="https://help.aliyun.com/zh/acr/user-guide/subscribe-to-image-tags" id="b5945ffb22q13" title="" class="xref">订阅海外源镜像</a>功能：将<span class="help-letter-space"></span>Docker Hub<span class="help-letter-space"></span>等海外镜像仓库中的镜像同步到企业版实例中。</p></li><li data-spm-anchor-id="0.0.0.i9.369e3d33vukwDS" id="9edc99371f4ez"><p id="c959dd0607069"><a href="https://help.aliyun.com/zh/ack/ack-managed-and-ack-dedicated/user-guide/cross-domain-accelerated-pulling-container-images" id="0675b0f0011yw" title="" class="xref">跨域加速拉取容器镜像</a>：通过配置<span class="help-letter-space"></span>GA<span class="help-letter-space"></span>实例，实现网络加速，并跨域访问待拉取的海外镜像仓库。</p></li><li id="9630c14f25nh3"><p uuid="lxcno9q4xxofss5av4" id="b795881816rh5">使用官方支持的基础镜像：建议使用阿里云<a href="https://help.aliyun.com/zh/acr/user-guide/artifact-center" id="3ad67bd81bufr" title="" class="xref">制品中心</a>提供的官方支持的容器基础镜像，以确保稳定性和安全性。</p></li></ul></section><section data-tag="section" id="section-9tt-j3m-d2f" data-type="section" class="section"><h2 data-tag="title" id="title-txz-efu-kre" class="title">步骤一：获取镜像加速器地址</h2><p data-tag="p" id="p-c43-tjz-h8c" class="p">ACR<span class="help-letter-space"></span>会为每一个账号（阿里云账号或<span class="help-letter-space"></span>RAM<span class="help-letter-space"></span>用户）生成一个镜像加速器地址，配置镜像加速器前，您需要获取镜像加速器地址。</p><ol id="90f388daf27a3"><li id="f8d981fba72f7"><p data-tag="p" id="p-ovs-krs-im1" class="p">登录<a href="https://cr.console.aliyun.com" id="xref-70x-g3p-72z" class="" target="_blank">容器镜像服务控制台</a>。</p></li><li id="bd0e690cbccfm"><p id="f4143ca079lyc">在左侧导航栏选择<span data-tag="menucascade" id="menucascade-dmd-zap-kyy" class="menucascade"><b data-tag="uicontrol" id="uicontrol-ag0-0tc-ufy" class="uicontrol">镜像工具</b> > <b data-tag="uicontrol" id="uicontrol-lot-vm5-f2w" class="uicontrol">镜像加速器</b></span></p></li><li id="e0485d8f765p0"><p id="eef13bee72kz0">在<b data-tag="uicontrol" id="uicontrol-pvg-zkg-q57" class="uicontrol">镜像加速器</b>页面获取<b data-tag="uicontrol" id="328d3c501aoyd" class="uicontrol">加速器地址</b>。</p></li></ol></section><h2 id="e5fb051535p20"><b>步骤二：配置镜像</b>加速器</h2><p id="77341589a1vxq">Docker<span class="help-letter-space"></span>和<span class="help-letter-space"></span>Containerd<span class="help-letter-space"></span>的镜像加速器配置方法有所不同。您可以根据具体情况选择合适的配置方式。关于<span class="help-letter-space"></span>Docker Hub<span class="help-letter-space"></span>镜像仓库拉取失败请参见<span class="help-letter-space"></span><a href="#c03425b300xjv" id="5f6a5c4d017fi" title="" class="xref">Docker Hub<span class="help-letter-space"></span>拉取失败解决方案</a>。</p><section id="b240b2162egpp" data-tag="tabbed-content-box" outputclass="tabbed-content-box" class="tabbed-content-box section"><section id="3f3899f8da4mz" class="section"><h2 data-tag="title" id="df2f013a1ez0f" class="title">配置<span class="help-letter-space"></span>Docker<span class="help-letter-space"></span>运行时镜像加速器</h2><p id="2156c8d9aby9p">您可以先使用<code data-tag="code" code-type="xCode" class="code">docker --version</code>查看<span class="help-letter-space"></span>Docker<span class="help-letter-space"></span>的版本，然后根据实际情况选择不同的配置方式。</p><h3 id="64fd8449aczcq"><b data-tag="uicontrol" id="uicontrol-hat-53v-r9d" class="uicontrol">新版本<span class="help-letter-space"></span>Docker（1.10<span class="help-letter-space"></span>及以上）</b></h3><p id="5bc0e1966f669">创建并编辑<code data-tag="code" class="code blog-code" data-spm-anchor-id="0.0.0.i22.369e3d33lBx01r" code-type="xCode">/etc/docker/daemon.json</code>文件（如果文件不存在，则创建）：</p><pre data-tag="codeblock" id="721cdb648ddhe" outputclass="language-json" code-type="xCode" class="pre codeblock language-json"><code>{ "registry-mirrors": ["<镜像加速器地址>"] } </code></pre><p data-tag="p" id="50314451e7n8l" class="p">然后重启<span class="help-letter-space"></span>Docker Daemon。</p><h3 data-tag="p" id="6360c44327amz" outputclass="h3" class="p h3"><b data-tag="uicontrol" id="uicontrol-2cx-ub2-8d0" class="uicontrol">旧版本<span class="help-letter-space"></span>Docker</b></h3><p data-tag="p" id="6b22e88e84t36" class="p">您需要根据不同的操作系统修改对应的配置文件。</p><ul data-tag="ul" id="76ece15d023gy" class="ul"><li data-tag="li" id="9174612725d3u" class="li"><p id="f345f08b08ous">Ubuntu 12.04 - 14.04 </p><p data-tag="p" id="e7bf0e3943dpx" class="p">Ubuntu<span class="help-letter-space"></span>的配置文件的位置在<span data-tag="filepath" id="filepath-9df-tm6-loi" class="filepath">/etc/default/docker</span><span class="help-letter-space"></span>目录下。您只需要在这个配置文件中添加加速器的配置项，重启<span class="help-letter-space"></span>Docker<span class="help-letter-space"></span>即可。</p><pre data-tag="codeblock" id="acecc46de2t96" outputclass="language-shell" code-type="xCode" class="pre codeblock language-shell"><code>echo "DOCKER_OPTS=\"\$DOCKER_OPTS --registry-mirror=<your accelerate address>\"" | sudo tee -a /etc/default/docker sudo service docker restart </code></pre></li><li data-tag="li" id="03ae4ba8c6p7o" class="li"><p id="2bc58f69976gi">Ubuntu 15.04 - 15.10 </p><p data-tag="p" id="78a1945272tby" class="p">Ubuntu<span class="help-letter-space"></span>的配置文件的位置在<span data-tag="filepath" id="filepath-b8w-5oo-ii0" class="filepath">/etc/systemd/system/docker.service.d/</span>目录下。在这个目录下创建任意的<span data-tag="filepath" id="filepath-ge8-lak-f71" class="filepath">*.conf</span><span class="help-letter-space"></span>文件即可作为配置文件。然后在这个配置文件中添加加速器的配置项，之后重启<span class="help-letter-space"></span>Docker<span class="help-letter-space"></span>即可。</p><pre data-tag="codeblock" id="bbfce2a168lv8" outputclass="language-shell" code-type="xCode" class="pre codeblock language-shell"><code>sudo mkdir -p /etc/systemd/system/docker.service.d sudo tee /etc/systemd/system/docker.service.d/mirror.conf <<-'EOF' [Service] ExecStart= ExecStart=/usr/bin/docker daemon -H fd:// --registry-mirror=<your accelerate address> EOF sudo systemctl daemon-reload sudo systemctl restart docker </code></pre></li><li data-tag="li" id="fed2b09eefcr8" class="li"><p id="5d282372d1qel">CentOS 7 </p><p data-tag="p" id="053ce9fd512zg" class="p">CentOS<span class="help-letter-space"></span>的配置方式略微复杂，需要先将默认的配置文件（<span data-tag="filepath" id="filepath-0xr-6zg-xe4" class="filepath">/lib/systemd/system/docker.service</span>）复制到<span data-tag="filepath" id="filepath-z86-uhf-ngk" class="filepath">/etc/systemd/system/docker.service</span>。然后再将加速器地址添加到配置文件的启动命令中，之后重启<span class="help-letter-space"></span>Docker<span class="help-letter-space"></span>即可。</p><pre data-tag="codeblock" id="57cb6cffcaf00" outputclass="language-shell" code-type="xCode" class="pre codeblock language-shell"><code>sudo cp -n /lib/systemd/system/docker.service /etc/systemd/system/docker.service sudo sed -i "s|ExecStart=/usr/bin/docker daemon|ExecStart=/usr/bin/docker daemon --registry-mirror=<your accelerate address>|g" /etc/systemd/system/docker.service sudo sed -i "s|ExecStart=/usr/bin/dockerd|ExecStart=/usr/bin/dockerd --registry-mirror=<your accelerate address>|g" /etc/systemd/system/docker.service sudo systemctl daemon-reload sudo service docker restart </code></pre></li><li data-tag="li" id="ead3c266f7n05" class="li"><p id="729a66a6d18l9">Redhat 7 </p><p data-tag="p" id="469cf69defk6c" class="p">Red Hat 7<span class="help-letter-space"></span>配置加速器，需要编辑<span data-tag="filepath" id="filepath-y7g-l1k-mkj" class="filepath">/etc/sysconfig/docker</span><span class="help-letter-space"></span>配置文件。在<span data-tag="ph" id="7a4c91bf96dbp" class="ph"><code data-tag="code" code-type="xCode" class="code">OPTIONS</code></span>配置项中添加加速器配置<span data-tag="ph" id="9c78d6d7794gn" class="ph"><code data-tag="code" code-type="xCode" class="code">--registry-mirror=<your accelerate address></code></span>。最后执行<span data-tag="ph" id="06829f6af8y3l" class="ph"><code data-tag="code" code-type="xCode" class="code">sudo service docker restart</code></span>命令以重启<span class="help-letter-space"></span>Docker Daemon。</p></li><li data-tag="li" id="91a663f292bhn" class="li"><p id="cd54651669xsc">Redhat 6/CentOS 6 </p><p data-tag="p" id="cea574942e300" class="p">在这两个系统上无法直接安装<span class="help-letter-space"></span>Docker，需要升级内核。</p><p data-tag="p" id="7d30c627cbhgh" class="p">配置加速器时需要编辑<span data-tag="filepath" id="filepath-ooz-c1c-r07" class="filepath">/etc/sysconfig/docker</span><span class="help-letter-space"></span>配置文件。在<span data-tag="ph" id="087cd946c143w" class="ph"><code data-tag="code" code-type="xCode" class="code">other_args</code></span>配置项中添加加速器配置<span data-tag="ph" id="8c719a41bf2on" class="ph"><code data-tag="code" code-type="xCode" class="code">--registry-mirror=<your accelerate address></code></span>。最后执行<span data-tag="ph" id="c40eb20fa3c5l" class="ph"><code data-tag="code" code-type="xCode" class="code">sudo service docker restart</code></span>命令以重启<span class="help-letter-space"></span>Docker Daemon。</p></li><li data-tag="li" id="8670711d3aw1u" class="li"><p id="aa13f26849vzp">Docker Toolbox （Windows、Mac）</p><p data-tag="p" id="fc673f952dcs2" class="p">在<span class="help-letter-space"></span>Windows、Mac<span class="help-letter-space"></span>系统上使用<span class="help-letter-space"></span>Docker Toolbox<span class="help-letter-space"></span>的话，推荐做法是在创建<span class="help-letter-space"></span>Linux<span class="help-letter-space"></span>虚拟机的时候，就将加速器的地址配置进去。</p><pre data-tag="codeblock" id="ae81f7bbd6ww3" outputclass="language-shell" code-type="xCode" class="pre codeblock language-shell"><code>docker-machine create --engine-registry-mirror=<your accelerate address> -d virtualbox default docker-machine env default eval "$(docker-machine env default)" docker info </code></pre><p data-tag="p" id="fc24ed8f85yju" class="p">如果您已经通过<span class="help-letter-space"></span>docker-machine<span class="help-letter-space"></span>创建了虚拟机的话，则需要通过登录该虚拟机来修改配置。</p><ol data-tag="ol" id="8fb9f10b200u5" class="ol"><li data-tag="li" id="a0deb1c37fyi7" class="li"><p id="13dc0b78591wk">执行<span data-tag="ph" id="2ba08339b432z" class="ph"><code data-tag="code" code-type="xCode" class="code">docker-machine ssh <machine-name></code></span>命令以登录虚拟机。</p></li><li data-tag="li" id="36e99f151dg05" class="li"><p id="02c5ecb690o8c">修改<span data-tag="filepath" id="filepath-h2g-xzr-jo9" class="filepath">/var/lib/boot2docker/profile</span><span class="help-letter-space"></span>文件，将<span data-tag="ph" id="6e09296cbdy0z" class="ph"><code data-tag="code" code-type="xCode" class="code">--registry-mirror=<your accelerate address></code></span>添加到<span data-tag="ph" id="0555439c96899" class="ph"><code data-tag="code" code-type="xCode" class="code">EXTRA_ARGS</code></span>中。</p></li><li data-tag="li" id="a2ada7cc03pio" class="li"><p id="73d5cb1180vik">执行<span data-tag="ph" id="e1078d6917yxb" class="ph"><code data-tag="code" code-type="xCode" class="code">sudo /etc/init.d/docker restart</code></span>命令以重启<span class="help-letter-space"></span>Docker<span class="help-letter-space"></span>服务。</p></li></ol></li></ul></section><section id="645741d7b6sia" class="section"><h2 data-tag="title" id="4766fe99e4g5f" class="title">配置<span class="help-letter-space"></span>Containerd<span class="help-letter-space"></span>运行时镜像加速器</h2><p id="c02768d5e3nha">Containerd<span class="help-letter-space"></span>在启动时指定默认的配置文件路径为<code data-tag="code" class="code blog-code" code-type="xCode">/etc/containerd/config.toml</code>，后续所有镜像仓库相关的配置可以在该文件中进行热加载，无需重启<span class="help-letter-space"></span>Containerd。如果您使用不同的路径，可以根据实际情况进行调整。</p><ol data-tag="ol" id="ol-34h-sly-2mo" class="ol"><li data-tag="li" id="li-wkg-q04-a2z" class="li"><p id="e7842cdd1elfq">确保配置文件包含<code data-tag="code" class="code blog-code" data-spm-anchor-id="0.0.0.i44.369e3d33noKCLh" code-type="xCode">config_path</code>。</p><p id="398d74db57n0n">执行以下命令，确认默认配置文件中是否存在<code data-tag="code" class="code blog-code" code-type="xCode">config_path </code>配置（例如<code data-tag="code" class="code blog-code" code-type="xCode">"/etc/containerd/cert.d"</code>）。</p><pre code-type="xCode" id="509a4991ackw6" data-tag="codeblock" outputclass="language-bash" class="pre codeblock language-bash"><code>cat /etc/containerd/config.toml |grep config_path -C 5</code></pre><p id="bc8088f170ldc">如果不存在，您可以在默认配置文件中添加以下配置。</p><div type="note" id="c737660d06216" class="note note-note"><div class="note-icon-wrapper"><i class="icon-note note note"></i></div><div class="noteContentSpan"><strong>说明 </strong><p id="58bf7c6446yih">若已有<span data-tag="ph" id="3d97884e75a7r" class="ph"><code data-tag="code" code-type="xCode" class="code">[plugins."io.containerd.grpc.v1.cri".registry]</code></span>，则在下面只需添加<code data-tag="code" code-type="xCode" class="code">config_path</code>，注意缩进。若没有，则可以在任意地方写入。</p></div></div><pre code-type="xCode" id="fbab4e761bncs" data-tag="codeblock" outputclass="language-json" class="pre codeblock language-json"><code> [plugins."io.containerd.grpc.v1.cri".registry] config_path = "/etc/containerd/certs.d"</code></pre></li><li id="198659b34115a"><p id="f3add5850azv8">检查<code data-tag="code" class="code blog-code" code-type="xCode">mirror</code>相关配置。</p><p id="6ee95e5093aad">检查<code data-tag="code" class="code blog-code" code-type="xCode">/etc/containerd/config.toml</code>配置文件中是否存在与<code data-tag="code" code-type="xCode" class="code">mirror</code>相关的配置。如果已存在，请进行清理，以避免冲突。</p><pre code-type="xCode" id="c8d4f154c9sel" data-tag="codeblock" outputclass="language-json" class="pre codeblock language-json"><code>[plugins."io.containerd.grpc.v1.cri".registry.mirrors] [plugins."io.containerd.grpc.v1.cri".registry.mirrors."docker.io"] endpoint = ["https://registry-1.docker.io"]</code></pre></li><li id="9565322bfeoqt"><p id="661cc352de6go">重启<code data-tag="code" class="code blog-code" code-type="xCode">containerd</code>（可选）。</p><p id="5de0eaf764bwp">如果默认配置文件发生更改，则可执行以下命令，重启<span class="help-letter-space"></span>Containerd。</p><pre code-type="xCode" id="d2a167c50csxi" data-tag="codeblock" outputclass="language-bash" class="pre codeblock language-bash"><code>systemctl restart containerd</code></pre><p id="10549d3ce7ubx">若启动失败，执行以下命令。检查失败原因，通常是配置文件仍有冲突导致，您可以依据报错做相应调整。</p><pre code-type="xCode" id="e630e5adf03yo" data-tag="codeblock" outputclass="language-bash" class="pre codeblock language-bash"><code>journalctl -u containerd</code></pre></li><li data-tag="li" id="ce64c5b3c4cbm" class="li"><p id="4043c5860e6a8">创建镜像加速器配置文件。</p><p id="e58996b7edosu">使用以下内容在指定的<span class="help-letter-space"></span><span data-tag="parmname" id="113c0f0a9exir" class="parmname">config_path</span><span class="help-letter-space"></span>路径下创建<span class="help-letter-space"></span><span data-tag="filepath" id="a5f9084973dx2" class="filepath">docker.io/hosts.toml</span><span class="help-letter-space"></span>文件，创建后的文件路径为<code data-tag="code" code-type="xCode" class="code">/etc/containerd/certs.d/docker.io/hosts.toml</code>。</p><pre code-type="xCode" id="e7f0fc9584o7l" data-tag="codeblock" outputclass="language-bash" class="pre codeblock language-bash"><code>server = "https://registry-1.docker.io" [host."$(镜像加速器地址，如<span class="help-letter-space"></span>https://xxx.mirror.aliyuncs.com)"] capabilities = ["pull", "resolve", "push"]</code></pre></li><li data-tag="li" id="3c7b2b48822fw" class="li"><p id="3be19effdafvm">拉取<span class="help-letter-space"></span>Docker<span class="help-letter-space"></span>镜像验证加速是否生效。如未生效，请参见<span class="help-letter-space"></span><a href="https://github.com/containerd/containerd/blob/main/docs/hosts.md" id="61c7b3d802ucu" class="" target="_blank">Reference</a>。</p></li></ol></section></section></div></main> </div></div><div class="aliyun-docs-pagination"><div class="NextPage--container--cfVcdEE"><span class="NextPage--paginationLeft--WTOmehr"><a href="/zh/acr/user-guide/image-tool/" data-spm-click="gostr=/aliyun;locaid=preDoc"><i class="iconfont icon-prev-arrow"></i>上一篇：镜像工具</a></span><span class="NextPage--paginationRight--TgS6P1r"><a href="/zh/acr/user-guide/container-registry-personal-instance-edition-documentations/" data-spm-click="gostr=/aliyun;locaid=nextDoc">下一篇：个人版文档集<i class="iconfont icon-next-arrow"></i></a></span></div></div></div><div class="RecommendDoc--container--IhRK6Om"></div><div class="FeedbackButton--feedbackContainer--v2ywOOX aliyun-docs-feedback" id="help-doc-feedback"><div class="FeedbackButton--feedbackHelpTip--BFRvMbx">该文章对您有帮助吗？</div><div class="FeedbackButton--feedbackButtonContainer--MHnR42I"><div class="FeedbackButton--feedbackButtonBox--KiH2lHU"><button class="FeedbackButton--iconButton--v243wMx"><i class="help-iconfont help-icon-tag-empty"></i></button><button class="FeedbackButton--iconButton--v243wMx"><i class="help-iconfont help-icon-tag-empty" style="display:inline-block;transform:rotateX(-180deg)"></i></button><button class="FeedbackButton--clickButton--ZUiZLGR"><i class="help-iconfont help-icon-bianji"></i>反馈</button></div></div></div></section><div class="aliyun-docs-side" id="aliyun-docs-side"><div id="aliyun-docs-side-content" class="aliyun-docs-side-content ProductDetail--rightBox--GGLE5sH"><ul class="Outline--synopsisBox--xky1vdf"></ul></div><div id="aliyun-docs-side-blank" class="aliyun-docs-side-blank"></div></div></div></main></div></div><div id="aliyun-docs-selection-div"></div></div></div> <footer><div id="4fded5b74ca8bdca639ea3295ee6c89a"><div class="_18a32969382a277c44015217fbc5cb5a_box"><footer class="_49ada0cd752f65901c49f2eed0d6c3d5_container" aria-label="PC 端页尾"><div class="_49ada0cd752f65901c49f2eed0d6c3d5_inner"><div class="b34f022d45e42bd104ce1362bc0808b1_services"><nav class="b34f022d45e42bd104ce1362bc0808b1_homepage-footer-main-services" aria-label="页脚导航"><section class="a52e48969cced2d562e47543eeb73ebb_ali-main-services"><h3 class="a52e48969cced2d562e47543eeb73ebb_ali-main-services-title">为什么选择阿里云</h3><a class="a52e48969cced2d562e47543eeb73ebb_ali-main-services-link" href="https://www.aliyun.com/about/what-is-cloud-computing" target="_blank">什么是云计算</a><a class="a52e48969cced2d562e47543eeb73ebb_ali-main-services-link" href="https://infrastructure.aliyun.com/" target="_blank">全球基础设施</a><a class="a52e48969cced2d562e47543eeb73ebb_ali-main-services-link" href="https://www.aliyun.com/why-us/leading-technology" target="_blank">技术领先</a><a class="a52e48969cced2d562e47543eeb73ebb_ali-main-services-link" href="https://www.aliyun.com/why-us/reliability" target="_blank">稳定可靠</a><a class="a52e48969cced2d562e47543eeb73ebb_ali-main-services-link" href="https://www.aliyun.com/why-us/security-compliance" target="_blank">安全合规</a><a class="a52e48969cced2d562e47543eeb73ebb_ali-main-services-link" href="https://www.aliyun.com/analyst-reports" target="_blank">分析师报告</a></section><section class="a52e48969cced2d562e47543eeb73ebb_ali-main-services"><h3 class="a52e48969cced2d562e47543eeb73ebb_ali-main-services-title">产品和定价</h3><a class="a52e48969cced2d562e47543eeb73ebb_ali-main-services-link" href="https://www.aliyun.com/product/list" target="_blank">全部产品</a><a class="a52e48969cced2d562e47543eeb73ebb_ali-main-services-link" href="https://free.aliyun.com/" target="_blank">免费试用</a><a class="a52e48969cced2d562e47543eeb73ebb_ali-main-services-link" href="https://www.aliyun.com/product/news/" target="_blank">产品动态</a><a class="a52e48969cced2d562e47543eeb73ebb_ali-main-services-link" href="https://www.aliyun.com/price/strategy" target="_blank">产品定价</a><a class="a52e48969cced2d562e47543eeb73ebb_ali-main-services-link" href="https://www.aliyun.com/price/product" target="_blank">价格计算器</a><a class="a52e48969cced2d562e47543eeb73ebb_ali-main-services-link" href="https://www.aliyun.com/price/cost-management" target="_blank">云上成本管理</a></section><section class="a52e48969cced2d562e47543eeb73ebb_ali-main-services"><h3 class="a52e48969cced2d562e47543eeb73ebb_ali-main-services-title">解决方案</h3><a class="a52e48969cced2d562e47543eeb73ebb_ali-main-services-link" href="https://www.aliyun.com/solution/tech-solution" target="_blank">技术解决方案</a></section><section class="a52e48969cced2d562e47543eeb73ebb_ali-main-services"><h3 class="a52e48969cced2d562e47543eeb73ebb_ali-main-services-title">文档与社区</h3><a class="a52e48969cced2d562e47543eeb73ebb_ali-main-services-link" href="https://help.aliyun.com/" target="_blank">文档</a><a class="a52e48969cced2d562e47543eeb73ebb_ali-main-services-link" href="https://developer.aliyun.com/" target="_blank">开发者社区</a><a class="a52e48969cced2d562e47543eeb73ebb_ali-main-services-link" href="https://tianchi.aliyun.com/" target="_blank">天池大赛</a><a class="a52e48969cced2d562e47543eeb73ebb_ali-main-services-link" href="https://edu.aliyun.com/" target="_blank">培训与认证</a></section><section class="a52e48969cced2d562e47543eeb73ebb_ali-main-services"><h3 class="a52e48969cced2d562e47543eeb73ebb_ali-main-services-title">权益中心</h3><a class="a52e48969cced2d562e47543eeb73ebb_ali-main-services-link" href="https://free.aliyun.com/" target="_blank">免费试用</a><a class="a52e48969cced2d562e47543eeb73ebb_ali-main-services-link" href="https://university.aliyun.com/" target="_blank">高校计划</a><a class="a52e48969cced2d562e47543eeb73ebb_ali-main-services-link" href="https://startup.aliyun.com/startups" target="_blank">企业扶持计划</a><a class="a52e48969cced2d562e47543eeb73ebb_ali-main-services-link" href="https://dashi.aliyun.com/" target="_blank">推荐返现计划</a></section><section class="a52e48969cced2d562e47543eeb73ebb_ali-main-services"><h3 class="a52e48969cced2d562e47543eeb73ebb_ali-main-services-title">支持与服务</h3><a class="a52e48969cced2d562e47543eeb73ebb_ali-main-services-link" href="https://www.aliyun.com/service" target="_blank">基础服务</a><a class="a52e48969cced2d562e47543eeb73ebb_ali-main-services-link" href="https://www.aliyun.com/service/supportplans" target="_blank">企业增值服务</a><a class="a52e48969cced2d562e47543eeb73ebb_ali-main-services-link" href="https://www.aliyun.com/service/devopsimpl/devopsimpl_cloudmigration_public_cn" target="_blank">迁云服务</a><a class="a52e48969cced2d562e47543eeb73ebb_ali-main-services-link" href="https://www.aliyun.com/notice/" target="_blank">官网公告</a><a class="a52e48969cced2d562e47543eeb73ebb_ali-main-services-link" href="https://status.aliyun.com/" target="_blank">健康看板</a><a class="a52e48969cced2d562e47543eeb73ebb_ali-main-services-link" href="https://security.aliyun.com/trust" target="_blank">信任中心</a></section></nav><article class="_7b44142961778903dda8af3f769cd06c_focus"><h3 class="_7b44142961778903dda8af3f769cd06c_ali-main-services-title">关注阿里云</h3><p class="_7b44142961778903dda8af3f769cd06c_ali-main-services-desc">关注阿里云公众号或下载阿里云APP，关注云资讯，随时随地运维管控云服务</p><img alt="阿里云APP" src="https://img.alicdn.com/tfs/TB1UdKEM6TpK1RjSZKPXXa3UpXa-256-256.png" class="_7b44142961778903dda8af3f769cd06c_ali-official-code" loading="lazy"/><img alt="阿里云微信" src="https://img.alicdn.com/tfs/TB1AOdINW6qK1RjSZFmXXX0PFXa-258-258.jpg" class="_7b44142961778903dda8af3f769cd06c_ali-official-code" loading="lazy"/><p class="_7b44142961778903dda8af3f769cd06c_consult-text">联系我们：4008013260</p></article></div><div class="_598489db2a611d8ef7e69c68d7ea6ce8_about-link-wrap"><a href="https://help.aliyun.com/product/67275.html" class="_598489db2a611d8ef7e69c68d7ea6ce8_ali-about-link" target="_blank">法律声明</a><a href="https://terms.alicdn.com/legal-agreement/terms/platform_service/20220906101446934/20220906101446934.html" class="_598489db2a611d8ef7e69c68d7ea6ce8_ali-about-link" target="_blank">Cookies政策</a><a href="https://aliyun.jubao.alibaba.com/" class="_598489db2a611d8ef7e69c68d7ea6ce8_ali-about-link" target="_blank">廉正举报</a><a href="https://report.aliyun.com/" class="_598489db2a611d8ef7e69c68d7ea6ce8_ali-about-link" target="_blank">安全举报</a><a href="https://www.aliyun.com/contact" class="_598489db2a611d8ef7e69c68d7ea6ce8_ali-about-link" target="_blank">联系我们</a><a href="https://careers.aliyun.com/" class="_598489db2a611d8ef7e69c68d7ea6ce8_ali-about-link" target="_blank">加入我们</a></div><section class="_598489db2a611d8ef7e69c68d7ea6ce8_friend-link-wrap"><h3 hidden="">友情链接</h3><a href="https://www.alibabagroup.com/cn/global/home" class="_598489db2a611d8ef7e69c68d7ea6ce8_ali-friend-link" target="_blank">阿里巴巴集团</a><a href="https://www.taobao.com/" class="_598489db2a611d8ef7e69c68d7ea6ce8_ali-friend-link" target="_blank">淘宝网</a><a href="https://www.tmall.com/" class="_598489db2a611d8ef7e69c68d7ea6ce8_ali-friend-link" target="_blank">天猫</a><a href="https://www.aliexpress.com/" class="_598489db2a611d8ef7e69c68d7ea6ce8_ali-friend-link" target="_blank">全球速卖通</a><a href="https://www.alibaba.com/" class="_598489db2a611d8ef7e69c68d7ea6ce8_ali-friend-link" target="_blank">阿里巴巴国际交易市场</a><a href="https://www.1688.com/" class="_598489db2a611d8ef7e69c68d7ea6ce8_ali-friend-link" target="_blank">1688</a><a href="https://www.alimama.com/index.htm" class="_598489db2a611d8ef7e69c68d7ea6ce8_ali-friend-link" target="_blank">阿里妈妈</a><a href="https://www.fliggy.com/" class="_598489db2a611d8ef7e69c68d7ea6ce8_ali-friend-link" target="_blank">飞猪</a><a href="https://www.aliyun.com/" class="_598489db2a611d8ef7e69c68d7ea6ce8_ali-friend-link" target="_blank">阿里云计算</a><a href="https://www.alios.cn/" class="_598489db2a611d8ef7e69c68d7ea6ce8_ali-friend-link" target="_blank">AliOS</a><a href="https://wanwang.aliyun.com/" class="_598489db2a611d8ef7e69c68d7ea6ce8_ali-friend-link" target="_blank">万网</a><a href="https://mobile.amap.com/" class="_598489db2a611d8ef7e69c68d7ea6ce8_ali-friend-link" target="_blank">高德</a><a href="https://www.uc.cn/" class="_598489db2a611d8ef7e69c68d7ea6ce8_ali-friend-link" target="_blank">UC</a><a href="https://www.umeng.com/" class="_598489db2a611d8ef7e69c68d7ea6ce8_ali-friend-link" target="_blank">友盟</a><a href="https://www.youku.com/" class="_598489db2a611d8ef7e69c68d7ea6ce8_ali-friend-link" target="_blank">优酷</a><a href="https://www.dingtalk.com/" class="_598489db2a611d8ef7e69c68d7ea6ce8_ali-friend-link" target="_blank">钉钉</a><a href="https://www.alipay.com/" class="_598489db2a611d8ef7e69c68d7ea6ce8_ali-friend-link" target="_blank">支付宝</a><a href="https://damo.alibaba.com/" class="_598489db2a611d8ef7e69c68d7ea6ce8_ali-friend-link" target="_blank">达摩院</a><a href="https://world.taobao.com/" class="_598489db2a611d8ef7e69c68d7ea6ce8_ali-friend-link" target="_blank">淘宝海外</a><a href="https://www.aliyundrive.com/" class="_598489db2a611d8ef7e69c68d7ea6ce8_ali-friend-link" target="_blank">阿里云盘</a><a href="https://www.ele.me/" class="_598489db2a611d8ef7e69c68d7ea6ce8_ali-friend-link" target="_blank">饿了么</a></section><p class="_598489db2a611d8ef7e69c68d7ea6ce8_ali-copyright-text">© 2009-2025 Aliyun.com 版权所有增值电信业务经营许可证： <a href="http://beian.miit.gov.cn/" target="_blank">浙B2-20080101</a> 域名注册服务机构许可： <a href="https://domain.miit.gov.cn/域名注册服务机构/互联网域名/阿里云计算有限公司 " target="_blank">浙D3-20210002</a></p><p class="_598489db2a611d8ef7e69c68d7ea6ce8_ali-report-wrap"><a href="https://zzlz.gsxt.gov.cn/businessCheck/verifKey.do?showType=p&serial=91330106673959654P-SAIC_SHOW_10000091330106673959654P1710919400712&signData=MEUCIQDEkCd8cK7%2Fyqe6BNMWvoMPtAnsgKa7FZetfPkjZMsvhAIgOX1G9YC6FKyndE7o7hL0KaBVn4f%20V%2Fiof3iAgpsV09o%3D" target="_blank" class="_598489db2a611d8ef7e69c68d7ea6ce8_ali-report-link"><img src="//gw.alicdn.com/tfs/TB1GxwdSXXXXXa.aXXXXXXXXXXX-65-70.gif" class="_598489db2a611d8ef7e69c68d7ea6ce8_ali-report-img" alt="" loading="lazy"/></a><a href="http://www.beian.gov.cn/portal/registerSystemInfo" target="_blank" class="_598489db2a611d8ef7e69c68d7ea6ce8_ali-report-link"><img src="//img.alicdn.com/tfs/TB1..50QpXXXXX7XpXXXXXXXXXX-40-40.png" class="_598489db2a611d8ef7e69c68d7ea6ce8_ali-report-img" alt="浙公网安备 33010602009975号" loading="lazy"/><span class="_598489db2a611d8ef7e69c68d7ea6ce8_ali-report-link-text">浙公网安备 33010602009975号</span></a><a href="https://beian.miit.gov.cn/" target="_blank" class="_598489db2a611d8ef7e69c68d7ea6ce8_ali-report-link"><span class="_598489db2a611d8ef7e69c68d7ea6ce8_ali-report-link-text _598489db2a611d8ef7e69c68d7ea6ce8_ali-report-link-text-unique">浙B2-20080101-4</span></a></p></div></footer><footer class="_4b41e3343c851a7a8833c9165b249eb2_container" aria-label="移动端页尾"></footer></div></div></footer> <script> // 白屏时间埋点 window.firstPaint = Date.now(); const ssrFistPaintTime = firstPaint-performance.timing.navigationStart; var ssrTime = { product: 'help.aliyun.com', // 站点 ua: navigator.userAgent, // ua device: 'pc', // 设备 page: 'documentDetail', // 页面 lang: 'zh', //站点语言 cna: '', // 用户标识 url: window.location.href, action: 'ssrFirstPaint', userParams1: ssrFistPaintTime, userParams2: window.firstPaint, userParams3: performance.timing.navigationStart }; let queryStr = Object.keys(ssrTime).map(key => ssrTime[key] && `${encodeURIComponent(key)}=${encodeURIComponent(ssrTime[key])}`).join('&'); fetch('https://help-new.cn-wulanchabu.log.aliyuncs.com/logstores/web-tracking/track?APIVersion=0.6.0&' + queryStr); document.addEventListener("DOMContentLoaded", function(event) { // pcp上报 window.ALIYUN_PERF && window.ALIYUN_PERF.report(); window.ALIYUN_PERF && window.ALIYUN_PERF.getPCP().then(rst => { // pcp埋点 var data = { product: 'help.aliyun.com', // 站点 ua: navigator.userAgent, // ua device: 'pc', // 设备 page: 'index', // 页面 lang: 'zh', //站点语言 cna: '', // 用户标识 url: window.location.href, action: 'pcp', userParams1: rst || 0, }; let queryStr = Object.keys(data).map(key => data[key] && `${encodeURIComponent(key)}=${encodeURIComponent(data[key])}`).join('&'); fetch('https://help-new.cn-wulanchabu.log.aliyuncs.com/logstores/web-tracking/track?APIVersion=0.6.0&' + queryStr); }); }); </script> <script crossorigin="" src="https://g.alicdn.com/code/lib/??react/16.8.6/umd/react.production.min.js,react-dom/16.8.6/umd/react-dom.production.min.js"></script> <script src="https://g.alicdn.com/code/lib/lodash.js/4.17.21/lodash.min.js" crossorigin="anonymous"></script> <script> window.resourceBaseUrl="https://g.alicdn.com/aliyun-help/help-portal-fe/0.10.5/" </script> <script defer="" src="https://g.alicdn.com/aliyun-help/help-portal-fe/0.10.5/js/index.js"></script> <script defer src="https://g.alicdn.com/aliyun-help/help-portal-fe/0.10.5/js/vendor.js"></script> <script async="" src="https://g.alicdn.com/dawn/assets-loader/scripts/fast-login.js?tenantName=help-new-aliyun-com"></script> <script defer="" src="https://cloud-assets.alicdn.com/website.js"></script> <script async="" src="https://g.alicdn.com/aliyun/perf/js/index.js"></script> <script src="https://g.alicdn.com/code/npm/@ali/??biu-loader/0.1.2/index.js,hmod-preact/0.0.1/index.js,hmod-preact-hooks/0.0.1/index.js,hmod-preact-compat/0.0.1/index.js,hmod-preact-bridge/0.1.1/index.js,hmod-ace-service-loader/0.1.1/index.js"></script> <script src="https://g.alicdn.com/aliyun-com/lowcode-engine/0.1.14/renderer/build/js/index.js"></script> <script src="https://g.alicdn.com/code/npm/@ali??hmod-ace-2023-box/0.1.0/index.js,hmod-aliyun-com-floating-toolbar/0.2.4/index.js,hmod-aliyun-com-global-nav-search/0.6.5/index.js,hmod-aliyun-com-global-nav/0.2.20/index.js"></script> <script src="https://cloud-assets.alicdn.com/lowcode/entry/prod/aa49b28e70b6bd34838e39b241a7a68f.js"></script> <script src="https://g.alicdn.com/code/npm/@ali??hmod-ace-2023-box/0.1.0/index.js,hmod-ace-2024-global-footer/0.1.1/index.js,hmod-lowcode-normal-page/0.1.0/index.js"></script> <script src="https://cloud-assets.alicdn.com/lowcode/entry/prod/4fded5b74ca8bdca639ea3295ee6c89a.js"></script> <script src="https://cloud-assets.alicdn.com/website.js"></script> </body></html>