This wiki was updated to MediaWiki 1.37. If you notice any issues, please report them to admin[at]opensuse.org

MirrorCache

Jump to: navigation, search
MirrorCache

MirrorCache.svg

Download redirector and Metalink generator

Vendor: openSUSE
Developer: Andrii Nikitin, Elisei Roca
License: GPL-2
Web: http://www.mirrorcache.org/


About

MirrorCache is an open source framework to run a content delivery network using mirror servers. It comes with features that MirrorBrain is lacking.


Features

  • Open source
  • Job Queue, including WebUI to manage jobs (e.g. mirror scans)
  • Tracks mirrors capability to serve http / https and ipv4 / ipv6 and route requests accordingly
  • WebUI for managing mirrors
  • Metalink generation

Documentation

Setting up MirrorCache for your machine

For early adapters, Use steps below if you wish to batch replace baseurl used by zypper repositories.

First, choose one of the MirrorCache instances that are closely to you:

   mirrorcache-eu.opensuse.org has European mirrors only
   mirrorcache-us.opensuse.org has North America mirrors
   mirrorcache-au.opensuse.org has Oceania mirrors
   mirrorcache-jp.opensuse.org has Japan mirrors
   mirrorcache.opensuse.org has all the rest mirrors and may redirect requests to a corresponding regional instance

Preview current baseurl used in repo files with shell command:

   grep baseurl /etc/zypp/repos.d/*.repo

or

   zypper lr -u

The command below demonstrates how to replace 'http://download.opensuse.org' with 'https://mirrorcache.opensuse.org', adjust it for your needs:

   sudo sed -i "s,http://download.opensuse.org,https://mirrorcache.opensuse.org,g" /etc/zypp/repos.d/*.repo

After that, you should already be set. Just remember that all new traffic is now not only going over an secured HTTPS connection, but is also using mirrors that are as close as possible to your home.

If in doubt, one can check region as it sees the instance by visiting https://mirrorcache.opensuse.org/rest/myip

Troubleshooting

In most of cases good start is to review /var/log/zypper.log and check output of curl -IL for problem url, e.g.

   curl -IL https://mirrorcache.opensuse.org/distribution/leap/15.3/iso/openSUSE-Leap-15.3-DVD-x86_64-Current.iso

How to get help


See also


External links