转载

每个开发都会用到的国内开发资源镜像配置

国内的开发人员难免都会遇到需要配置国内开发资源镜像的需求（比如，maven 库和 pip 包等），要不然等待你的就是一个漫长的资源下载过程 ……

鉴于此，抽时间将我们团队常用的开发资源的镜像进行了整理汇总，方便他人参考，省得每次都要口头转述。本文以全局镜像配置为主，即配置在全局的路径下，所有的项目均受影响。像 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:

每个开发都会用到的国内开发资源镜像配置

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

每个开发都会用到的国内开发资源镜像配置

注: 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 环境)文件，写入以下内容：

每个开发都会用到的国内开发资源镜像配置

参考资料:

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

执行命令:

每个开发都会用到的国内开发资源镜像配置

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

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

每个开发都会用到的国内开发资源镜像配置

参考资料:

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

PyPI

执行命令:

参考资料:

pip user guide
pip config

Anaconda

执行命令:

每个开发都会用到的国内开发资源镜像配置

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

参考资料:

清华大学镜像站

Vagrant

通过镜像站安装插件:

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

通过镜像站下载 box:

每个开发都会用到的国内开发资源镜像配置

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

参考资料:

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

rustup

设置环境变量:

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

crates.io 索引镜像

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

每个开发都会用到的国内开发资源镜像配置

参考资料:

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

Docker Hub

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

Linux

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

每个开发都会用到的国内开发资源镜像配置

重启服务即可。

MacOS

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

Windows

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

参考资料: