Conda 镜像源配置指南
适用系统:Windows 10(含 Miniconda / Anaconda) & Linux(Ubuntu / CentOS / Debian 等)
1. 为什么要设置镜像源
在中国大陆直接访问 repo.anaconda.com 经常遇到速度慢、连接超时、SSL 错误等问题。把默认源替换为国内镜像,可提升 5-20 倍下载速度。
2. 通用思路
- 找到 Conda 的配置文件
.condarc- Windows:
C:\Users\<用户名>\.condarc - Linux:
~/.condarc(即/home/<用户名>/.condarc)
- Windows:
- 修改或新建
.condarc,写入镜像通道地址。 - 清除索引缓存,验证生效。
3. 一键命令行配置(推荐)
打开 终端(Win:Anaconda Prompt / PowerShell;Linux:bash/zsh),复制粘贴即可。
3.1 清华镜像(最常用)
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 --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/pytorch
conda config --set show_channel_urls yes
说明:
如你使用的是 PyTorch、TensorFlow 等特定框架,建议额外添加它们的专用镜像通道,例如:
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/pytorch
3.2 中科大镜像
conda config --add channels https://mirrors.ustc.edu.cn/anaconda/pkgs/main
conda config --add channels https://mirrors.ustc.edu.cn/anaconda/pkgs/free
conda config --add channels https://mirrors.ustc.edu.cn/anaconda/cloud/conda-forge
conda config --set show_channel_urls yes
3.3 阿里云镜像
conda config --add channels https://mirrors.aliyun.com/anaconda/pkgs/main
conda config --add channels https://mirrors.aliyun.com/anaconda/pkgs/free
conda config --add channels https://mirrors.aliyun.com/anaconda/cloud/conda-forge
conda config --set show_channel_urls yes
4. 手动编辑 .condarc(备用方案)
如果命令行修改失败,可手动创建/编辑文件,内容如下:
channels:
- https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main
- https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free
- https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/conda-forge
- https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/pytorch
- defaults
show_channel_urls: true
保存后关闭即可。
5. 验证是否成功
conda config --show channels
应看到类似输出:
channels:
- https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main
- https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free
- ...
6. 清理缓存(确保立即生效)
conda clean -i
7. 恢复默认官方源
conda config --remove-key channels
8. 常见问题 FAQ
| 问题 | 解决方案 |
|---|---|
| CondaHTTPError / SSLError | 检查公司/校园网代理,或改用 HTTP 镜像(如 http:// 而非 https://)。 |
| 镜像未生效 | 确认 .condarc 路径正确,未存在同名文件冲突。 |
| 找不到特定包 | 添加对应 cloud 频道,例如 conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/bioconda。 |
9. 附录:常用镜像列表
| 镜像源 | 主页 | 说明 |
|---|---|---|
| 清华大学 | https://mirrors.tuna.tsinghua.edu.cn/help/anaconda/ | 最全,更新快 |
| 中国科技大学 | https://mirrors.ustc.edu.cn/anaconda/ | 稳定 |
| 北京外国语大学 | https://mirrors.bfsu.edu.cn/help/anaconda/ | 教育网友好 |
| 阿里云 | https://developer.aliyun.com/mirror/anaconda | 企业网络友好 |