Docker Installation & Registry Mirror Switcher#
One-Click Command#
Integrates installation of Docker Engine and Docker Compose, supports selecting or switching software repositories (Docker repositories) and registry mirrors, installing specific versions, reinstalling, and supports ARM architecture.
The script refers to the official documentation and uses the system package manager for installation. There are no compatibility or security issues. The available versions are determined by the Docker CE repository.
bash <(curl -sSL https://gitee.com/SuperManito/LinuxMirrors/raw/main/DockerInstallation.sh) --en --only-registry
Real-time sync, no delay. Recommended for use in Chinese mainland network environments.
bash <(curl -sSL https://raw.gitcode.com/SuperManito/LinuxMirrors/raw/main/DockerInstallation.sh) --en --only-registry
1-hour sync delay.
-
Completely replace the official installation script
It is logically consistent with get.docker.com and incorporates the repositories and features of this project.
-
Supports domestic derivative operating systems
Compatible with a number of derivative operating systems not supported by the official installation script.
-
Powerful and unparalleled
One of the most practical open source operation and maintenance scripts on the entire network, with excellent performance
-
Exquisite interactive design
An interactive command line interface that is easy to understand and use, way ahead of the competition
✨ After years of technical accumulation and production environment testing, it has been widely praised by the community and deeply loved by developers. It is used by major companies.
Docker Compose does not require a separate installation
Starting from V2, Docker Compose is part of the Docker CLI. The script integrates the installation of this plugin by default. Please use the docker compose command instead of docker-compose.
About Software Sources
-
Docker CE Software Repository
Docker CE stands for Docker Community Edition, which is another name for Docker Engine. This repository is used to download and install Docker-related packages.
-
Docker Registry Mirror
Used to control the default source repository for pulling images, also known as a registry accelerator. The default is the official container registry Docker Hub.
Due to some force majeure, Docker Hub is currently inaccessible in the Chinese mainland network environment, so the image cannot be pulled normally. It is recommended to use the image warehouse source available in Chinese mainland mentioned below.
Note: The specified Web protocol in the script is only for controlling the Docker CE software source. Docker Registry always uses the HTTPS protocol.
Built-in Registry Mirrors
| Site Name | Address | Description |
|---|---|---|
| 1ms Mirror | docker.1ms.run | Enterprise mirror, CDN smart distribution, extremely fast, supports paid customization, recommended |
| Docker Proxy | dockerproxy.net | Created by ghproxy, highly available but slow, supports paid enterprise acceleration |
| DaoCloud | docker.m.daocloud.io | Well-known enterprise mirror, highly available and fast, now whitelist only |
| 1Panel Mirror | docker.1panel.live | Enterprise product self-use mirror |
This open source project is not suitable for collecting personal self-built registry accelerators. If needed, you can use command options to specify your own.
Note: Registry mirrors from domestic cloud computing companies are only for their own business. Instances in Chinese mainland may still not be able to access Docker Hub.
Command Options (Advanced Usage)#
| Name | Meaning | Value |
|---|---|---|
--source |
Specify Docker CE mirror address (domain or IP) |
address |
--source-registry |
Specify Docker Registry mirror address (domain or IP) |
address (separate multiple entries with commas) |
--branch |
Specify Docker CE mirror repository (path) |
repo name (see docs below) |
--branch-version |
Specify Docker CE mirror repository version |
version (see docs below) |
--designated-version |
Specify Docker Engine installation version |
version (see docs below) |
--codename |
Specify Debian-based OS codename |
codename |
--protocol |
Specify Web protocol for Docker CE mirror |
http or https |
--use-intranet-source |
Prefer intranet Docker CE mirror address |
true or false |
--install-latest |
Whether to install the latest Docker Engine |
true or false |
--close-firewall |
Whether to disable the firewall | true or false |
--clean-screen |
Whether to clear the screen before running | true or false |
--lang |
Specify the language of the script output | language id (see docs below) |
--only-registry |
Only switch registry mirror mode | none |
--ignore-backup-tips |
Ignore backup overwrite prompt (do not backup) | none |
--pure-mode |
Pure mode, minimal output | none |
--help |
Show help menu | none |
Full source format:
< Web protocol>://<source address (domain or IP)>/<repository path>
-
Specify Registry Mirror Address#
bash <(curl -sSL https://linuxmirrors-8bw.pages.dev/docker.sh) --en --source-registry registry.example.comCan specify multiple addresses at the same time, and they must be separated by commas.
-
Only Switch Registry Mirror#
Only switches the registry accelerator. If Docker is not installed, an error will be reported and exit.
Lazy one-click command (using multiple addresses)
bash <(curl -sSL https://linuxmirrors-8bw.pages.dev/docker.sh) --en \ --only-registry \ --source-registry "docker.1ms.run,docker.1panel.live,docker.m.daocloud.io"The option value can specify multiple addresses, which must be separated by commas.
-
Install the
jqpackage -
Specify registry mirror address
You can also specify multiple registry mirrors, e.g.,Manually replace
<example.registry.com>with the registry address. See the address column in the "Built-in Registry Mirrors" table above.SOURCE_REGISTRY='"https://example.registry.com","https://test.registry.com"', separated by commas. -
Replace registry mirror address
-
Restart Docker service
-
-
Specify Docker CE Source Address#
bash <(curl -sSL https://linuxmirrors-8bw.pages.dev/docker.sh) --en --source mirror.example.com/docker-ceNote: The address path must include the Docker CE mirror repository path, i.e.,
docker-ce. -
Specify Docker CE Source Repository#
The script will automatically detect this in most cases. Specify only if you have special requirements.
Repository names are fixed:
centosdebianfedoraraspbianrhelslesstaticubuntu
See official installation docs and Docker CE official repo for details.Can also specify the repository version number.bash <(curl -sSL https://linuxmirrors-8bw.pages.dev/docker.sh) --en \ --branch centos \ --branch-version 9This option can be used to control the compatibility of the installed software package (only applicable to Red Hat operating systems). For details, see the path name (positive integer) representing the version number in the corresponding warehouse directory.
-
Specify Docker Engine Installation Version#
When specifying a version, the "install latest" option is ignored. Format:
major.minor.patch, e.g.,28.4.1.If the specified version does not exist or is not supported on your system, the script will report an error and exit.
How to view available versions
Versions not listed are not supported by this script. If you cannot get the version list, your system environment has not been properly configured for the Docker CE repository (this will not happen when running the script).
-
I18n (Internationalization)#
The script provides multi-language support. Currently, there are three built-in display languages:
简体中文、繁體中文、English. The default is简体中文. -
Unattended (Automation)#
To perform installation without interaction, use at least the following options. Recommended for experienced users.
Example Commandbash <(curl -sSL https://linuxmirrors-8bw.pages.dev/docker.sh) --en \ --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-tipsIf you get an "invalid option" error, check the option validity and whitespace encoding. Each option is written on a separate line for readability.
-
Pure Mode#
This feature is introduced to facilitate the use of developers and operation and maintenance personnel. After it is enabled, the script content output will be simplified. It is recommended to use it with other command options without interaction.
Scrolling command logs may have unpredictable display issues, but no problems have been found so far.
FAQ#
-
About Service Startup Errors#
In non-fresh environments, you may encounter
Dockerservice startup failures after running the script. It is recommended to reinstall to resolve this. Uninstalling will not delete local images or container data.Uninstall commands:
After uninstalling, simply rerun the script to install.
-
About unsupported operating systems#
If it prompts that it is not supported, please use the system's own package management tool to install it. Because these packages are built and maintained by the Linux distribution's package maintainers and may have differences in configuration or are built from modified source code.
You can also use
Lite Version#
The project also provides a simplified version, which is a copy of the main script, designed for enterprise products and large open-source community projects. It has the following features:
- Single display language
English, no I18n internationalization - Uses the official source by default, removing the interactive selection of built-in software sources
- Removes irrelevant printouts
- Retains core logic and command option design
Please familiarize yourself with this project before using it. It is not recommended for novice users.
Best Practices#
Code examples for enterprise product deployment and automated operations such as CI/CD (expand to view)
If you don't want any user interaction, use the fully automated example.
-
Fully automated (recommended)#
# !/bin/bash function install_docker() { if command -v docker &>/dev/null; then return fi # script options local script_host="linuxmirrors-8bw.pages.dev" # official host (CDN), more host see official site local close_firewall="true" # close firewalld service and selinux (redhat systems need) # mirrors options local source_docker_ce_address="mirrors.tencent.com/docker-ce" # global high availability address local source_docker_ce_protocol="https" # https or http local source_docker_registry_address="registry.hub.docker.com" # judge network environment local region_code="$(curl -s ipinfo.io/country)" if [[ "${region_code}" == "CN" ]]; then local source_intranet_address="" # use intranet source if possible if [ -s "/sys/class/dmi/id/sys_vendor" ]; then local sys_vendor="$(cat /sys/class/dmi/id/sys_vendor)" if [[ "${sys_vendor}" == *"Alibaba"* ]]; then source_intranet_address="mirrors.cloud.aliyuncs.com/docker-ce" elif [[ "${sys_vendor}" == *"Huawei"* ]]; then source_intranet_address="mirrors.myhuaweicloud.com/docker-ce" elif [[ "${sys_vendor}" == *"Tencent"* ]]; then source_intranet_address="mirrors.tencentyun.com/docker-ce" elif [[ "${sys_vendor}" == *"Inspur"* ]]; then source_intranet_address="mirrors.ivolces.com/docker-ce" fi else cat /etc/motd | grep "Alibaba Cloud " -q if [ $? -eq 0 ]; then source_intranet_address="mirrors.cloud.aliyuncs.com/docker-ce" fi fi # check connectivity if [ -n "${source_intranet_address}" ]; then if ping -c1 -W1 "${source_intranet_address%%/*}" >/dev/null 2>&1; then source_docker_ce_address="${source_intranet_address}" source_docker_ce_protocol="http" fi fi # registry mirror (best choice for Chinese mainland) source_docker_registry_address="docker.1ms.run" else # use official source source_docker_ce_address="download.docker.com" source_docker_registry_address="registry.hub.docker.com" fi # install docker engine bash <(curl -sSL https://${script_host}/docker-lite.sh) \ --source "${source_docker_ce_address}" \ --source-registry "${source_docker_registry_address}" \ --protocol "${source_docker_ce_protocol}" \ --close-firewall "${close_firewall}" } install_docker -
Simple method#
# !/bin/bash function install_docker() { if command -v docker &>/dev/null; then return fi bash <(curl -sSL https://${script_host}/docker.sh) \ --install-latest true \ --ignore-backup-tips \ --lang auto if command -v docker &>/dev/null; then echo -e "\n# Docker installation successful.\n# Please run this script again manually after installation." exit 0 else echo -e "\n# Docker installation failed.\n# Please check the error message above." exit 1 fi } install_dockerNote: If you don't specify
Docker CEandDocker Registrymirrors, the script will be interactively selected by the user. The screen will be automatically cleared ($ clear) at this point, which will cause your script's log to be cleared.