功能教程：镜像源站与同步管理 (Mirror Management)

本模块是 HrnrOS 基础设施的“弹药库”，专为解决数据中心内网环境下服务器装机、软件更新和依赖下载的带宽瓶颈而设计。通过管理本地 ISO 镜像源与远程上游同步节点，为您构建高速、稳定、完全私有化的内网软件包分发服务。

HrnrOS 镜像源解析支持矩阵

系统内置了强大的镜像解析引擎，可智能识别并挂载以下操作系统家族的 ISO/源结构：

操作系统家族 (OS Family)	架构支持 (Arch)	识别标签与应用场景
Ubuntu / Debian	x86_64, aarch64	自动解析 dists/ 与 pool/ 目录，提供 apt 源服务。
CentOS / RHEL 系	x86_64, aarch64	涵盖 RHEL, CentOS, RockyLinux, AlmaLinux。解析 repodata。
Alpine Linux	x86_64, aarch64	适用于极简容器宿主机环境的 apk 依赖同步。
其他通用 Linux	x86_64, aarch64	标准的挂载与只读目录浏览服务 (Generic/Unknown)。

---

⚠️ 关键前置：存储规划与上游连通性

在配置镜像同步之前，请务必确认以下数据中心环境参数：

1. 存储空间预留： 远程全量同步（如 CentOS 基础源+ EPEL）动辄需要数百 GB 空间。请确保 HrnrOS 宿主机的 /pxedata/mirrors 挂载了足够容量的数据盘。
2. 出网策略配置： 若要配置“远程同步源”，HrnrOS 控制节点必须具备访问外部互联网上游镜像站（如 Aliyun、清华 TUNA、网易等）的 HTTP/HTTPS 权限及足够的外网带宽。

---

步骤 1: 监控大盘与存储总览

进入 [镜像源站管理] 页面，顶部仪表盘实时展示当前的源站健康度与负载状态：

• 本地源总数 / 活跃状态： 展示从本地 ISO 解析出的静态内网源数量。
• 远程同步源 / 存储占用： 追踪连接外网的动态源总数及累计消耗的磁盘空间。
• 同步成功 / 失败预警： 实时监控后台 Rsync/Wget 任务的执行结果。

步骤 2: 基础本地源管理 (Local Mirrors)

本地源 是由您上传到系统的 ISO 文件静态挂载生成的只读目录。它是离线环境装机的基石。

1. 切换至 “ 基础本地源” 标签页。
2. 列表将自动展示所有已就绪的镜像。系统会智能提取：操作系统族 (OS Family)、CPU架构 (Architecture) 及 主版本号 (Major Version)。
3. 获取分发地址： 点击操作列的 “ 浏览底层目录”，即可获取该源的内网 HTTP 绝对路径。您可以直接将其填入 Kickstart/Preseed 脚本的 URL 参数中。
4. 状态管理： 状态栏显示 <span class="badge bg-success">Active</span> 即代表该内网源 HTTP 服务正常运行中。

步骤 3: 构建远程同步源 (Remote Mirrors)

当内网服务器需要使用 yum install 或 apt-get 安装 ISO 之外的额外包（如 Docker、Nginx）时，您需要构建远程同步源。

1. 切换至 “ 远程同步源” 标签页，点击 “ 新增远程源”。
2. 配置上游信息：
   • 源站名称： 自定义标识，如 Aliyun-CentOS7-Base。
   • 上游源地址 (Upstream URL)： 输入外部可用镜像站地址（例如 https://mirrors.aliyun.com/centos/7/os/x86_64/）。
3. 关联本地资产 (Bind Assets)：
   • 系统会自动拉取已存在的本地 ISO 资产。勾选与其对应的基础系统，同步下来的依赖包将与该系统深度融合。
4. 限速策略 (带宽保护)：
   • 为防止同步任务耗尽机房的外网出口带宽，您可以在 “下载限速” 框中输入阈值（如 5000 KB/s）。留空或填 0 则火力全开。
5. 提交后，任务状态将变为 <span class="badge bg-primary">Syncing</span>，系统开始在后台默默拉取庞大的包树结构。

步骤 4: 自动化同步策略 (Cron Scheduler)

上游镜像站（如 Ubuntu 安全更新）每天都在变动。为了保证内网源的时效性，HrnrOS 内置了工业级的 Cron 调度器。

1. 在创建或编辑远程源时，您需要配置 自动化同步周期。
2. 使用内置预设： 系统提供了符合运维习惯的快捷选项：
   • 每天凌晨 2 点 (0 2 * * *) - 避开业务高峰，推荐
   • 每周日凌晨 3 点 (0 3 * * 0) - 适合变动不频繁的冷门源
   • 每 6 小时 (0 */6 * * *) - 适合要求极高时效性的安全补丁源
3. 自定义 Cron 表达式：
   • 若您精通 Linux 定时任务，可直接输入标准 5 位 Cron 表达式。
   • 系统自带语法解析引擎，输入后下方会实时翻译为您下一次同步的具体时间（如 “下一次执行时间: 2026-04-07 02:00:00”），完美杜绝配置错误。

步骤 5: 维护与空间释放

• 实时进度： 在远程同步源列表中，同步状态 列会动态展示 Syncing (同步中) / Success (成功) / Error (错误)。点击错误徽章可查看底层 Rsync 的报错日志。
• 安全删除机制： 当您点击删除某个不再使用的远程源时，系统会弹出红色高危确认框。您可以选择仅仅删除同步任务，或者勾选 “同时删除本地已同步的数据文件” 来彻底释放由于历史同步累积下来的几百 GB 磁盘空间。