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 | 企業網絡友好 |