镜像加速配置

pip install 加速
uv 加速
docker pull 加速

什么是镜像加速

镜像加速是指通过使用国内的镜像服务器来替代官方的服务器（如 PyPI、Docker Hub），从而加快软件包或镜像的下载速度。由于网络延迟或防火墙等原因，直接访问国外服务器可能会很慢甚至失败，因此使用国内镜像可以显著提高效率。

pip install 加速

设置过程：

临时使用：pip install 包名 -i 镜像源
永久配置：在用户目录下创建或修改 pip 配置文件：~/.config/pip/pip.config，加入下面的配置

1 2	[global] index-url = 镜像源

或者使用 pip config set global.index-url 镜像源 命令设置全局镜像源。

稳定镜像源：

uv 加速

设置过程：

uv 安装包的命令是 uv pip install，很好记，在 pip install 前面加一个 uv。

由于 uv 默认不会读 pip.conf 这种类型的镜像配置，因此在国内的话，包的默认下载速度是比较慢的，需要手动加 -i 才能达到比较快的下载速度。设置过程和 pip install 加速 中的 1.临时使用 一样。

此外，uv 同样可以设置全局镜像源。在 Windows 系统上，可以通过以下几种方式修改 UV 的下载源：

通过环境变量修改：
1. 打开“此电脑”或“我的电脑”，右键点击选择“属性”。
2. 在弹出的窗口中选择“高级系统设置”。
3. 在“系统属性”窗口中，点击“环境变量”按钮。
4. 在“系统变量”或“用户变量”中点击“新建”：
  1. 变量名：UV_DEFAULT_INDEX
  2. 变量值：镜像源地址，例如 https://pypi.tuna.tsinghua.edu.cn/simple/。
5. 点击 “确定” 保存设置。
通过配置文件修改：
1. 用户级别配置文件：
  - 文件路径：%APPDATA%\uv\uv.toml
  - 在该文件中添加以下内容：
    1
    2
    3
    [[index]]
    url = "https://pypi.tuna.tsinghua.edu.cn/simple/"
    default = true
    根据https://github.com/astral-sh/uv/issues/6925，似乎应该是
    1
    index-url = "https://pypi.tuna.tsinghua.edu.cn/simple/"
    不过没有具体实验过，使用“通过环境变量修改”的方法就行，在 Linux 环境中再用这个方法。
2. 项目级别配置文件：
  - 文件路径：项目目录下的 pyproject.toml 或 uv.toml。
  - 在 pyproject.toml 中添加：
    1
    2
    3
    [[tool.uv]]
    index-url = "https://pypi.tuna.tsinghua.edu.cn/simple/"
    default = true
    或在 uv.toml 中添加：
    1
    2
    3
    [[index]]
    url = "https://pypi.tuna.tsinghua.edu.cn/simple/"
    default = true
通过命令行临时指定：
在命令行中运行 UV 命令时，可以直接指定镜像源：uv add requests --default-index https://pypi.tuna.tsinghua.edu.cn/simple

建议：如果不确定设置的全局镜像源能否生效，那么使用 uv pip install 包名 -i 镜像源 或者 uv add 包名 --default-index 镜像源 的方式是最稳妥的。

注意：

uv pip install 命令是兼容 pip 的命令，主要是为了让你能像在 pip 下一样下载依赖包，它只会把依赖装到当前虚拟环境（或全局环境）里，但是**不会更新 uv.lock，也不会修改 pyproject.toml**，就相当于 pip install，只是走了 uv 的下载/构建/缓存机制。
uv add 是 uv 的原生命令，用来“正式”管理依赖，它会安装依赖到环境里，并将依赖写入 pyproject.toml，会更新 uv.lock，保证依赖树被记录。

稳定镜像源：

docker pull 加速

设置过程：通过修改 daemon 配置文件 /etc/docker/daemon.json 来使用加速器：

如果 docker 目录不存在的话，首先创建 docker 目录：sudo mkdir -p /etc/docker
通过修改 /etc/docker/daemon.json 文件配置镜像源：

{
  "registry-mirrors": [
    "镜像源1",
    "镜像源2",
    "镜像源3",
  ]
}

稳定镜像源：

https://docker.1ms.run