每个开发都会用到的国内开发资源镜像一览

本页面记录我们团队开发环境中的使用国内镜像站加速的配置参考，便于快速配置开发环境使用的镜像站，一些相关的详细参考内容会以参考资料形式给出。

本文以全局镜像配置为主，即配置在全局的路径下，所有的项目均受影响。像 Maven, Gradle 之类的工具支持项目单独定义镜像仓库，并不在本文涉及的内容中。

镜像配置列表:

• Gradle
• Maven
• Groovy Grape
• nvm
• npm
• PyPI
• Anaconda
• Vagrant
• Rust
  • rustup
  • crates.io 索引镜像
• Docker Hub
  • Linux
  • MacOS
  • Windows
• Julia

Gradle

创建目录 ~/.gradle/init.d(Unix/Linux 环境)或 %USERPROFILE%\.gradle\init.d(Windows 环境)，写入以下两个文件:

• repo.gradle:

        allprojects{buildscript{repositories{maven{url"https://repo.huaweicloud.com/repository/maven"}}}repositories{maven{url"https://repo.huaweicloud.com/repository/maven"}}gradle.projectsEvaluated{tasks.withType(JavaCompile){options.compilerArgs<<"-Xlint:unchecked"<<"-Xlint:deprecation"}tasks.withType(GroovyCompile){options.compilerArgs<<"-Xlint:unchecked"<<"-Xlint:deprecation"}}}

• pluginManagement.gradle (只对 Gradle 4.0及以上版本使用新的 plugins {}DSL 部分有效):

        settingsEvaluated{settings->settings.pluginManagement{repositories{maven{url"https://repo.huaweicloud.com/repository/maven"}gradlePluginPortal()}}}

注: gradle 使用镜像站下载依赖的时候可能会出现镜像站还未缓存完毕依赖，从而下载依赖的时候出错，导致 task 失败退出的情况。如果遇到这种情况，等待镜像站缓存完毕，加上 --refresh-dependencies参数重新运行一次 task 即可，如:

./gradlew --refresh-dependencies build

参考资料:

• Initialization Scripts
• Using Gradle Plugins

Maven

创建 ~/.m2/settings.xml(Linux/Unix 环境)或 %USERPROFILE%\.m2\settings.xml(Windows 环境)文件，写入以下内容:

    huaweicloud*https://repo.huaweicloud.com/repository/maven

参考资料:

• Using Mirrors for Repositories
• 华为云 Maven 配置文档

Groovy Grape

创建 ~/.groovy/grapeConfig.xml(Linux/Unix 环境)或 %USERPROFILE%\.groovy\grapeConfig.xml(Windows 环境)文件，写入以下内容:

参考资料:

• Dependency management with Grape

nvm

配置环境变量:

• NVM_NODEJS_ORG_MIRROR=http://npm.taobao.org/mirrors/node
• NVM_IOJS_ORG_MIRROR=http://npm.taobao.org/mirrors/iojs

参考资料:

• 阿里云 npm mirrors

npm

执行命令:

    npm configsetregistry https://registry.npm.taobao.org
npm configsetdisturl https://npm.taobao.org/dist
npm configsetsass_binary_site https://npm.taobao.org/mirrors/node-sass
npm configsetphantomjs_cdnurl https://npm.taobao.org/mirrors/phantomjs
npm configsetchromedriver_cdnurl https://npm.taobao.org/mirrors/chromedriver
npm configsetoperadriver_cdnurl https://npm.taobao.org/mirrors/operadriver
npm configsetelectron_mirror https://npm.taobao.org/mirrors/electron/
npm configsetpython_mirror https://npm.taobao.org/mirrors/python
npm configsetelectron_builder_binaries_mirror https://npm.taobao.org/mirrors/electron-builder-binaries/
npm configsetnode_sqlite3_binary_host_mirror https://npm.taobao.org/mirrors

手改 ~/.npmrc或设置等效的环境变量均有效。

特别注意，如果想要发布 npm 包到中央仓库，必须先取消设置 registry，发布完毕之后再改回来:

    # 发布中央仓库之前必须取消registry镜像设置npm config delete registry# 发布完毕再把registry镜像加回来npm configsetregistry https://registry.npm.taobao.org

参考资料:

• NodeJS 使用淘宝 npm 镜像站的各种姿势
• npm-config

PyPI

执行命令:

    pip configsetglobal.index-url https://mirrors.aliyun.com/pypi/simple/

参考资料:

• pip user guide
• pip config

Anaconda

执行命令:

    conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/conda-forge
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/msys2
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/pytorch/
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/r
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main
conda config --set show_channel_urls yes

修改 .condarc配置文件可以达成同样的效果，参考下方参考资料。

参考资料:

• 清华大学镜像站

Vagrant

通过镜像站安装插件:

    vagrant plugin install --plugin-clean-sources --plugin-source https://gems.ruby-china.com/ ...

vagrant-vbguest下载 VBoxGuestAdditions 镜像(修改 Vagrantfile):

    config.vbguest.iso_path="https://mirrors.tuna.tsinghua.edu.cn/virtualbox/%{version}/VBoxGuestAdditions_%{version}.iso"

通过镜像站下载 box:

    # Ubuntu镜像vagrant init ubuntu-bionic https://mirrors.tuna.tsinghua.edu.cn/ubuntu-cloud-images/bionic/current/bionic-server-cloudimg-amd64-vagrant.box# Centos镜像vagrant init centos7 https://mirrors.ustc.edu.cn/centos-cloud/centos/7/vagrant/x86_64/images/CentOS-7.box

也可以修改 Vagrantfile的 config.vm.box_url = "box文件的url"。

参考资料:

• Vagrant 使用国内镜像安装插件和 box 镜像

Rust

rustup

设置环境变量:

• RUSTUP_DIST_SERVER=https://mirrors.tuna.tsinghua.edu.cn/rustup

crates.io 索引镜像

写入配置文件 ~/.cargo/config:

    [source.crates-io]replace-with='ustc'[source.ustc]registry="git://mirrors.ustc.edu.cn/crates.io-index"

参考资料:

• Rustup 镜像安装帮助
• Rust Crates 源使用帮助

Docker Hub

中科大提供了公开的 Docker Hub 仓库镜像，以下配置以中科大为例。其他国内的云厂商如 阿里云、 华为云等等都提供了 Docker Hub 镜像，需要用户自行注册账号，并且手工开通，使用是免费的。如果期望使用云厂商免费的 Docker Hub 镜像，替换下面的镜像地址为云厂商分配给用户的加速地址即可。

Linux

在 /etc/docker/daemon.json中加入:

    {"registry-mirrors": ["https://docker.mirrors.ustc.edu.cn/"]
}

重启服务即可。

MacOS

1. 打开 “Docker.app”
2. 进入偏好设置页面(快捷键 ⌘, )
3. 打开 “Daemon” 选项卡
4. 在 “Registry mirrors” 中添加 https://docker.mirrors.ustc.edu.cn/
5. 点击下方的 “Apply & Restart” 按钮

Windows

在系统右下角托盘 Docker图标内右键菜单选择 Settings，打开配置窗口后左侧导航菜单选择 Daemon。在 Registry mirrors一栏中填写地址 https://docker.mirrors.ustc.edu.cn/，之后点击 Apply保存后 Docker就会重启并应用配置的镜像地址了。

参考资料:

• Docker Hub 源使用帮助

Julia

创建 ~/.julia/config/startup.jl文件，写入以下内容:

    usingPkgpkg"activate."pkg"registryaddhttps://mirrors.ustc.edu.cn/julia/registries/General.git"pkg"instantiate"

参考资料:

• Julia Getting Started