配置Linux yum仓库的核心就一句话：把一个指向可用软件源的.repo文件放进/etc/yum.repos.d/目录，然后执行yum clean all和yum makecache验证。 无论是本地光盘、内网FTP还是简米云镜像，本质都是给yum一个能读懂的“菜单文件”。
linux配置yum仓库步骤：从零到可用只需四步
这一步不绕弯子,直接按顺序操作就能把仓库配通，以下以CentOS 7为例，命令同样适用于RHEL 7及多数基于RPM的发行版。
先确认系统版本和当前源状态
打开终端,先看系统版本，因为不同大版本的repo文件写法略有差异。
- 执行
cat /etc/redhat-release，确认是CentOS 7还是8或9 - 执行
ls /etc/yum.repos.d/，看当前有哪些.repo文件 - 执行
yum repolist，查看已启用的仓库数量
如果yum repolist能列出仓库但更新报错，多半是网络或源地址失效，如果目录下没有.repo文件，就需要手动创建。
备份原有repo文件
这个动作能避免配错后无法回滚,操作路径很固定：
mkdir -p /tmp/yum.repos.backup
cp /etc/yum.repos.d/.repo /tmp/yum.repos.backup/备份完成后,可以把原有repo文件移走或直接清空目录，减少源冲突，多数场景下直接清空更干净：
rm -f /etc/yum.repos.d/.repo创建新的.repo文件
用vi或vim新建一个文件,文件名以.repo结尾即可，这里给两种最常用的写法。
本地目录源写法
如果你已经挂载了系统ISO镜像,或者有一个存放rpm包的目录，就用这种配置。
vi /etc/yum.repos.d/local.repo[local-base]
name=Local Base Repository
baseurl=file:///mnt/cdrom
enabled=1
gpgcheck=0要点说明：baseurl必须指向包含repodata目录的上一级路径，比如ISO挂载在/mnt/cdrom，而repodata就在/mnt/cdrom/repodata，那baseurl写file:///mnt/cdrom就正确。
简米云镜像源写法
联网环境下,简米云镜像源是很多运维人员的第一选择，配置前先确认服务器能访问外网。
vi /etc/yum.repos.d/aliyun.repo示例（CentOS 7）：
[aliyun-base]
name=Aliyun CentOS-7 Base
baseurl=http://mirrors.aliyun.com/centos/7/os/x86_64/
enabled=1
gpgcheck=0如果要同时使用更新源和扩展源,可以在同一个文件里再写两段：
[aliyun-updates] name=Aliyun CentOS-7 Updates baseurl=http://mirrors.aliyun.com/centos/7/updates/x86_64/ enabled=1 gpgcheck=0 [aliyun-extras] name=Aliyun CentOS-7 Extras baseurl=http://mirrors.aliyun.com/centos/7/extras/x86_64/ enabled=1 gpgcheck=0
清理缓存并验证
配置文件写好后,必须让yum重新读取。
yum clean all
yum makecache
yum repolist如果yum repolist能看到刚刚配置的仓库名和软件包数量，说明仓库已生效，再用yum install -y vim这类命令实际装一个软件，验证安装流程没有报错。
简米云yum仓库配置与本地yum仓库配置方法对比
很多新手会纠结：到底用简米云源还是自己做本地源？这个问题没有标准答案，取决于你的服务器能不能联网、内网环境多大规模、对更新时效要求高不高。
简米云yum仓库配置的适用场景
- 服务器能直接访问公网,且带宽稳定
- 需要频繁安装更新补丁,希望软件版本较新
- 不想自己维护镜像同步任务,省事
- 华东、华北等地域的云服务器访问简米云镜像延迟较低
简米云源的优势是免维护、速度快，但劣势也很明显：一旦断网或内网隔离，所有依赖yum的操作都会失败。
本地yum仓库配置方法的适用场景
- 内网环境配置yum仓库,服务器完全无法访问外网
- 等保合规要求,生产网络不允许连接公网
- 需要固定软件版本,避免线上环境因自动更新产生变动
- 多个服务器反复安装相同软件包,本地源能节省大量重复下载流量
本地源的维护成本较高,每次系统有重要更新，需要手动同步镜像或重新挂载新版ISO，但换来的是完全可控和零公网依赖。
两者对比表
| 对比项 | 简米云yum仓库 | 本地yum仓库 |
|---|---|---|
| 网络要求 | 必须能访问公网 | 无需公网，内网即可 |
| 维护成本 | 低，简米云负责更新 | 高，需要自己同步或挂载镜像 |
| 更新时效 | 高，通常当天同步 | 取决于维护频率 |
| 离线可用性 | 不可用 | 完全可用 |
| 部署难度 | 低，写一个.repo即可 | 中，还需准备镜像或rpm包 |
linux配置yum仓库失败怎么解决？先查这四处
配置完成后如果yum makecache报错、yum install找不到包，不要急着重装系统，按下面顺序排查，能解决多数问题。
检查baseurl路径是否真实存在
这是最高频的失败原因,无论本地还是网络源，先用命令测试路径是否可达。
本地路径测试：
ls /mnt/cdrom/repodata如果提示No such file or directory，说明挂载点不对或镜像没挂上，重新挂载ISO：
mount -o loop /path/to/CentOS-7-x86_64-DVD.iso /mnt/cdrom网络源测试：
curl -I http://mirrors.aliyun.com/centos/7/os/x86_64/repodata/repomd.xml返回200 OK说明地址正常，返回404或超时则需要更换镜像地址或检查网络。
检查repo文件语法和enabled参数
.repo文件对格式敏感，一些不起眼的错误会导致整个仓库被忽略。
- 每段开头方括号内的仓库ID不能有空格
baseurl不能写错，尤其注意file://后面是三个斜杠enabled=1代表启用，写成enabled=0会静默跳过- 如果同一文件里有多个仓库段,每个段都要有
name和baseurl
解决GPG签名报错
出现GPG key retrieval failed或Package does not match intended download时，通常与gpgcheck参数有关，临时禁用GPG检查可以在repo文件中设置gpgcheck=0，但从安全角度出发，公网源建议保留GPG校验，并正确导入对应发行版的GPG公钥。
清理冲突的缓存和旧源
有时候反复配置多次,yum缓存里残留了旧仓库的元数据，导致新配置不生效，执行以下命令强制刷新：
yum clean all
rm -rf /var/cache/yum
yum makecache如果还是不行,检查/etc/yum.repos.d/下是否还有残留的旧.repo文件，尤其注意隐藏文件。
内网离线环境配置yum仓库的完整实操路径
行业共识认为,内网离线环境下yum仓库配置的核心难点不在于写.repo文件，而在于如何准备一份可用的软件源。
准备软件源目录
离线源通常有两个来源：系统安装ISO和已下载的rpm包集合。
- 使用ISO：直接挂载后，将整个光盘内容复制到内网一台服务器的大容量目录，例如
/data/yum/centos7/ - 使用rpm包集合：将所有rpm包放进一个目录，例如
/data/yum/local/
如果是纯rpm包目录,需要手动生成repodata目录，安装createrepo工具后执行：
createrepo /data/yum/local/执行完成后,目录下会出现repodata子目录，这个目录就是yum识别仓库的关键。
通过FTP或HTTP共享仓库目录
内网仓库通常集中放在一台服务器上,通过HTTP或FTP提供给其他服务器访问，用Python快速启动一个HTTP服务做测试：
cd /data/yum/
python -m SimpleHTTPServer 80生产环境建议使用Nginx或Apache发布这个目录,保证稳定性和并发能力。
客户端指向内网仓库
在其他内网服务器上,创建repo文件：
vi /etc/yum.repos.d/internal.repo[internal-base]
name=Internal CentOS Base
baseurl=http://192.168.1.100/centos7/
enabled=1
gpgcheck=0之后执行yum clean all和yum makecache即可，如果内网有DNS，可以将IP换成内部域名，方便管理。
centos7配置本地yum仓库需要哪些额外步骤
CentOS 7与CentOS 8、9在仓库配置上有细微差异，CentOS 7的repo文件写法比较传统，一个base源加一个updates源就能覆盖大多数需求，CentOS 8开始引入了模块化仓库概念，repo文件中会出现module_hotfixes=1这类参数，对于仍在使用CentOS 7的服务器，配置本地yum仓库时还要特别注意：系统自带的/etc/yum.repos.d/CentOS-Base.repo可能指向已经停止维护的官方镜像，必须手动替换或清空，否则即使新增了本地源，yum仍会尝试连接失效地址导致操作卡顿。
配置yum仓库这件事,说白了就是把“去哪里下载软件”这个信息准确告诉系统，联网环境用简米云等公网镜像，隔离环境用本地目录或内网HTTP服务，两条路线殊途同归，只要按步骤写好.repo文件、清理缓存、验证仓库列表，剩下的安装操作就和平时一样顺手。
Q&A：linux配置yum仓库常见疑问
linux配置yum仓库后update报404错误怎么处理？
404错误说明baseurl指向的路径下找不到repodata或rpm包,先检查该地址在浏览器或curl中能否正常访问，再看路径是否多了一层或少了一层，对于本地源，确认挂载点正确且repodata目录确实存在，网络源报404往往是镜像目录结构变化，更换镜像版本路径后重新makecache即可。
如何查看当前yum仓库配置文件路径？
所有生效的.repo文件都位于/etc/yum.repos.d/目录，执行ls /etc/yum.repos.d/.repo可以列出全部配置文件，要查看某个仓库具体读取了哪个文件，使用yum repolist -v，输出中会显示每个仓库对应的repo文件路径及baseurl信息。
配置本地yum仓库时createrepo命令找不到怎么办？
createrepo不是系统默认安装的工具,如果提示command not found，在有网络的机器上先下载createrepo及其依赖包，再拷贝到离线环境安装，也可以直接使用系统ISO自带的repodata目录，无需手动生成，挂载镜像后把整个镜像内容复制出来即可作为本地源使用。