LinuxMirrors/index.zh-Hant.md at 8b19aa4b61139a9b38a679e8b5bbee10eab532c1

TRKJ/LinuxMirrors

Fork 0

mirror of https://gitee.com/SuperManito/LinuxMirrors synced 2025-11-03 07:50:28 +08:00

Files

Super Manito 8b19aa4b61 更新文档

2025-06-22 12:46:54 +08:00

23 KiB

Raw Blame History

hide

navigation

feedback

footer

???+ question "為什麼會看到該提示？"

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

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

!!! tip inline end "已被眾多熱門項目使用，廣受社群用戶好評"

:simple-docker:{style="color: #1d63ed"} 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

一鍵執行命令

=== "安裝"

!!! quote ""

    === ":linuxmirrors: 官網（推薦）"

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

    === ":simple-github: GitHub"

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

    === ":simple-gitee: Gitee 码云 (鏡像倉庫)"

        ``` bash
        bash <(curl -sSL https://gitee.com/SuperManito/LinuxMirrors/raw/main/DockerInstallation.sh)
        ```
        > 即時同步、無延遲，中國大陸網路環境建議使用

    === ":gitcode: GitCode (鏡像倉庫)"

        ``` bash
        bash <(curl -sSL https://raw.gitcode.com/gh_mirrors/li/LinuxMirrors/raw/main/DockerInstallation.sh)
        ```
        > 本項目已加入 GitHub 加速計劃，同步存在1小時延遲

    === ":simple-jsdelivr: jsDelivr (CDN)"

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

    === ":tencent-cloud: 騰訊雲 EO (CDN)"

        ``` bash
        bash <(curl -sSL https://edgeone.linuxmirrors.cn/docker.sh)
        ```
        > 不支援在中國大陸網路環境下使用

    整合安裝 [`Docker Engine`](https://docs.docker.com/engine) 和 [`Docker Compose`](https://docs.docker.com/compose)，支援選擇或更換軟體源以及映像倉庫、安裝指定版本、重裝等功能，支援 ARM 架構

    腳本參考[官方文件](https://docs.docker.com/engine/install)使用系統套件管理工具進行安裝，不存在相容性、安全性等問題，可安裝的版本由 Docker CE 倉庫決定。

=== "僅更換鏡像加速器"

!!! quote ""

    === ":linuxmirrors: 官網（推薦）"

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

    === ":simple-github: GitHub"

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

    === ":simple-gitee: Gitee 码云 (鏡像倉庫)"

        ``` bash
        bash <(curl -sSL https://gitee.com/SuperManito/LinuxMirrors/raw/main/DockerInstallation.sh) --only-registry
        ```
        > 即時同步、無延遲，中國大陸網路環境建議使用

    === ":gitcode: GitCode (鏡像倉庫)"

        ``` bash
        bash <(curl -sSL https://raw.gitcode.com/gh_mirrors/li/LinuxMirrors/raw/main/DockerInstallation.sh) --only-registry
        ```
        > 本項目已加入 GitHub 加速計劃，同步存在1小時延遲

    === ":simple-jsdelivr: jsDelivr (CDN)"

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

    === ":tencent-cloud: 騰訊雲 EO (CDN)"

        ``` bash
        bash <(curl -sSL https://edgeone.linuxmirrors.cn/docker.sh) --only-registry
        ```
        > 不支援在中國大陸網路環境下使用

!!! node "軟體源說明"

<div class="grid cards" markdown>

-   __Docker CE 軟體倉庫

    ---

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

-   __Docker Registry 鏡像倉庫__

    ---

    用於控制拉取鏡像的預設來源儲存倉庫，又稱為鏡像加速器，預設為官方容器鏡像倉庫 [Docker Hub](https://hub.docker.com) 

</div>

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

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

!!! tip "Docker Compose 不再需要獨立安裝"

Docker Compose 自 V2 版本起開始作為 Docker CLI（命令列）的一部分，腳本預設整合安裝該[插件](https://docs.docker.com/compose/install/linux)，請使用 `docker compose` 指令取代 `docker-compose`

!!! quote "預設的鏡像倉庫源"

<div style="text-align: center" markdown>
<div style="font-size: 0.8rem"><strong>中國大陸可用</strong></div>

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

<blockquote style="border-left: none !important">本開源項目不適合採集個人自建的鏡像加速器，如有需要可搭配命令選項自行使用</blockquote>

<div style="font-size: 0.8rem; margin-top: 1rem"><strong>其它</strong></div>

| 名稱 | 位址 | 名稱 | 位址 |
| :- | :-: | :- | :-: |
| Alibaba Cloud (Hangzhou) | [registry.cn-hangzhou.aliyuncs.com](https://help.aliyun.com/zh/acr/user-guide/accelerate-the-pulls-of-docker-official-images "https://registry.cn-hangzhou.aliyuncs.com") | Alibaba Cloud (Japan - Tokyo) | [registry.ap-northeast-1.aliyuncs.com](https://help.aliyun.com/zh/acr/user-guide/accelerate-the-pulls-of-docker-official-images "https://registry.ap-northeast-1.aliyuncs.com") |
| Alibaba Cloud (Shanghai) | [registry.cn-shanghai.aliyuncs.com](https://help.aliyun.com/zh/acr/user-guide/accelerate-the-pulls-of-docker-official-images "https://registry.cn-shanghai.aliyuncs.com") | Alibaba Cloud (Singapore) | [registry.ap-southeast-1.aliyuncs.com](https://help.aliyun.com/zh/acr/user-guide/accelerate-the-pulls-of-docker-official-images "https://registry.ap-southeast-1.aliyuncs.com") |
| Alibaba Cloud (Qingdao) | [registry.cn-qingdao.aliyuncs.com](https://help.aliyun.com/zh/acr/user-guide/accelerate-the-pulls-of-docker-official-images "https://registry.cn-qingdao.aliyuncs.com") | Alibaba Cloud (Malaysia - Kuala Lumpur) | [registry.ap-southeast-3.aliyuncs.com](https://help.aliyun.com/zh/acr/user-guide/accelerate-the-pulls-of-docker-official-images "https://registry.ap-southeast-3.aliyuncs.com") |
| Alibaba Cloud (Beijing) | [registry.cn-beijing.aliyuncs.com](https://help.aliyun.com/zh/acr/user-guide/accelerate-the-pulls-of-docker-official-images "https://registry.cn-beijing.aliyuncs.com") | Alibaba Cloud (Indonesia - Jakarta) | [registry.ap-southeast-5.aliyuncs.com](https://help.aliyun.com/zh/acr/user-guide/accelerate-the-pulls-of-docker-official-images "https://registry.ap-southeast-5.aliyuncs.com") |
| Alibaba Cloud (Zhangjiakou) | [registry.cn-zhangjiakou.aliyuncs.com](https://help.aliyun.com/zh/acr/user-guide/accelerate-the-pulls-of-docker-official-images "https://registry.cn-zhangjiakou.aliyuncs.com") | Alibaba Cloud (Germany - Frankfurt) | [registry.eu-central-1.aliyuncs.com](https://help.aliyun.com/zh/acr/user-guide/accelerate-the-pulls-of-docker-official-images "https://registry.eu-central-1.aliyuncs.com") |
| Alibaba Cloud (Hohhot) | [registry.cn-huhehaote.aliyuncs.com](https://help.aliyun.com/zh/acr/user-guide/accelerate-the-pulls-of-docker-official-images "https://registry.cn-huhehaote.aliyuncs.com") | Alibaba Cloud (UK - London) | [registry.eu-west-1.aliyuncs.com](https://help.aliyun.com/zh/acr/user-guide/accelerate-the-pulls-of-docker-official-images "https://registry.eu-west-1.aliyuncs.com") |
| Alibaba Cloud (Ulanqab) | [registry.cn-wulanchabu.aliyuncs.com](https://help.aliyun.com/zh/acr/user-guide/accelerate-the-pulls-of-docker-official-images "https://registry.cn-wulanchabu.aliyuncs.com") | Alibaba Cloud (US Western - Silicon Valley) | [registry.us-west-1.aliyuncs.com](https://help.aliyun.com/zh/acr/user-guide/accelerate-the-pulls-of-docker-official-images "https://registry.us-west-1.aliyuncs.com") |
| Alibaba Cloud (Shenzhen) | [registry.cn-shenzhen.aliyuncs.com](https://help.aliyun.com/zh/acr/user-guide/accelerate-the-pulls-of-docker-official-images "https://registry.cn-shenzhen.aliyuncs.com") | Alibaba Cloud (US Eastern - Virginia) | [registry.us-east-1.aliyuncs.com](https://help.aliyun.com/zh/acr/user-guide/accelerate-the-pulls-of-docker-official-images "https://registry.us-east-1.aliyuncs.com") |
| Alibaba Cloud (Heyuan) | [registry.cn-heyuan.aliyuncs.com](https://help.aliyun.com/zh/acr/user-guide/accelerate-the-pulls-of-docker-official-images "https://registry.cn-heyuan.aliyuncs.com") | Alibaba Cloud (United Arab Emirates - Dubai) | [registry.me-east-1.aliyuncs.com](https://help.aliyun.com/zh/acr/user-guide/accelerate-the-pulls-of-docker-official-images "https://registry.me-east-1.aliyuncs.com") |
| Alibaba Cloud (Guangzhou) | [registry.cn-guangzhou.aliyuncs.com](https://help.aliyun.com/zh/acr/user-guide/accelerate-the-pulls-of-docker-official-images "https://registry.cn-guangzhou.aliyuncs.com") | Google Cloud（North America) | [gcr.io](https://cloud.google.com/artifact-registry/docs/transition/gcr-repositories?hl=zh-cn "https://gcr.io") |
| Alibaba Cloud (Chengdu) | [registry.cn-chengdu.aliyuncs.com](https://help.aliyun.com/zh/acr/user-guide/accelerate-the-pulls-of-docker-official-images "https://registry.cn-chengdu.aliyuncs.com") | Google Cloud（Asia) | [asia.gcr.io](https://cloud.google.com/artifact-registry/docs/transition/gcr-repositories?hl=zh-cn "https://asia.gcr.io") |
| Alibaba Cloud (Hong Kong) | [registry.cn-hongkong.aliyuncs.com](https://help.aliyun.com/zh/acr/user-guide/accelerate-the-pulls-of-docker-official-images "https://registry.cn-hongkong.aliyuncs.com") | Google Cloud（Europe) | [eu.gcr.io](https://cloud.google.com/artifact-registry/docs/transition/gcr-repositories?hl=zh-cn "https://eu.gcr.io") |
| Tencent Cloud | [mirror.ccs.tencentyun.com](https://cloud.tencent.com/document/product/1207/45596 "https://mirror.ccs.tencentyun.com") | Docker Hub | [registry.hub.docker.com](https://hub.docker.com/ "registry.hub.docker.com") |

<blockquote style="border-left: none !important">註：中國大陸雲端運算企業的鏡像倉庫來源僅針對其業務，中國大陸境內實例可能仍無法造訪 Docker Hub</blockquote>

</div>

命令選項（進階用法）

名稱	意義	選項值
`--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
  bash <(curl -sSL https://linuxmirrors.cn/docker.sh) --only-registry
  ```

=== "手動替換"

  - 安裝 `jq` 軟體包

      === "Debian 係 / openKylin"

          ``` bash
          apt-get install -y jq
          ```

          > `Debian` &nbsp; `Ubuntu` &nbsp; `Kali` &nbsp; `Linux Mint` &nbsp; `Deepin` &nbsp; `Zorin OS` &nbsp; `Armbian` &nbsp; `Proxmox VE` &nbsp; `Raspberry Pi OS` &nbsp; `openKylin`

          新裝系統需要先執行一次更新 `apt-get update`

      === "RedHat 係 / openEuler / OpenCloudOS / Anolis OS"

          ``` bash
          dnf install -y jq || yum install -y jq
          ```

          > `Red Hat Enterprise Linux` &nbsp; `CentOS` &nbsp; `Rocky Linux` &nbsp; `AlmaLinux` &nbsp; `Fedora` &nbsp; `openEuler` &nbsp; `OpenCloudOS` &nbsp; `Anolis OS`

  - 指定鏡像倉庫位址

      > 請手動替換 `<example.registry.com>` 為鏡像倉庫位址後在執行，詳見上方 “項目內置的鏡像倉庫源” 表格中的位址列

      ``` bash
      SOURCE_REGISTRY='"https://<example.registry.com>"'
      ```
      也可以指定多個鏡像倉庫，如 `SOURCE_REGISTRY='"https://example.registry.com","https://test.registry.com"'`，注意用英文逗號分割

  - 替換鏡像倉庫位址

      ``` bash
      [ -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 服務

      ``` bash
      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

如果指定的版本不存在或不支援目前系統，屆時腳本會報錯跳出

??? quote "查看版本清單的方法"

  === "Debian 系"

      ``` bash
      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` &nbsp; `Ubuntu` &nbsp; `Kali` &nbsp; `Linux Mint` &nbsp; `Deepin` &nbsp; `Zorin OS` &nbsp; `Armbian` &nbsp; `Proxmox VE` &nbsp; `Raspberry Pi OS`

  === "RedHat 系 / openEuler / OpenCloudOS / Anolis OS"

      ``` bash
      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` &nbsp; `CentOS` &nbsp; `Rocky Linux` &nbsp; `AlmaLinux` &nbsp; `Fedora` &nbsp; `openEuler` &nbsp; `OpenCloudOS` &nbsp; `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
```
!!! tip "滾動輸出的命令日誌可能有無法預料的顯示問題，不過目前暫未發現異常"

關於服務報錯無法啟動

!!! quote ""

  非新裝環境可能會在執行腳本後遇到 `Docker` 服務無法啟動的情況，建議重新安裝來解決，卸載不會刪除本機映像和容器數據

  卸載指令如下：

  === "Debian 系"

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

      > `Debian` &nbsp; `Ubuntu` &nbsp; `Kali` &nbsp; `Linux Mint` &nbsp; `Deepin` &nbsp; `Zorin OS` &nbsp; `Armbian` &nbsp; `Proxmox VE` &nbsp; `Raspberry Pi OS`

  === "RedHat 系 / openEuler / OpenCloudOS / Anolis OS"

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

      > `Red Hat Enterprise Linux` &nbsp; `CentOS` &nbsp; `Rocky Linux` &nbsp; `AlmaLinux` &nbsp; `Fedora` &nbsp; `openEuler` &nbsp; `OpenCloudOS` &nbsp; `Anolis OS`

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

23 KiB Raw Blame History Unescape Escape

:simple-docker:{style="color: #1d63ed"} Docker 安裝與換源腳本

一鍵執行命令

命令選項（進階用法）

指定 Docker CE 軟體源位址

指定鏡像倉庫位址

僅更換鏡像倉庫

指定 Docker CE 軟體源倉庫

指定 Docker CE 安裝版本

無人值守（自動化）

純淨模式

關於服務報錯無法啟動

23 KiB

Raw Blame History

指定 `Docker CE` 軟體源位址