使用nginx搭建creates.io镜像的教程详解

更新时间：2023年12月26日 08:32:13 作者：Skyer119

在Rust开发中,经常需要使用Cargo从crates.io下载依赖,而国内几乎没有好用的crates.io镜像,使用本文就来使用使用nginx搭建creates.io镜像吧

在Rust开发中，经常需要使用Cargo从crates.io下载依赖，而国内几乎没有好用的crates.io镜像，大多都只对crates.io-index和crates.io进行了镜像，而最重要的static.crates.io却没有镜像。迫不得已只能自己搭建。众所周知，Cargo下载依赖，实际分为三步：

获取索引（Fetch index）
查询下载路径（Redirect location）
下载资源（*.crate文件）

因此，搭建crates.io镜像也需要分为三个模块：

crates.io-index
crates.io
static.crates.io

零、启用nginx的缓存功能

注：此处均为与搭建creates.io镜像相关的配置项

http {
  # 开启全局缓存，并配置存储路径(/var/lib/crates.io)和大小(32g)
  proxy_cache_path /var/lib/crates.io keys_zone=STATIC:100m levels=1:2 inactive=120h max_size=32g;
}

一、缓存creates.io

server {
  listen 7011;
  location / {
    proxy_pass https://crates.io;
    proxy_ssl_server_name on;
    proxy_buffering on;
    proxy_cache STATIC;
    proxy_cache_valid 301 302 307 308 72h;
    proxy_cache_valid any 10s;
    proxy_cache_revalidate on;
    proxy_cache_use_stale error timeout invalid_header updating http_500 http_502 http_503 http_504;
    proxy_redirect https://static.crates.io/ http://$host:7012/;
  }
}

此处，我们将http://localhost:7011反向代理到https://crates.io，并对结果进行缓存。其中状态码为301,302,307,308的缓存72小时，其余状态码缓存10秒。

二、缓存static.crates.io

server {
  listen 7012;
  location / {
    proxy_pass https://static.crates.io;
    proxy_ssl_server_name on;
    proxy_buffering on;
    proxy_cache STATIC;
    proxy_cache_valid 200 72h;
    proxy_cache_valid 400 502 504 10s;
    proxy_cache_valid any 1m;
    proxy_cache_revalidate on;
    proxy_cache_use_stale error timeout invalid_header updating http_500 http_502 http_503 http_504;
  }
}

此处，我们将http://localhost:7012反向代理到https://static.crates.io，并对结果进行缓存。

需要注意到在缓存creates.io 部分，proxy_redirect参数，就是将原本重定向目标从https://static.crates.io/修改为http://$host:7012/

三、缓存creates.io-index

在前几步中，我们已经将一个creates.io镜像的内容部分搭建完毕，最后就是索引，众所周知，crates.io是使用git仓库 https://github.com/rust-lang/crates.io-index.git 作为官方索引的，因此我们只需要将这个仓库clone到本地

cd /home/ # 此处将索引clone到/home目录下
git clone https://github.com/rust-lang/crates.io-index.git

然后修改/home/crates.io-index/config.json，将https://crates.io修改为我们刚刚的代理地址http://localhost:7011，除了lo地址也可以用本机的其他ip地址。

sed -i 's+https://crates.io+http://localhost:7011+g' /home/crates.io-index/config.json

最后依然是nginx配置：

server {
  listen 7010;
  location /crates.io-index/ {
    root /home;
  }
}

以上，一个镜像源就配置完成啦~~~

四、在开发环境配置镜像源

修改HOME目录下的.cargo/config.toml文件（也可以是不带后缀名的config文件）如果没有就新建一个。

Linux/Unix系统为 $HOME/.carog/config.toml

Windows系统为 $USERPROFILE/.carog/config.toml

内容为：

[source.crates-io]
replace-with = 'local'
[source.local]
registry = "sparse+http://localhost:7010/crates.io-index/"

五、写在最后

目前能够找到的搭建creates.io镜像源的文章，全部都是使用基于git over https的传统方式，本篇文章则是采用最新的sparse稀疏索引方式，大幅加快获取包的速度，搭建过程更加便捷。

另外，对于索引的更新，可以通过shell脚本+crontab定时任务来完成自动更新：

#!/usr/bin/sh
cd /home/crates.io-index/
git pull

保存为/home/crates.io-index/update-index.sh，并添加执行权限：

chmod 755 /home/crates.io-index/update-index.sh

添加定时任务：

# crontab -e
0 * * * * /home/crates.io-index/update-index.sh > /home/crates.io-index/update-index.log 2>&1 &

到此这篇关于使用nginx搭建creates.io镜像的教程详解的文章就介绍到这了,更多相关nginx搭建creates.io镜像内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

定期删除OpenResty/Nginx大日志文件的方法
这篇文章主要介绍了定期删除OpenResty/Nginx大日志文件的方法,文中通过代码示例给大家讲解的非常详细,对大家的学习或工作有一定的帮助,需要的朋友可以参考下
2024-05-05
nginx代理转发报错405 Method Not Allowed解决
这篇文章主要为大家介绍了解决nginx代理转发报错405 Method Not Allowed解决方法详解，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪
2023-08-08
Nginx如何限制IP访问只允许特定域名访问
我们在使用的时候会遇到很多的恶意IP攻击,这个时候就要用到Nginx 禁止IP访问了,下面这篇文章主要给大家介绍了关于Nginx如何限制IP访问只允许特定域名访问的相关资料,需要的朋友可以参考下
2022-07-07
nginx文件强制下载的配置方法
这篇文章主要介绍了nginx文件强制下载的配置方法,需要的朋友可以参考下
2016-02-02
全面解析Nginx到底能做什么
本文只针对Nginx在不加载第三方模块的情况能处理哪些事情，由于第三方模块太多所以也介绍不完，当然本文本身也可能介绍的不完整，具体内容详情大家跟随小编一起通过本文学习吧
2018-10-10
详解nginx代理天地图做缓存解决跨域问题
这篇文章主要介绍了详解nginx代理天地图做缓存解决跨域问题，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2018-08-08
Nginx实现异步访问mysql的配置方法
这篇文章主要介绍了Nginx实现异步访问mysql的配置方法,本文先是讲解了安装配置方法,然后给出了使用方法,需要的朋友可以参考下
2015-06-06
linux下nginx负载均衡搭建的方法步骤
本篇文章主要介绍了linux下nginx负载均衡搭建的方法步骤，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2018-04-04
为什么 Nginx 比 Apache 更牛
为什么Nginx在处理高并发方面要优于httpd，我们先从两种web服务器的工作原理以及工作模式说起。对Nginx对比 Apache的相关知识感兴趣的朋友跟随小编一起看看吧
2021-02-02
同一台服务器安装多个Nginx的方法总结
在同一台服务器上安装多个nginx完全没有问题，但有些地方是需要注意的，这篇文章为大家整理了一些常会遇到的问题以及解决方法，需要的可以参考一下
2023-08-08