explaingit

supermanito/linuxmirrors

7,473ShellAudience · ops devopsComplexity · 1/5LicenseSetup · easy

TLDR

Shell scripts that switch your Linux system's package download server to a faster nearby mirror with a single command, no manual config file editing required.

Mindmap

mindmap
  root((linuxmirrors))
    What it does
      Switch package mirrors
      Speed up downloads
      No manual editing
    Distributions
      Debian and Ubuntu
      Arch and Fedora
      CentOS and Alpine
    Use cases
      Faster installs
      Docker mirror setup
      ARM device setup
    Audience
      Linux users
      DevOps teams
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Speed up software installs on a Linux server in China by switching to a local package mirror.

USE CASE 2

Switch Docker's image download source to a faster regional server with one command.

USE CASE 3

Apply mirror changes on Debian, Ubuntu, Arch, Fedora, or CentOS without editing config files manually.

USE CASE 4

Set up faster package downloads on a Raspberry Pi or other ARM-based Linux device.

Tech stack

ShellBash

Getting it running

Difficulty · easy Time to first run · 5min
Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

LinuxMirrors is a collection of shell scripts that make it easy to switch the software download sources on a Linux computer. When you install software on Linux, your system reaches out to a remote server (called a mirror) to download it. The default server is often slow for users in certain regions, particularly China. These scripts let you point your system at a faster nearby mirror with a single command, instead of manually editing configuration files. The project supports a wide range of Linux distributions: Debian, Ubuntu, Kali Linux, Linux Mint, Deepin, Fedora, CentOS, Rocky Linux, AlmaLinux, Arch Linux, openSUSE, Alpine, Raspberry Pi OS, and many others. A separate script handles Docker specifically, covering both the installation of Docker and the switching of its image download source. The scripts detect which distribution you are running and apply the appropriate changes automatically. To use it, you run a one-line command in a terminal that downloads and executes the script. The script then presents you with a menu of available mirror sources, you pick one, and it updates your system's configuration. No manual file editing is required. The project is aimed at Linux users who want faster package downloads and do not want to hunt down instructions for each distribution separately. The repository is written in Shell (Bash), has an MIT license, and covers both 64-bit and ARM-based systems. The documentation is primarily in Chinese, with versions available in Traditional Chinese and English as well. It has been maintained across many Linux distribution versions and is a practical utility rather than a software application in the traditional sense.

Copy-paste prompts

Prompt 1
I'm running Ubuntu 22.04 and want to use linuxmirrors to switch to a faster package mirror, give me the one-line command and explain what it changes in my system.
Prompt 2
Show me how to use linuxmirrors to change both the system package mirror and the Docker image source on a Debian server in one go.
Prompt 3
After running linuxmirrors on Arch Linux, how do I verify the new mirror is active and test download speed?
Prompt 4
Help me understand what files linuxmirrors modifies when I select a new mirror source for my distribution.
Open on GitHub → Explain another repo

← supermanito on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.