Repolode
Submit
SuperManito

SuperManito/LinuxMirrors

A shell script that switches a Linux distribution's package sources to domestic mirrors, plus a separate script for installing Docker and configuring registry mirrors.

View on GitHubWebsite
Stars
7,813
Forks
706
Open issues
2
Last commit
15 hours ago

What is it?

LinuxMirrors is a set of Bash scripts that replace the package sources of GNU/Linux distributions with mirror servers, which makes apt, yum/dnf, pacman and similar package managers faster to use from networks where default repositories are slow. The main script is launched with a single curl command and supports a long list of distributions, including Debian, Ubuntu, Fedora, Rocky Linux, AlmaLinux, openSUSE, Arch Linux, Alpine, Raspberry Pi OS, Proxmox VE and several Chinese distributions such as openEuler and openKylin.

A second script handles Docker. It installs Docker Engine from a mirror and can configure registry mirror accelerators, with an option to only change the registry settings. The project is written in Shell and released under the MIT license, and it provides a project website with usage instructions and a list of available mirror sources.

Key features

  • 01Replaces package sources for many Linux distributions with one command
  • 02Covers Debian, Ubuntu, RHEL-family, openSUSE, Arch, Alpine and more
  • 03Installs Docker Engine from a mirror
  • 04Configures Docker registry mirror accelerators, optionally without reinstalling
  • 05Written in Shell with an MIT license

Use cases

  • Speeding up apt or dnf installs on a new server in mainland China
  • Setting up a Raspberry Pi or Armbian board with faster package mirrors
  • Installing Docker on a fresh Linux host and pulling images through a registry accelerator

Quick start

  1. 1

    Run the main script to switch the system package sources

  2. 2

    Or run the Docker install and mirror script

Things to know

  • Works only on the GNU/Linux distributions and versions listed in the README.
  • The quick start runs a script fetched from the internet and executed directly on the system.

Topics

#linux#shell#package-manager#mirror#docker#apt#devops#almalinux#alpine#archlinux

FAQ

What is LinuxMirrors?
A shell script that switches a Linux distribution's package sources to domestic mirrors, plus a separate script for installing Docker and configuring registry mirrors. LinuxMirrors is a set of Bash scripts that replace the package sources of GNU/Linux distributions with mirror servers, which makes apt, yum/dnf, pacman and similar package managers faster to use from networks where default repositories are slow. The main script is launched with a single curl command and supports a long list of distributions, including Debian, Ubuntu, Fedora, Rocky Linux, AlmaLinux, openSUSE, Arch Linux, Alpine, Raspberry Pi OS, Proxmox VE and several Chinese distributions such as openEuler and openKylin.
Is LinuxMirrors free to use? What license does it have?
LinuxMirrors is open source under the MIT license. Check the license terms before using it in commercial products.
Is LinuxMirrors still maintained?
Actively maintained. The last commit to LinuxMirrors was on Oct 21, 2026.
What can I use LinuxMirrors for?
Speeding up apt or dnf installs on a new server in mainland China Setting up a Raspberry Pi or Armbian board with faster package mirrors Installing Docker on a fresh Linux host and pulling images through a registry accelerator
How do I install LinuxMirrors?
Run the main script to switch the system package sources Or run the Docker install and mirror script
Where can I get LinuxMirrors?
The source code and installation instructions are on GitHub: https://github.com/SuperManito/LinuxMirrors

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects