AlmaLinux 10 本地 dnf 镜像:reposync 与 createrepo_c 两条路线的最小可用流程
在 almalinux:10 容器(aarch64;10.2,dnf 4.20.0-22.el10_2.alma.1,2026-10-30 实时仓库)中实际执行了完整的最小镜像链路:
dnf reposync同步最小仓库extras(25 个包、约 4.7 MB;耗时与规模见日志 extras-sync-timed-rerun 步)- 检查
--download-metadata拉取的 repodata 内容 - 用
createrepo_c对裁剪目录重建 repodata - 客户端以
file://与http://(python3 -m http.server回环)两种方式查询本地源
原始日志:plans/content-expansion/evidence/logs/alma-local-mirror.log(9 个 step 分段)。
本页没有执行:公网全量同步(AppStream/BaseOS 数 GB、双架构)、nginx/httpd 正式发布、GPG 署名工作流、updateinfo 元数据保真验证。相关段落标注「未实测」。
为什么搭内网镜像
Section titled “为什么搭内网镜像”三个典型动机:
- 离线/隔离环境:生产内网不通公网,装机与打补丁只能依赖内网源。
- 带宽与速度:几十台机器各自拉公网镜像,不如一台同步机全量缓存。
- 合规与版本固定:内网源按你的节奏同步,升级窗口由你控制,而不是跟随上游发版。
AlmaLinux 官方镜像(https://repo.almalinux.org/)提供完整的 AppStream、BaseOS、CRB、extras 目录树,dnf reposync 同步的就是这些目录。
用 reposync 做最小可用同步(实测)
Section titled “用 reposync 做最小可用同步(实测)”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 与目录结构(实测)
Section titled “createrepo_c 与目录结构(实测)”createrepo_c 在 EL10 默认未安装,来自 AppStream(实测 createrepo_c-1.1.2-4.el10):
dnf install -y createrepo_c它服务于裁剪路线——当你自己挑选包(dnf download、cp 现有 rpm)组装目录时,需要重建 repodata:
mkdir -p /mirror-demo/Packagesdnf download epel-release --destdir /mirror-demo/Packagescreaterepo_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 变量对齐。
客户端指向本地源(实测)
Section titled “客户端指向本地源(实测)”两种协议都验证通过。
file://(本机或 NFS 挂载场景):
dnf -q --disablerepo='*' --repofrompath=demo,file:///mirror-demo/ \ --releasever=10 repolistdnf -q --disablerepo='*' --repofrompath=demo,file:///mirror-demo/ \ --releasever=10 list epel-release实测 repolist 出现 demo 源,list epel-release 查到 epel-release.noarch 10-6.el10。
http://(内网发布场景):
# 镜像机上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=1gpgcheck=1gpgkey=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 各仓库树的包收录规模,帮助决定哪些仓库值得进内网(速查工具、非官方源;同步清单以官方仓库树为准)。
以下结论保持文献口径或明确不做承诺,本页未实测:
updateinfo元数据保真:本演练用的extras上游仓库本身不含 updateinfo,无法验证「内网源能否让dnf updateinfo正常工作」。如果你的安全基线依赖 errata 数据,建好后先抽查dnf updateinfo list是否有输出,再决定走 reposync 元数据路线还是createrepo_c --update路线。- 公网全量同步规模:AppStream/BaseOS 的体积、同步时长、双架构(x86_64 + aarch64)磁盘预算均未在本页测量。
- nginx/httpd 正式发布:TLS、目录权限、暴露面控制不在本页范围。
- GPG 署名工作流:镜像端 key 分发的实际操作未出证,正文只给配置建议。