讲师中心 微信公众号

工具推荐

视频效率加速
Laper
Laper

剧本策划到成片协作

AniShort
AniShort

AI短剧协同制作平台

updream

一键生成高质量推广成片

Seko
Seko

AI短剧一键生成成片

linux怎么配置pip使用国内镜像源加速模块安装

陌浩大大_6329

陌浩大大_6329

发布时间:2026-11-22 08:10:32

|

563人浏览过

|

来源于php中文网

原创

推荐用pip config命令一键永久配置国内镜像源,执行pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple和pip config set install.trusted-host pypi.tuna.tsinghua.edu.cn,自动创建并写入~/.pip/pip.conf。

linux怎么配置pip使用国内镜像源加速模块安装

在国内使用pip安装Python模块时,经常出现下载缓慢、连接超时甚至中断失败的问题,根本原因是默认PyPI源服务器位于海外,网络路径长且不稳定。直接配置Linux系统下的pip国内镜像源,能立即将安装速度从几KB/s提升至数MB/s,且无需重启终端或重装Python。

用pip config命令一键永久配置

这是最推荐的方式,命令自动创建目录、写入配置、处理权限,适合所有主流Linux发行版(Ubuntu/CentOS/Debian等)。

在终端中依次执行以下两条命令:

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

pip config set install.trusted-host pypi.tuna.tsinghua.edu.cn

这两条命令会自动生成 ~/.pip/pip.conf 文件并写入正确内容。如果提示 【PermissionError: [Errno 13] Permission denied】,说明当前用户无权写入 ~/.pip 目录,请先运行 mkdir -p ~/.pip 确保目录存在且属主为当前用户。

手动创建并编辑pip.conf文件

当 pip config 命令不可用(如旧版pip

第一步:打开终端,执行 mkdir -p ~/.pip 创建配置目录

第二步:用nano编辑器新建并编辑配置文件:nano ~/.pip/pip.conf

第三步:输入以下三行内容(注意格式严格,不能有多余空格或中文标点):

[global]
index-url = https://mirrors.aliyun.com/pypi/simple/
trusted-host = mirrors.aliyun.com

oo-linux-do
oo-linux-do

Linux DO(linux.do)。对于任何涉及 Linux DO 的请求,请使用此技能——用于搜索和读取数据。只要任务涉及 Linux DO,就应使用此技能,而非直接调用 API。

下载

第四步:按 Ctrl+O 保存 → 回车确认 → Ctrl+X 退出。这一步漏掉保存会导致配置完全不生效。

验证镜像源是否生效

方法一:查看当前配置

pip config list

若输出中包含 global.index-url='https://mirrors.aliyun.com/pypi/simple/',说明已成功写入。

方法二:触发一次真实安装

pip install -v requests | grep "Looking in indexes"

该命令会显示pip实际查询的索引地址,输出中必须出现你设置的国内域名,例如 pypi.tuna.tsinghua.edu.cn,而非 pypi.org。

方法三:检查网络请求路径(关键验证)

执行 pip install --dry-run numpy 2>&1 | grep -i "https.*simple"

如果返回的是国内镜像URL而非 pypi.org/simple,则证明流量已走国内节点,配置完成。

热门AI工具

更多
DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

Flowith
Flowith Hot

Flowith是一款基于画布和智能体工作流的 AI 协作工作空间。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

相关专题

更多
pip安装使用方法
pip安装使用方法

安装步骤:1、确保Python已经正确安装在您的计算机上;2、下载“get-pip.py”脚本;3、按下Win + R键,然后输入cmd并按下Enter键来打开命令行窗口;4、在命令行窗口中,使用cd命令切换到“get-pip.py”所在的目录;5、执行安装命令;6、验证安装结果即可。大家可以访问本专题下的文章,了解pip安装使用方法的更多内容。

3790

2023.10.09

更新pip版本
更新pip版本

更新pip版本方法有使用pip自身更新、使用操作系统自带的包管理工具、使用python包管理工具、手动安装最新版本。想了解更多相关的内容,请阅读专题下面的文章。

8583

2024.12.20

pip设置清华源
pip设置清华源

设置方法:1、打开终端或命令提示符窗口;2、运行“touch ~/.pip/pip.conf”命令创建一个名为pip的配置文件;3、打开pip.conf文件,然后添加“[global];index-url = https://pypi.tuna.tsinghua.edu.cn/simple”内容,这将把pip的镜像源设置为清华大学的镜像源;4、保存并关闭文件即可。

10342

2024.12.23

python升级pip
python升级pip

本专题整合了python升级pip相关教程,阅读下面的文章了解更多详细内容。

5507

2025.07.23

磁盘配额是什么
磁盘配额是什么

磁盘配额是计算机中指定磁盘的储存限制,就是管理员可以为用户所能使用的磁盘空间进行配额限制,每一用户只能使用最大配额范围内的磁盘空间。php中文网为大家提供各种磁盘配额相关的内容,教程,供大家免费下载安装。

4690

2023.06.21

如何安装LINUX
如何安装LINUX

本站专题提供如何安装LINUX的相关教程文章,还有相关的下载、课程,大家可以免费体验。

3913

2023.06.29

linux find
linux find

find是linux命令,它将档案系统内符合 expression 的档案列出来。可以指要档案的名称、类别、时间、大小、权限等不同资讯的组合,只有完全相符的才会被列出来。find根据下列规则判断 path 和 expression,在命令列上第一个 - ( ) , ! 之前的部分为 path,之后的是 expression。还有指DOS 命令 find,Excel 函数 find等。本站专题提供linux find相关教程文章,还有相关

3293

2023.06.30

linux修改文件名
linux修改文件名

本专题为大家提供linux修改文件名相关的文章,这些文章可以帮助用户快速轻松地完成文件名的修改工作,大家可以免费体验。

8170

2023.07.05

Navicat创建数据库教程
Navicat创建数据库教程

本专题整理Navicat创建数据库相关教程,介绍新建前的准备、基础设置和创建后的检查方法。内容兼顾入门学习及实际使用需求,帮助用户了解不同数据库类型下的操作差异,为后续建表、保存数据和日常管理提供参考。

0

2026.11.20

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Navicat 18 Linux 用户手册
Navicat 18 Linux 用户手册

共0课时 | 0人学习

安装 Xdebug 并配置 phpstorm
安装 Xdebug 并配置 phpstorm

共1课时 | 218人学习

ubuntu官方总文档
ubuntu官方总文档

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn