软件源配置

本文介绍如何配置国内软件源，加速软件包下载。

pip 源配置

临时使用

pip install package_name -i https://pypi.tuna.tsinghua.edu.cn/simple

永久配置

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

常用国内源

源名称	地址
清华源	https://pypi.tuna.tsinghua.edu.cn/simple
阿里源	https://mirrors.aliyun.com/pypi/simple
中科大源	https://pypi.mirrors.ustc.edu.cn/simple
豆瓣源	https://pypi.douban.com/simple

配置文件方式

创建或编辑 ~/.pip/pip.conf：

[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
trusted-host = pypi.tuna.tsinghua.edu.cn

conda 源配置

添加清华源

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

配置文件方式

编辑 ~/.condarc：

channels:
  - https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/conda-forge
  - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main
  - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free
  - defaults
show_channel_urls: true

恢复默认源

conda config --remove-key channels

apt 源配置

备份原配置

cp /etc/apt/sources.list /etc/apt/sources.list.bak

使用清华源（Ubuntu 20.04）

cat > /etc/apt/sources.list << 'EOF'
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal main restricted universe multiverse
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal-updates main restricted universe multiverse
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal-backports main restricted universe multiverse
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal-security main restricted universe multiverse
EOF

使用清华源（Ubuntu 22.04）

cat > /etc/apt/sources.list << 'EOF'
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy main restricted universe multiverse
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-updates main restricted universe multiverse
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-backports main restricted universe multiverse
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-security main restricted universe multiverse
EOF

更新软件包列表

apt update

npm 源配置

临时使用

npm install package_name --registry=https://registry.npmmirror.com

永久配置

npm config set registry https://registry.npmmirror.com

验证配置

npm config get registry

Docker 源配置

配置镜像加速

编辑 /etc/docker/daemon.json：

{
  "registry-mirrors": [
    "https://docker.mirrors.ustc.edu.cn",
    "https://hub-mirror.c.163.com"
  ]
}

重启 Docker

systemctl daemon-reload
systemctl restart docker

常见问题

源连接超时

尝试切换其他源，或检查网络连接。

HTTPS 证书问题

# pip 信任主机
pip install package_name -i https://pypi.tuna.tsinghua.edu.cn/simple --trusted-host pypi.tuna.tsinghua.edu.cn

源不包含某些包

某些包可能不在国内源中，可临时使用官方源：

pip install rare_package -i https://pypi.org/simple