Package Mirror Sources in China (pip / conda / apt / Docker mirrors)

国内镜像源（换源：清华 TUNA / 阿里云等）Common

Redirecting pip, conda, apt, and similar tools to a Chinese mirror instead of the slow or blocked default servers.

Tools like pip, conda, apt, and Docker default to downloading packages from servers overseas, which are often slow or time out entirely from within China. Universities and cloud providers maintain synced copies — such as the mirror hosted by Tsinghua University's TUNA student association, plus mirrors run by Alibaba Cloud, USTC, and Shanghai Jiao Tong University — and pointing a tool's configured download URL at one of these is what's called “switching sources” (换源). Embodied-AI environments have a lot of dependencies (PyTorch, ROS, simulators, assorted Python packages), so switching sources is nearly always the first step in setting one up. A few caveats: mirror syncing lags behind, so the very latest release may not be available yet; multiple Chinese Docker Hub mirrors reportedly stopped operating starting in 2024, so pulling images may require finding another working source; and Hugging Face models have their own separate options, the Hugging Face mirror and ModelScope.

ExampleRunning pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple switches pip's default source to the Tsinghua mirror.

Also called: mirror source, Tsinghua mirror, Aliyun mirror, switching sources
Related: Conda · Docker · uv · Hugging Face Mirror (hf-mirror.com) · ModelScope · Ubuntu Linux
Sources: 清华大学开源软件镜像站 PyPI 帮助 (Chinese)
阿里云开源镜像站 (Chinese)