跳转至

其它工具

Docker 安装与换源脚本#

bash <(curl -sSL https://linuxmirrors.cn/docker.sh)

bash <(curl -sSL https://raw.githubusercontent.com/SuperManito/LinuxMirrors/main/DockerInstallation.sh)

bash <(curl -sSL https://gitee.com/SuperManito/LinuxMirrors/raw/main/DockerInstallation.sh)

实时同步、无延迟，国内网络环境下推荐使用

bash <(curl -sSL https://raw.gitcode.com/gh_mirrors/li/LinuxMirrors/raw/main/DockerInstallation.sh)

本项目已加入 GitHub 加速计划，同步存在1小时延迟

bash <(curl -sSL https://cdn.jsdelivr.net/gh/SuperManito/LinuxMirrors@main/DockerInstallation.sh)

bash <(curl -sSL https://edgeone.linuxmirrors.cn/docker.sh)

不支持在国内网络环境下使用

集成安装 Docker Engine 和 Docker Compose，支持选择或更换软件源以及镜像仓库、安装指定版本、重装等功能，支持 ARM 架构

脚本参考官方文档使用系统包管理工具进行安装，不存在兼容性、安全性等问题，可安装的版本由 Docker CE 仓库决定

bash <(curl -sSL https://linuxmirrors.cn/docker.sh) --only-registry

bash <(curl -sSL https://raw.githubusercontent.com/SuperManito/LinuxMirrors/main/DockerInstallation.sh) --only-registry

bash <(curl -sSL https://gitee.com/SuperManito/LinuxMirrors/raw/main/DockerInstallation.sh) --only-registry

实时同步、无延迟，国内网络环境下推荐使用

bash <(curl -sSL https://raw.gitcode.com/gh_mirrors/li/LinuxMirrors/raw/main/DockerInstallation.sh) --only-registry

本项目已加入 GitHub 加速计划，同步存在1小时延迟

bash <(curl -sSL https://cdn.jsdelivr.net/gh/SuperManito/LinuxMirrors@main/DockerInstallation.sh) --only-registry

bash <(curl -sSL https://edgeone.linuxmirrors.cn/docker.sh) --only-registry

不支持在国内网络环境下使用

  • 可完全替代官方安装脚本

    与 get.docker.com 逻辑一致，融合了本项目换源架构以及特性

  • 已被众多流行项目使用

    经过数年的技术沉淀与生产验证，广受社区好评，深得开发者喜爱

Docker Compose 不再需要独立安装

Docker Compose 自 V2 版本起开始作为 Docker CLI（命令行）的一部分，脚本默认集成安装该插件，请使用 docker compose 命令替代 docker-compose

软件源说明

  • Docker CE 软件仓库

    Docker CE 全称 Docker Community Edition（Docker 社区版），是 Docker Engine 的别称，该仓库用于下载并安装 Docker 相关软件包

  • Docker Registry 镜像仓库

    用于控制拉取镜像的默认来源存储仓库，又称镜像加速器，默认为官方容器镜像仓库 Docker Hub

由于一些不可抗力的因素，目前国内网络环境一般无法正常访问 Docker Hub 因此无法拉取镜像，建议使用下方提到的国内可用镜像仓库源

注：脚本内的指定 WEB 协议交互仅用于控制 Docker CE 软件源，Docker Registry 强制使用 HTTPS 协议

内置的镜像仓库源

国内可用

站点名称 地址 说明
毫秒镜像 docker.1ms.run 企业镜像站，CDN智能分发速度极快，支持付费定制，推荐使用
Docker Proxy dockerproxy.net 由 ghproxy 创建，可用性高但速度很慢，支持企业镜像付费加速
DaoCloud 道客 docker.m.daocloud.io 老牌企业镜像站，可用性高且速度快，现为白名单模式
1Panel 镜像 docker.1panel.live 企业产品自用镜像

本开源项目不适合采集个人自建的镜像加速器，如有需要可搭配命令选项自行使用

其它

站点名称 地址 站点名称 地址
阿里云（杭州） registry.cn-hangzhou.aliyuncs.com 阿里云（日本-东京） registry.ap-northeast-1.aliyuncs.com
阿里云（上海） registry.cn-shanghai.aliyuncs.com 阿里云（新加坡） registry.ap-southeast-1.aliyuncs.com
阿里云（青岛） registry.cn-qingdao.aliyuncs.com 阿里云（马来西亚-吉隆坡） registry.ap-southeast-3.aliyuncs.com
阿里云（北京） registry.cn-beijing.aliyuncs.com 阿里云（印度尼西亚-雅加达） registry.ap-southeast-5.aliyuncs.com
阿里云（张家口） registry.cn-zhangjiakou.aliyuncs.com 阿里云（德国-法兰克福） registry.eu-central-1.aliyuncs.com
阿里云（呼和浩特） registry.cn-huhehaote.aliyuncs.com 阿里云（英国-伦敦） registry.eu-west-1.aliyuncs.com
阿里云（乌兰察布） registry.cn-wulanchabu.aliyuncs.com 阿里云（美国西部-硅谷） registry.us-west-1.aliyuncs.com
阿里云（深圳） registry.cn-shenzhen.aliyuncs.com 阿里云（美国东部-弗吉尼亚） registry.us-east-1.aliyuncs.com
阿里云（河源） registry.cn-heyuan.aliyuncs.com 阿里云（阿联酋-迪拜） registry.me-east-1.aliyuncs.com
阿里云（广州） registry.cn-guangzhou.aliyuncs.com 谷歌云（北美） gcr.io
阿里云（成都） registry.cn-chengdu.aliyuncs.com 谷歌云（亚洲） asia.gcr.io
阿里云（香港） registry.cn-hongkong.aliyuncs.com 谷歌云（欧洲） eu.gcr.io
腾讯云 mirror.ccs.tencentyun.com Docker Hub registry.hub.docker.com

注：国内云计算企业的镜像仓库源仅针对其业务，境内实例可能仍无法访问 Docker Hub

  • 命令选项（高级用法）#

    bash <(curl -sSL https://linuxmirrors.cn/docker.sh) --help
    命令选项(名称/含义/值)：

    --source 指定 Docker CE 源地址(域名或IP) 地址
    --source-registry 指定镜像仓库地址(域名或IP) 地址
    --branch 指定 Docker CE 源仓库(路径) 仓库名
    --codename 指定 Debian 系操作系统的版本代号 代号名称
    --designated-version 指定 Docker CE 安装版本 版本号
    --protocol 指定 Docker CE 源的 WEB 协议 http 或 https
    --install-latest 是否安装最新版本的 Docker Engine true 或 false
    --close-firewall 是否关闭防火墙 true 或 false
    --clean-screen 是否在运行前清除屏幕上的所有内容 true 或 false
    --only-registry 仅更换镜像仓库模式 无
    --ignore-backup-tips 忽略覆盖备份提示 无
    --pure-mode 纯净模式，精简打印内容 无

    名称 含义 选项值
    --source 指定 Docker CE 源地址(域名或IP) 地址
    --source-registry 指定镜像仓库地址(域名或IP) 地址
    --branch 指定 Docker CE 源仓库 仓库名（详见下方文档）
    --codename 指定 Debian 系操作系统的版本代号 代号名称
    --designated-version 指定 Docker CE 安装版本 版本号（详见下方文档）
    --protocol 指定 Docker CE 源的 WEB 协议 http 或 https
    --install-latest 是否安装最新版本的 Docker Engine true 或 false
    --close-firewall 是否关闭防火墙 true 或 false
    --clean-screen 是否在运行前清除屏幕上的所有内容 true 或 false
    --only-registry 仅更换镜像仓库模式 无
    --ignore-backup-tips 忽略覆盖备份提示（即不覆盖备份） 无
    --pure-mode 纯净模式，精简打印内容 无

    软件源完整格式 <WEB协议>://<软件源地址(域名或IP)>/<软件源仓库(路径)>

    • 指定 Docker CE 软件源地址#

      bash <(curl -sSL https://linuxmirrors.cn/docker.sh) --source mirror.example.com/docker-ce

      注意该地址路径需要包含镜像站的 Docker CE 软件源仓库路径即 docker-ce

    • 指定镜像仓库地址#

      bash <(curl -sSL https://linuxmirrors.cn/docker.sh) --source-registry registry.example.com

    • 仅更换镜像仓库#

      仅更换镜像加速器，当检测到未安装 Docker 时会报错跳出

      bash <(curl -sSL https://linuxmirrors.cn/docker.sh) --only-registry

      • 安装 jq 软件包

        apt-get install -y jq

        Debian   Ubuntu   Kali   Linux Mint   Deepin   Zorin OS   Armbian   Proxmox VE   Raspberry Pi OS   openKylin

        新装系统需要先执行一遍更新 apt-get update

        dnf install -y jq || yum install -y jq

        Red Hat Enterprise Linux   CentOS   Rocky Linux   AlmaLinux   Fedora   openEuler   OpenCloudOS   Anolis OS

      • 指定镜像仓库地址

        请手动替换 <example.registry.com> 为镜像仓库地址后在执行，详见上方 “项目内置的镜像仓库源” 表格中的地址列

        SOURCE_REGISTRY='"https://<example.registry.com>"'
        还可以指定多个镜像仓库，如 SOURCE_REGISTRY='"https://example.registry.com","https://test.registry.com"'，注意用英文逗号分割

      • 替换镜像仓库地址

        [ -s "/etc/docker/daemon.json" ] || echo "{}" >/etc/docker/daemon.json
jq '.["registry-mirrors"] = ['"${SOURCE_REGISTRY}"']' /etc/docker/daemon.json >/etc/docker/daemon.json.tmp && mv /etc/docker/daemon.json.tmp

      • 重启 Docker 服务

        systemctl daemon-reload
[[ $(systemctl is-active docker) == "active" ]] && systemctl restart docker || systemctl enable --now docker

    • 指定 Docker CE 软件源仓库#

      脚本默认会自动判断一般无需指定，除非你有特殊需求

      bash <(curl -sSL https://linuxmirrors.cn/docker.sh) --branch centos

      仓库名是固定的，目前只有 centos debian fedora raspbian rhel sles static ubuntu 这几个
      具体详见 官方安装文档 和 Docker CE 官方仓库

    • 指定 Docker CE 安装版本#

      指定安装版本时会忽略 是否安装最新版本 的命令选项，格式为 主版本.次版本.补丁版本，例如 27.4.1。

      bash <(curl -sSL https://linuxmirrors.cn/docker.sh) --designated-version 27.0.0

      如果指定的版本不存在或者不支持当前系统，届时脚本会报错跳出

      查看版本列表的方法 
      apt-cache madison docker-ce | awk '{print $3}' | grep -Eo "[0-9][0-9].[0-9]{1,2}.[0-9]{1,2}" | sort -t '.' -k1,1nr -k2,2nr -k3,3nr

      Debian   Ubuntu   Kali   Linux Mint   Deepin   Zorin OS   Armbian   Proxmox VE   Raspberry Pi OS

      dnf list docker-ce --showduplicates | sort -r | awk '{print $2}' | grep -Eo "[0-9][0-9].[0-9]{1,2}.[0-9]{1,2}" | sort -t '.' -k1,1nr -k2,2nr -k3,3nr

      Red Hat Enterprise Linux   CentOS   Rocky Linux   AlmaLinux   Fedora   openEuler   OpenCloudOS   Anolis OS

      未出现在该列表中的版本则不支持通过本脚本安装，如果获取不到版本列表说明你当前的系统环境还没有正确配置 Docker CE 软件源（运行脚本时不存在该问题）

    • 无人值守（自动化）#

      不通过交互完成安装操作，至少需要使用如下命令选项来实现，建议熟悉后再使用

      参考命令
      bash <(curl -sSL https://linuxmirrors.cn/docker.sh) \
  --source mirror.example.com/docker-ce \
  --source-registry registry.hub.docker.com \
  --protocol http \
  --use-intranet-source false \
  --install-latest true \
  --close-firewall true \
  --ignore-backup-tips

      如果报错 命令选项无效 那么请检查选项合法性以及空格字符编码，在示例中一行写一个选项是为了提高命令的可读性

    • 纯净模式#

      推出该功能是为了便于开发人员使用，启用后会精简脚本内容输出，建议搭配其它命令选项无交互使用

      bash <(curl -sSL https://linuxmirrors.cn/docker.sh) --pure-mode

      滚动输出的命令日志可能存在无法预料的显示问题，不过目前暂未发现异常

  • 常见问题#

    • 关于服务报错无法启动#

      非新装环境可能会在运行脚本后遇到 Docker 服务无法启动的情况，建议重新安装来解决，卸载不会删除本地镜像和容器数据

      卸载命令如下：

      apt-get remove -y docker* containerd.io runc && apt-get autoremove

      Debian   Ubuntu   Kali   Linux Mint   Deepin   Zorin OS   Armbian   Proxmox VE   Raspberry Pi OS

      yum remove -y docker* containerd.io podman* runc

      Red Hat Enterprise Linux   CentOS   Rocky Linux   AlmaLinux   Fedora   openEuler   OpenCloudOS   Anolis OS

      卸载完成后重新执行脚本安装即可

    • 关于不支持的操作系统#

      如果提示不支持那么请使用系统自带的包管理工具进行安装。因为这些软件包由 Linux 发行版的软件包维护者构建和维护，可能存在配置差异或由修改后的源代码构建。

      也可以使用 Docker Desktop