Skip to content

Mirror List

Switching Gentoo’s sources happens in two parts: the Portage tree (the ebuilds and metadata for packages — best synced over git, though rsync works too) and Distfiles (the package source tarballs, served over HTTP and configured via GENTOO_MIRRORS in make.conf).

Below is a tested summary table showing at a glance what each mirror supports; the per-method config is in the collapsible tutorials further down.

Recommended combo: sync the Portage tree over git (incremental updates, fast and stable) plus a nearby distfiles mirror. If you’re not sure what to put, just pick whichever region in the table is closest to you.

Overview

Every node has been individually tested; ✓ = verified working. The distfiles URL is the value you put in GENTOO_MIRRORS; the exact git / rsync sync URLs are in the tutorials below.

MirrorRegiondistfiles URLgitrsync
Tsinghua TUNANorth China · Beijinghttps://mirrors.tuna.tsinghua.edu.cn/gentoo
BFSUNorth China · Beijinghttps://mirrors.bfsu.edu.cn/gentoo
USTCEast China · Hefeihttps://mirrors.ustc.edu.cn/gentoo
ZJUEast China · Hangzhouhttps://mirrors.zju.edu.cn/gentoo
NJUEast China · Nanjinghttps://mirrors.nju.edu.cn/gentoo
SDUEast China · Qingdaohttps://mirrors.sdu.edu.cn/gentoo
HUSTCentral China · Wuhanhttps://mirrors.hust.edu.cn/gentoo
SUSTechSouth China · Shenzhenhttps://mirrors.sustech.edu.cn/gentoo
HITNortheast · Harbinhttps://mirrors.hit.edu.cn/gentoo
LZUNorthwest · Lanzhouhttps://mirror.lzu.edu.cn/gentoo
Alibaba CloudNationwide · CDNhttps://mirrors.aliyun.com/gentoo
NetEase 163Nationwide · CDNhttps://mirrors.163.com/gentoo
CERNETNationwide · geo-routedhttps://mirrors.cernet.edu.cn/gentoo
CICKUHong Konghttps://hk.mirrors.cicku.me/gentoo
PlanetUnixHong Konghttps://hippocamp.cn.ext.planetunix.net/pub/gentoo
xTomHong Konghttps://mirror.xtom.com.hk/gentoo
RackspaceHong Konghttps://mirror.rackspace.com/gentoo
aditsuHong Konghttp://gentoo.aditsu.net:8000 (HTTP)
NCHCTaiwanhttp://ftp.twaren.net/Linux/Gentoo
CICKUTaiwanhttps://tw.mirrors.cicku.me/gentoo
FreedifSingaporehttps://mirror.freedif.org/gentoo
CICKUSingaporehttps://sg.mirrors.cicku.me/gentoo
PlanetUnixSingaporehttps://enceladus.sg.ext.planetunix.net/pub/gentoo

Configuration tutorials

① Sync the Portage tree over git (recommended)

Tested working git sources:

MirrorSync URL
Tsinghua TUNAhttps://mirrors.tuna.tsinghua.edu.cn/git/gentoo-portage.git
USTChttps://mirrors.ustc.edu.cn/gentoo.git
ZJUhttps://mirrors.zju.edu.cn/git/gentoo-portage.git
NJUhttps://mirrors.nju.edu.cn/git/gentoo-portage.git
BFSUhttps://mirrors.bfsu.edu.cn/git/gentoo-portage.git
SDUhttps://mirrors.sdu.edu.cn/git/gentoo-portage.git
HUSThttps://mirrors.hust.edu.cn/git/gentoo-portage.git
GitHub (overseas)https://github.com/gentoo-mirror/gentoo.git

Switching to git sync for the first time: edit /etc/portage/repos.conf/gentoo.conf:

[gentoo]
location = /var/db/repos/gentoo
sync-type = git
sync-uri = https://mirrors.bfsu.edu.cn/git/gentoo-portage.git
auto-sync = yes

Remove the old rsync directory, then sync:

rm -rf /var/db/repos/gentoo
emerge --sync

Already on git, just changing mirrors: update the sync-uri above, then point the git remote at the new URL in the repo directory:

cd /var/db/repos/gentoo
git remote set-url origin <new sync-uri>
emerge --sync
② Sync the Portage tree over rsync
Quite a few mirrors only offer git / distfiles and don’t run rsync at all. The ones below have been tested to expose the gentoo-portage module, so they’re safe to use.
MirrorSync URL
Tsinghua TUNArsync://mirrors.tuna.tsinghua.edu.cn/gentoo-portage
USTCrsync://rsync.mirrors.ustc.edu.cn/gentoo-portage
BFSUrsync://mirrors.bfsu.edu.cn/gentoo-portage
NCHC (Taiwan)rsync://ftp.twaren.net/gentoo-portage
PlanetUnix (Hong Kong)rsync://hippocamp.cn.ext.planetunix.net/gentoo-portage

Edit /etc/portage/repos.conf/gentoo.conf and point sync-uri at any of the addresses above:

[gentoo]
location = /var/db/repos/gentoo
sync-type = rsync
sync-uri = rsync://mirrors.bfsu.edu.cn/gentoo-portage
auto-sync = yes

Then run emerge --sync.

③ Distfiles config (GENTOO_MIRRORS)

In /etc/portage/make.conf, fill in the distfiles URL from the overview table. You can list several (Portage tries them in order, with the earlier ones taking priority):

GENTOO_MIRRORS="https://mirrors.bfsu.edu.cn/gentoo https://mirrors.tuna.tsinghua.edu.cn/gentoo https://mirrors.ustc.edu.cn/gentoo"

Once both Portage and Distfiles are set up, run emerge --sync to update.

For the full official lists, see Download mirrors and rsync mirrors. For switching the community overlay’s source, see “Mirror acceleration” on the Overlay page.