企业官网建设流程全解析

• 文档
• 教程

本篇指南以 linux-command 仓库中 command/reposync.md 为核心，系统讲解reposync命令的完整用法：从语法、全部命令行选项，到多仓库同步、架构过滤、GPG 校验、增量镜像等真实运维场景。读完本文，你将能够独立搭建一条"远程 YUM 源 → 本地仓库 → 对外提供服务"的完整离线镜像链路，并理解它与 yum、createrepo 之间如何协同工作。

什么是 reposync：将远程 YUM 存储库同步到本地目录

reposync是 yum 工具集（yum-utils）中用于同步 yum 存储库到本地目录的命令。它基于yum库来检索仓库元数据与软件包，因此对仓库的识别方式、配置文件约定与 yum 完全一致。在 linux-command 仓库的命令索引 dist/data.json 中，reposync的词条描述即"同步yum存储库到本地目录"。

它在实际运维中的价值非常明确：

• 离线分发：将生产环境需要的软件包一次性同步到内网机器，避免每台服务器重复访问外网；
• 构建本地镜像源：把同步下来的 RPM 包配合createrepo重新生成元数据，再通过 HTTP/FTP 对外提供，供内网yum install使用；
• 按需裁剪：只同步指定 repo id、指定架构、甚至只同步最新版本的包，避免磁盘空间浪费。

语法

reposync [选项]

命令本身不接受位置参数，所有行为均由选项控制。未指定选项时，它默认尝试同步配置文件中所有启用的仓库到当前目录。

全部选项详解：分类理解 reposync 的行为控制

帮助与基础配置

-h, --help # 显示帮助信息 -c CONFIG, --config=CONFIG # 指定配置文件(默认为/etc/yum.conf) -a ARCH, --arch=ARCH # 指定arch -e CACHEDIR, --cachedir CACHEDIR # 存储元数据的目录 -t, --tempcache # 使用临时目录存储/访问yum-cache

• -c指定 yum 配置文件，默认读取/etc/yum.conf。当你拥有多份不同的源配置（如内网源、公网源）时，可以通过它快速切换；
• -a限制同步的硬件架构，例如只同步x86_64或noarch包；
• -e与-t控制元数据缓存的存放位置与方式。-e指定持久缓存目录，-t则使用临时目录，同步结束后缓存不落盘，适合一次性任务。

仓库选择

-r REPOID, --repoid=REPOID # 指定要查询的repo id，可以指定多次(默认为全部启用)。

-r是使用频率最高的选项：可以重复指定多次来选择多个仓库，例如-r updates -r extras。默认情况下不指定-r时会同步所有enabled=1的仓库，这在仓库较多时可能导致意外的磁盘占用，因此生产环境建议始终显式指定。

下载路径与文件行为

-p DESTDIR, --download_path=DESTDIR # 指定下载路径:默认为当前目录。 --norepopath # 不要将重命名添加到下载路径中。只能在同步单个存储库时使用(默认是添加重命名)。 -d, --delete # 删除存储库中不再存在的本地包。 --source # 同时下载src和rpm文件. -u, --urls # 只列出要下载的内容的url，不要下载。 -n, --newest-only # 每个repo只下载最新的包。

• -p指定下载根目录，默认为当前目录。默认行为下，reposync 会在下载路径下追加以 repo id 命名的子目录（即"添加重命名"），保证多仓库同步时包不互相覆盖；--norepopath取消这一行为，但只能在同步单个仓库时使用，多仓库时会产生冲突；
• -d用于增量同步场景：删除目标目录中那些"远程仓库已不存在的本地包"，保证本地目录与远端仓库严格一致；
• -u只打印将要下载的 URL 清单而不实际下载，适合做同步前的 dry-run 预检；
• -n每个仓库只下载最新版本的包，是控制仓库体积最有效的选项之一。

元数据与校验

-g, --gpgcheck # 下载后删除GPG签名检查失败的包。如果至少有一个包被删除，退出状态为“1”。 -m, --downloadcomps # 同时下载comps.xml。 --download-metadata # 下载所有非默认元数据。 -l, --plugins # 启用yum插件支持。

• -g启用 GPG 签名校验，校验失败的包会被直接删除，且只要有包被删除，命令的退出状态即为1，可被脚本捕获用于告警；
• -m同步仓库分组文件comps.xml（用于yum groupinstall分组安装），是构建功能完整的镜像源时必须的选项；
• --download-metadata会拉取所有非默认元数据（如filelists、prestodelta等）；
• -l启用 yum 插件，允许仓库的 yum 插件逻辑在同步过程中生效。

输出与安全选项

-q, --quiet # 输出尽可能少的信息。 --allow-path-traversal # 允许同步存储在repo目录之外的包。这些包是在元数据中通过使用绝对路径或上一级“..”系统引用的并且出于安全原因通常会在reposync中跳过。 # 注意:使用此选项有潜在的安全隐患，因为通过提供恶意repodata，攻击者可以使reposync写入任意位置运行该文件系统的用户可以访问的文件系统。

--allow-path-traversal是最需要谨慎对待的选项。出于安全考虑，reposync默认跳过那些通过绝对路径或..引用、位于仓库目录之外的包。只有当repodata由可信方维护时才应考虑开启，因为恶意repodata可以利用它让 reposync 向运行进程的用户可访问的任何路径写入文件，存在路径穿越风险。

实战场景：从入门到完整的镜像链路

场景一：将 updates 仓库全部同步到当前目录

reposync --repoid=updates

默认下载到当前目录，且会生成updates/子目录存放包。适合快速验证仓库可用性。

场景二：只同步最新版本的包

reposync -n --repoid=updates

-n（--newest-only）每个仓库只保留最新版本，显著减少同步量与磁盘占用。适合维护"够用即可"的补丁仓库。

场景三：同步多个仓库

reposync --repoid=updates --repoid=extras

-r可重复出现，一次性把updates与extras两个仓库同步下来，各自归入以 repo id 命名的子目录。

场景四：指定下载路径

reposync -p repos --repoid=updates

将updates仓库同步到repos目录。配合--norepopath可以去掉子目录层级，但注意该选项仅适用于单仓库同步。

场景五：排除特定架构的包

# 编辑/etc/yum.conf，添加选项exclude=*.x86_64 # 再执行: reposync -p repos --repoid=updates

reposync 底层通过 yum 库解析配置，因此/etc/yum.conf中的exclude=*.x86_64这类排除规则会直接作用于同步过程。这是文档给出的跨架构裁剪的标准做法；当处理多架构混合仓库时，也可以改用-a参数按架构整体过滤。

场景六：构建可对外提供服务的完整镜像仓库

单靠 reposync 同步下来的只是 RPM 包，要让它成为一个可被yum直接使用的仓库，还需要生成repodata元数据。这一环节对应仓库中的另一条命令 createrepo（"创建YUM仓库"）。完整链路如下：

# 1. 同步仓库到本地 reposync -p /srv/yum/updates -r updates # 2. 生成仓库元数据（repodata 目录） createrepo /srv/yum/updates

更进一步的增量维护方案是：首次全量同步后，后续只做增量。reposync 侧利用-d删除远端已移除的包，createrepo 侧使用--update复用已有元数据（createrepo 文档明确指出"如果元数据已经存在，且软件仓库中只有部分软件发生了改变或增减，则可用 update 参数直接对原有元数据进行升级，效率比重新分析 rpm 包依赖并生成新的元数据要高很多"），两者配合即可在带宽与 CPU 上同时实现高效维护：

# 增量同步（只拉新增/更新，删除远端已移除的包） reposync -p /srv/yum/updates -r updates -d # 增量重建元数据 createrepo --update /srv/yum/updates

同步完成并生成元数据后，将/srv/yum/updates通过 Nginx 等 Web 服务暴露，并在客户端/etc/yum.repos.d/下配置指向它的 repo 文件即可。关于客户端仓库配置格式，可参考 yum 文档中给出的示例：

[nginx] name=nginx repo baseurl=http://nginx.org/packages/centos/6/$basearch/ gpgcheck=0 enabled=1

配置文件：reposync 的数据来源

reposync 使用 yum 库来检索信息和包，如果没有指定配置文件（-c），将使用默认的 yum 配置。涉及的关键文件为：

• /etc/yum.conf—— 全局配置，exclude、cachedir等选项直接影响 reposync 行为；
• /etc/yum/repos.d/—— 各 repo 的定义目录，reposync 依据其中enabled=1的仓库以及各 repo 的baseurl执行同步。

同步前的安全检查清单

结合上文所有选项，一个规范的 reposync 生产用法应当包含以下考量：

1. 显式指定 repo id（-r），避免默认同步所有启用仓库造成意外流量与磁盘占用；
2. 明确下载路径（-p），并理解默认的 repo 子目录结构与--norepopath的适用边界；
3. 开启 GPG 校验（-g）并监控退出码，只要有校验失败的包被删除，命令会以状态1退出，便于 CI/告警捕获；
4. 谨慎对待--allow-path-traversal，仅在与可信 repodata 配合时使用，谨防恶意元数据造成的任意路径写入；
5. 按需使用-n、-a或exclude裁剪内容，控制镜像体积；
6. 面向分组安装场景记得加-m同步comps.xml。

总结

reposync是 yum 生态中连接"远程仓库"与"本地/内网仓库"的枢纽命令。本文基于 command/reposync.md 完整梳理了它的全部选项语义与典型用法，并延伸到与 createrepo、yum 的协同链路，覆盖了从单次同步到持续增量维护的完整镜像生命周期。如需查阅本仓库收录的其他命令手册（共 600 余个 Linux 命令），可在command/目录中按命令名检索，也可通过 dist/data.json 索引快速定位词条。

• 文档
• 教程