跳轉至

其它工具

為什麼會看到該提示？

本項目腳本目前主要服務於簡體中文用戶，但是從立項之初就定義為了通用換源腳本，提供了諸多命令選項用於自訂使用，這也是本項目為什麼開始面向其它語言用戶使用的原因之一。腳本列印內容目前固定為簡體中文，隨著其它語言使用者的回饋和使用，腳本將來可能會支援繁體中文和英文。

文檔使用工具進行翻譯，下方內容中的專業術語可能存在不準確的情況，歡迎修正。

已被眾多熱門項目使用，廣受社群用戶好評

Docker 安裝與換源腳本#

Debian Red Hat Enterprise Linux
Ubuntu Fedora
Kali Linux CentOS
Linux Mint Rocky Linux
Deepin AlmaLinux
Zorin OS openEuler
Armbian OpenCloudOS
Proxmox VE Anolis OS
Raspberry Pi OS

一鍵執行命令#

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

不支援在中國大陸網路環境下使用

軟體源說明

  • __Docker CE 軟體倉庫

    Docker CE 全稱 Docker Community Edition（Docker 社群版），是 Docker Engine 的別稱，該倉庫用於下載並安裝 Docker 相關軟體包

  • Docker Registry 鏡像倉庫

    用於控制拉取鏡像的預設來源儲存倉庫，又稱為鏡像加速器，預設為官方容器鏡像倉庫 Docker Hub

由於一些不可抗力的因素，目前中國大陸網路環境一般無法正常造訪 Docker Hub 因此無法拉取鏡像，建議使用下方提到的國內可用鏡像倉庫來源

註：腳本內的指定 WEB 協議互動僅用於控制 Docker CE 軟體源，Docker Registry 強制使用 HTTPS 協議

Docker Compose 不再需要獨立安裝

Docker Compose 自 V2 版本起開始作為 Docker CLI（命令列）的一部分，腳本預設整合安裝該插件，請使用 docker compose 指令取代 docker-compose

預設的鏡像倉庫源

中國大陸可用

名稱 位址 說明
毫秒鏡像 docker.1ms.run 企業鏡像站，CDN智慧分送速度極快，支援付費定制，推薦使用
Docker Proxy dockerproxy.net 由 ghproxy 創建，可用性高但速度很慢，支援企業鏡像付費加速
DaoCloud docker.m.daocloud.io 老牌企業鏡像站，可用性高且速度快，現為白名單模式
1Panel 鏡像 docker.1panel.live 企業產品自用鏡像

本開源項目不適合採集個人自建的鏡像加速器，如有需要可搭配命令選項自行使用

其它

名稱 位址 名稱 位址
Alibaba Cloud (Hangzhou) registry.cn-hangzhou.aliyuncs.com Alibaba Cloud (Japan - Tokyo) registry.ap-northeast-1.aliyuncs.com
Alibaba Cloud (Shanghai) registry.cn-shanghai.aliyuncs.com Alibaba Cloud (Singapore) registry.ap-southeast-1.aliyuncs.com
Alibaba Cloud (Qingdao) registry.cn-qingdao.aliyuncs.com Alibaba Cloud (Malaysia - Kuala Lumpur) registry.ap-southeast-3.aliyuncs.com
Alibaba Cloud (Beijing) registry.cn-beijing.aliyuncs.com Alibaba Cloud (Indonesia - Jakarta) registry.ap-southeast-5.aliyuncs.com
Alibaba Cloud (Zhangjiakou) registry.cn-zhangjiakou.aliyuncs.com Alibaba Cloud (Germany - Frankfurt) registry.eu-central-1.aliyuncs.com
Alibaba Cloud (Hohhot) registry.cn-huhehaote.aliyuncs.com Alibaba Cloud (UK - London) registry.eu-west-1.aliyuncs.com
Alibaba Cloud (Ulanqab) registry.cn-wulanchabu.aliyuncs.com Alibaba Cloud (US Western - Silicon Valley) registry.us-west-1.aliyuncs.com
Alibaba Cloud (Shenzhen) registry.cn-shenzhen.aliyuncs.com Alibaba Cloud (US Eastern - Virginia) registry.us-east-1.aliyuncs.com
Alibaba Cloud (Heyuan) registry.cn-heyuan.aliyuncs.com Alibaba Cloud (United Arab Emirates - Dubai) registry.me-east-1.aliyuncs.com
Alibaba Cloud (Guangzhou) registry.cn-guangzhou.aliyuncs.com Google Cloud（North America) gcr.io
Alibaba Cloud (Chengdu) registry.cn-chengdu.aliyuncs.com Google Cloud（Asia) asia.gcr.io
Alibaba Cloud (Hong Kong) registry.cn-hongkong.aliyuncs.com Google Cloud（Europe) eu.gcr.io
Tencent Cloud mirror.ccs.tencentyun.com Docker Hub registry.hub.docker.com

註：中國大陸雲端運算企業的鏡像倉庫來源僅針對其業務，中國大陸境內實例可能仍無法造訪 Docker Hub

  • 命令選項（進階用法）#

    名稱 意義 選項值
    --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

    卸載完成後重新執行腳本安裝即可