Python配置代理与镜像源完整指南

叶初
叶初
发布时间:2026-10-13| 6人浏览过
原创

本文详细介绍如何在Python环境中配置网络代理和添加国内镜像源,以解决pip和conda下载缓慢或连接失败的问题。内容涵盖Windows与Linux系统下的临时、永久代理设置方法,以及pip和conda的镜像源配置步骤,附带配置文件路径说明和常见命令示例,帮助用户显著提升模块安装效率。

修改镜像源与设置代理的原因

修改镜像源的原因

在使用Python安装库时,通常执行pip install xxx或conda install xxx命令。由于pip和conda默认指向国外镜像源,下载过程需从Python官方源pypi.python.org/pypi获取资源,这往往导致下载速度极慢,甚至因超时抛出异常而安装失败。因此,选择稳定且快速的国内镜像源来下载Python库,可以显著加快模块安装速度。

设置代理的必要性

当计算机因公司安全策略限制无法直接访问外网时,必须通过设置代理来联网;通常企业要求通过代理访问外网以保障网络安全。此外,若国外官方pypi源被屏蔽导致不可用,也可通过设置代理来恢复访问。

注意:pip与conda修改镜像源的方式存在差异

配置文件路径与准备

配置文件准备

在设置代理和添加镜像源之前,需先检测配置文件是否存在,若不存在则需手动创建。不同操作系统下配置文件的路径有所不同:

1). Unix系统:$HOME/.config/pip/pip.conf

2). Mac系统:$HOME/Library/Application Support/pip/pip.conf

3). Windows系统:%APPDATA%\pip\pip.ini,其中%APPDATA%代表实际路径,例如C:\Users\user_xxx\AppData\Roaming。可在cmd命令行中执行echo %APPDATA%命令查看具体路径。

补充说明:

1). 所有pip命令行参数均可在配置文件中定义为默认值!

2). 使用which pip命令可定位pip的安装位置(例如:/usr/local/bin/pip)。

pip设置代理的方法

pip设置代理方法

1). 单次设置(Windows和Linux系统通用):

直接在pip命令后指定代理即可:pip install some-package --proxy=http:// 代理服务器IP:端口号

pip install pandas --proxy=http://10.20.217.2:8080

2). 临时设置(重启终端或重连后失效):

(1). Linux系统下(在终端直接运行):

export http_proxy='http://代理服务器IP:端口号port' export https_proxy='http://代理服务器IP:端口号port'


 export http_proxy=http://109.123.111.111:8000
 export https_proxy=http://109.123.111.111:8000

(2). Windows系统下(在终端直接运行):

set http_proxy='http://代理服务器IP:端口号port'

set http_proxy='http://代理服务器IP:端口号port'


set http_proxy=http://109.123.111.111:8000
set https_proxy=http://109.123.111.111:8000

注意:设置代理后,使用ping命令可能仍无法连接外网,但pip命令可以正常使用。这是因为ping使用的协议与代理支持的协议不同,无法通过该代理进行通信。

3). 永久设置(需修改配置文件):

(1). Linux系统下,打开pip.conf配置文件并添加以下内容:

[global]

proxy=http://xxx.xxx.xxx.xxx:8080 # 替换为自己的代理地址


  # 在.pip目录创建并编辑pip.conf(没有配置文件时)
  mkdir ~/.pip   # 创建pip文件夹
  cd ~/.pip     # 创建pip.conf文件 
  vi pip.conf    # 打开pip.conf文件 
  # 按i进入编辑模式:
  [global]
  proxy=http://10.20.217.2:8080
 # 按ESC键,再输入wq保存即可。

(2). Windows系统下,打开pip.ini配置文件并添加以下内容:

[global]

proxy=http://xxx.xxx.xxx.xxx:8080


 # 在pip目录创建并编辑pip.ini(配置文件不存在时)
 cd C:\Users\(你的用户名)  
 mkdir pip        # 创建pip文件夹
 cd pip           # 进入pip路径目录下
 cd.>pip.ini       # 创建pip.ini文件
 # 然后打开C:\Users(用户名)\pip\pip.ini,添加如下内容:
 [global]
 proxy=http://10.20.217.2:8080

补充:在Linux系统下,也可在/etc/profile配置文件中永久设置代理。


vim /etc/profile:
  export http_proxy='http://代理服务器IP:端口号'
  export https_proxy='http://代理服务器IP:端口号'
source /etc/profile

pip添加镜像源的方法

pip添加镜像源方法

1). 单次设置(Windows和Linux系统通用):

直接在pip命令后指定镜像源即可:pip install some-package -i 镜像地址


 pip install pandas -i https://mirrors.aliyun.com/pypi/simple/

2). 永久设置:

(1). Linux系统下,打开pip.conf配置文件并添加以下内容:

[global]

index-url = 镜像地址


 # 在.pip目录创建并编辑pip.conf(没有配置文件时)
 mkdir ~/.pip   # 创建pip文件夹
 cd ~/.pip     # 创建pip.conf文件 
 vi pip.conf    # 打开pip.conf文件 
 # 按i进入编辑模式:
 [global]
 index-url = https://pypi.mirrors.ustc.edu.cn/simple/
 # 按ESC键,再输入wq保存即可。

(2). Windows系统下,打开pip.ini配置文件并添加以下内容:

[global]

index-url = 镜像地址


 cd C:\Users\(你的用户名)  
 mkdir pip        # 创建pip文件夹
 cd pip           # 进入pip路径目录下
 cd.>pip.ini       # 创建pip.ini文件
 # 然后打开C:\Users(用户名)\pip\pip.ini,添加如下内容:
 [global]
 index-url = https://pypi.mirrors.ustc.edu.cn/simple/

pip一次性添加镜像和设置代理示例


 pip install -i https://pypi.douban.com/simple pandas --proxy=http://10.20.217.2:8080

pip永久添加镜像和设置代理示例


# 打开相应的配置文件添加如下内容,(pip安装需要使用的https加密时,在此需要添加trusted-host)
 [global]
 index-url = http://mirrors.aliyun.com/pypi/simple/ # 这里使用的是阿里云的镜像源
 proxy=http://xxx.xxx.xxx.xxx:8080          # 替换出自己的代理地址
 [install]
 trusted-host=mirrors.aliyun.com           # 信任阿里云的镜像源,否则会有警告

conda设置代理与镜像源

conda设置代理和添加镜像源

只需在.condarc配置文件中设置即可(Windows和Linux系统均使用此文件)。一般情况下,.condarc文件位于Windows系统的C:\Users\<username>\目录下,找到该文件并打开修改;在Linux系统下,可在终端输入vim ~/.condarc命令打开此文件。

如果文件不存在,请手动创建。创建.condarc文件的命令如下:

 conda config --add channels r

.condarc文件配置内容详解如下:


 # Add mirror source to speed up download
 channels:
  - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/  # (根据需求添加合适的镜像源)
  - defaults
 # Show channel URLs when displaying what is going to be downloaded and in ‘conda list‘
 show_channel_urls: true
 allow_other_channels: True 
 # Set the agent
 proxy_servers:
  http: http://xxx.xxx.xxx.xxx:8080
  https: https://xxx.xxx.xxx.xxx:8080
 # 设置verify=False移除SSL认证时,解决InsecureRequestWarning警告
 ssl_verify: false

conda查看源和代理修改是否成功的指令:


 conda info            # 查看源设置的是否有效(channel urlsd的变化) 
conda config --show       # 指令查看相关信息 
 conda config --show-sources   # 查看配置文件的位置

总结

以上介绍了Python设置代理和添加镜像源的方法,希望对大家有所帮助,也非常感谢大家对本站网站的支持!

相关标签:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。