跳转到内容
搜索 AlmaLinux 文档

    浏览当前文档目录

    AlmaLinux 10 本地 dnf 镜像:reposync 与 createrepo_c 两条路线的最小可用流程

    在 almalinux:10 容器(aarch64;10.2,dnf 4.20.0-22.el10_2.alma.1,2026-10-30 实时仓库)中实际执行了完整的最小镜像链路:

    1. dnf reposync 同步最小仓库 extras(25 个包、约 4.7 MB;耗时与规模见日志 extras-sync-timed-rerun 步)
    2. 检查 --download-metadata 拉取的 repodata 内容
    3. 用 createrepo_c 对裁剪目录重建 repodata
    4. 客户端以 file:// 与 http://(python3 -m http.server 回环)两种方式查询本地源

    原始日志:plans/content-expansion/evidence/logs/alma-local-mirror.log(9 个 step 分段)。

    本页没有执行:公网全量同步(AppStream/BaseOS 数 GB、双架构)、nginx/httpd 正式发布、GPG 署名工作流、updateinfo 元数据保真验证。相关段落标注「未实测」。

    三个典型动机:

    • 离线/隔离环境:生产内网不通公网,装机与打补丁只能依赖内网源。
    • 带宽与速度:几十台机器各自拉公网镜像,不如一台同步机全量缓存。
    • 合规与版本固定:内网源按你的节奏同步,升级窗口由你控制,而不是跟随上游发版。

    AlmaLinux 官方镜像(https://repo.almalinux.org/)提供完整的 AppStream、BaseOS、CRB、extras 目录树,dnf reposync 同步的就是这些目录。

    用 reposync 做最小可用同步(实测)

    Section titled “用 reposync 做最小可用同步(实测)”
    Terminal window
    dnf reposync --repoid=extras --download-metadata -n -p /mirror/

    实测结果:extras 仓库 25 个包、4.7 MB,同步退出码 0。--download-metadata 让 reposync 把上游 repodata(repomd.xml、primary、filelists、other、comps.xml)原样拉下来,生成可直接使用的仓库,不需要再跑 createrepo。

    一个实测发现要先讲:dnf 4 的 reposync 没有 --includepkgs。网上很多教程写 dnf reposync --includepkgs=xxx,那是 yum 时代的参数——dnf 4.20 直接报 unrecognized arguments。想只同步部分包,用下面的裁剪路线。dnf 4 reposync 实际有用的参数:

    参数作用
    --repoid=...只同步指定仓库(可重复)
    -n / --newest-only只保留每个包的最新版本
    --delete删除本地已有但上游已消失的包(配合定时任务防目录膨胀)
    --download-metadata连元数据一起拉,1:1 保真

    createrepo_c 在 EL10 默认未安装,来自 AppStream(实测 createrepo_c-1.1.2-4.el10):

    Terminal window
    dnf install -y createrepo_c

    它服务于裁剪路线——当你自己挑选包(dnf download、cp 现有 rpm)组装目录时,需要重建 repodata:

    Terminal window
    mkdir -p /mirror-demo/Packages
    dnf download epel-release --destdir /mirror-demo/Packages
    createrepo_c /mirror-demo/

    实测:1 个包重建成功,repodata/ 下生成 primary.xml.zst、filelists.xml.zst、other.xml.zst 和 repomd.xml(EL10 用 zstd 压缩;上游仓库多用 gzip/sqlite)。

    同步后的目录结构(实测,两条路线目录不同):

    # 路线 A(reposync --download-metadata):-p /mirror/ → 元数据在 /mirror/extras/
    /mirror/
    └── extras/
    ├── Packages/ # rpm 文件
    ├── mirrorlist # 上游 mirrorlist(reposync 原样拉取)
    └── repodata/ # --download-metadata 拉取的上游元数据
    # 路线 B(download + createrepo_c):/mirror-demo/ 即仓库根
    /mirror-demo/
    ├── Packages/ # 手动下载的 rpm
    └── repodata/ # createrepo_c 生成的 .xml.zst 元数据

    生产环境建议按 $releasever 分层,例如 <镜像根>/10/extras/,客户端 baseurl 里用 $releasever 变量对齐。

    两种协议都验证通过。

    file://(本机或 NFS 挂载场景):

    Terminal window
    dnf -q --disablerepo='*' --repofrompath=demo,file:///mirror-demo/ \
    --releasever=10 repolist
    dnf -q --disablerepo='*' --repofrompath=demo,file:///mirror-demo/ \
    --releasever=10 list epel-release

    实测 repolist 出现 demo 源,list epel-release 查到 epel-release.noarch 10-6.el10。

    http://(内网发布场景):

    Terminal window
    # 镜像机上
    cd /mirror && python3 -m http.server 8000
    # 客户端
    dnf -q --disablerepo='*' --repofrompath=mirror,http://<镜像机IP>:8000/extras \
    --releasever=10 repolist

    实测回环地址查询成功。本页用 python3 -m http.server 只是为了验证 http 源结构可用;正式发布请用 nginx/httpd 并做好访问控制(未实测,见下文)。

    正式部署时把 --repofrompath 换成持久化配置,写 /etc/yum.repos.d/local-extras.repo:

    [local-extras]
    name=AlmaLinux 10 - Extras (Local Mirror)
    baseurl=http://mirror.example.internal/alma/$releasever/extras/
    enabled=1
    gpgcheck=1
    gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-AlmaLinux-10

    演示命令里为了隔离环境用了 --disablerepo='*' 和 --repofrompath;客户端定义 gpgcheck=1 并保留官方 GPG key,比把 gpgcheck=0 写进生产配置安全得多。

    与公网源的同步策略(文献口径,未实测)

    Section titled “与公网源的同步策略(文献口径,未实测)”
    • 定时增量:reposync -n --delete 加 systemd timer(参考本站 systemd timer 页)每日同步,-n 控制只拉新版本,--delete 清理上游已撤销的包。
    • 按仓库分级:多数内网只需要 BaseOS + AppStream;CRB/extras 按需。全量同步是数 GB 级别的带宽与磁盘预算,先估容量再动手。
    • kickstart/PXE 联动:内网源建好后,安装页的 url --url= 可直接指向它,装机不再依赖公网(参考本站 kickstart 与 PXE 页)。

    评估同步范围时,可先用第三方聚合 PkgSeek 的发行版页概览 AlmaLinux 各仓库树的包收录规模,帮助决定哪些仓库值得进内网(速查工具、非官方源;同步清单以官方仓库树为准)。

    以下结论保持文献口径或明确不做承诺,本页未实测:

    1. updateinfo 元数据保真:本演练用的 extras 上游仓库本身不含 updateinfo,无法验证「内网源能否让 dnf updateinfo 正常工作」。如果你的安全基线依赖 errata 数据,建好后先抽查 dnf updateinfo list 是否有输出,再决定走 reposync 元数据路线还是 createrepo_c --update 路线。
    2. 公网全量同步规模:AppStream/BaseOS 的体积、同步时长、双架构(x86_64 + aarch64)磁盘预算均未在本页测量。
    3. nginx/httpd 正式发布:TLS、目录权限、暴露面控制不在本页范围。
    4. GPG 署名工作流:镜像端 key 分发的实际操作未出证,正文只给配置建议。