首页/系统/信创系统运维速查/openEuler 官方源配置
命令与包管理65 条

openEuler 官方源配置

openEuler 源文件为 /etc/yum.repos.d/openEuler.repo,指向 repo.openeuler.org;内网环境换成镜像站地址后清理缓存再验证。

信创系统运维速查系统更新于 2026-10-13

openEuler 的源怎么组织

openEuler 用 dnf 管理软件,源文件放在 /etc/yum.repos.d/ 下,官方提供的主文件是 openEuler.repo,指向 repo.openeuler.org。官方站按版本目录组织(如 openEuler-22.03-LTS、24.03-LTS),再按 x86_64 / aarch64 分架构,因此 baseurl 里的版本号与架构必须与实际系统一致。内网部署时把地址换成单位镜像站,清缓存后再刷新即可。

基本信息

源文件位置/etc/yum.repos.d/(官方常为 openEuler.repo)
官方地址https://repo.openeuler.org/<版本>/
添加仓库dnf config-manager --add-repo <url>
版本变量$releasever、$basearch 由 dnf 展开
生效流程改源 → dnf clean all → dnf makecache → 装包验证
权限要求root 或 sudo

典型使用场景

  • 新装 openEuler 后补齐官方源,安装运维工具链
  • 内网隔离环境改为单位镜像站地址
  • 需要 EPOL 或更新源里的额外软件包时追加对应仓库
  • 排查装包失败时确认仓库是否启用、地址是否可达
  • 跨版本升级前把源指向目标版本目录

追加官方源并刷新

追加官方源并刷新
cat /etc/os-release                        # 确认实际版本号,别照抄示例
dnf config-manager --add-repo https://repo.openeuler.org/openEuler-24.03-LTS/OS/$basearch/
# 上面这条会生成一个 .repo 文件;版本号与 $basearch 必须与系统匹配,否则 404
dnf clean all && dnf makecache             # 清缓存并重建元数据
dnf repolist -v | head -20                 # 核对仓库启用状态与包数量
dnf install -y tree                        # 端到端验证

内网镜像与多仓库

内网镜像与多仓库
grep -R '^baseurl' /etc/yum.repos.d/ | head        # 查看现有源地址
sed -i 's|https://repo.openeuler.org|http://mirror.intra.local/openeuler|g' /etc/yum.repos.d/openEuler.repo
# 内网镜像需与版本目录结构一致,路径层级不要自行改写
dnf repolist --all | grep -i disabl                # 检查是否有仓库被禁用
systemctl is-active chronyd                        # 时间偏差过大会影响 HTTPS 证书校验

仓库字段读法

字段含义注意点
[repo-id]仓库标识,出现在 dnf 输出里重名会互相覆盖
name仓库显示名便于在 repolist 中辨识
baseurl仓库根地址,含版本与架构层级写错表现为 404
enabled是否启用,1 为启用为 0 时 dnf 完全看不到该源
gpgcheck / gpgkey签名校验开关与公钥官方源应保持开启
priority多仓库优先级同包多源时优先级决定候选版本
URL 里的 $releasever 与 $basearch 由 dnf 自动展开:写完后用 dnf repolist -v 看实际取值,变量展开结果与目录不符时会 404。
不要同时保留多个大版本(如 22.03-LTS 与 24.03-LTS)的源:同名包版本会在不同来源之间跳变,依赖解析结果不可预测。

易错点

  • 照抄文档里的版本号而不是按本机实际版本配置,baseurl 直接 404,却容易误判为镜像站不可用
  • 同时混用多个 LTS 版本的源,dnf 解析出的候选包版本跳变,升级路径变得不可控
  • 把内网镜像站的路径结构改写得更『整齐』,与镜像实际目录层级不一致,导致元数据取不到
  • 改源后不清缓存直接装包,dnf 仍用旧元数据,出现『新源里明明有包却装不上』
  • 系统时间偏差过大导致 HTTPS 源证书校验失败,报错看起来像源站故障,实际是时间同步没做

数据来源与参考

  • openEuler 官方文档(镜像站使用)
  • openEuler 源管理指南
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌