linuxmirrors-os

LinuxMirrors 系统软件源换源

Quick Start

不要立即给一键命令。先收集系统、网络、权限、当前源和回滚条件，再生成“预检 → 计划 → 确认 → 执行 → 验证 → 回滚”的方案。

可直接使用：

• “为 Ubuntu 24.04 服务器制定 LinuxMirrors 换源与回滚方案。”
• “生成适合 CI 的非交互式系统换源命令，但先不要执行。”
• “CentOS 7 已 EOL，如何用 LinuxMirrors 处理 vault 和 EPEL？”

什么时候使用

当用户明确要更换 GNU/Linux 系统软件源、恢复官方源、处理 EPEL/vault/EOL 或生成换源自动化方案时使用。Docker CE 仓库、Registry Mirror、Docker Desktop 与容器运行时配置不适用。

适用用户

• 新手：采用交互式方案和默认备份，避免自定义 branch。
• 运维人员：采用固定提交、显式参数、diff、维护窗口与回滚验证。
• CI/CD 维护者：采用无人值守参数、停止条件和构建日志留存。

前置条件

必须知道发行版、版本、架构、网络区域、root/授权状态和回滚通道；缺少信息时只输出安全假设方案。

使用方式

Step 1：预检

读取预检清单，确认发行版、版本、架构、root、网络区域和包管理器。

Step 2：选模式

依据源模式选择大陆、--edu、--abroad 或 --use-official-source true。

Step 3：定参数

从参数参考选择最少参数，不臆造开关。

Step 4：拟计划

明确被修改文件、备份位置、包索引刷新、验证与维护窗口。

Step 5：先确认

展示命令但不代替用户授权；禁止在未知生产环境直接运行。

Step 6：执行后验证

检查源文件、包管理器刷新结果与目标域名，不以脚本退出码代替全部验证。

Step 7：失败回滚

按回滚指南恢复 .bak 或目录备份并重新刷新缓存。

能力边界与不适用场景

✅ 擅长处理

1. Debian/Ubuntu、Red Hat 系、openSUSE、Arch、Alpine、Gentoo、NixOS 等已支持系统的换源规划。
2. 交互式选择、无人值守参数、EPEL、security、vault、底层系统源与自定义镜像路径。
3. 备份、--print-diff、验证、失败诊断和官方源回退。

⚠️ 需要条件

1. 实际执行需要 root shell、变更授权、网络连通和维护窗口。
2. EOL 或衍生系统需要核验版本代号、仓库路径和镜像站是否仍同步。
3. 自定义 --source/--branch 需要先验证完整 URL、Release/repodata 等元数据可用。

❌ 超出范围（给替代方案）

1. Docker CE 软件源或 Docker Hub 加速 → 使用 Docker 换源专项流程。
2. 未被当前脚本识别的独立发行版 → 读取该发行版官方仓库文档并手工规划。
3. 在无授权生产机上代执行换源 → 只输出审阅版计划、命令和回滚清单。

资料路由

• 完整参数：读参数参考。
• 支持系统：读系统矩阵。
• 大陆/教育网/海外/官方源：读源模式。
• 主脚本与 Lite：读脚本选择。
• 运行前：读预检清单。
• CI/CD：读自动化指南。
• 恢复配置：读回滚指南。
• 报错排查：读故障排查。

安全与隐私

本技能不收集或上传用户数据。不得索要主机密码、SSH 私钥或云凭据。远程脚本先下载、检查来源与哈希/内容，再由用户在 root shell 中执行；不要写成 sudo bash <(curl ...)。默认保留备份，不主动使用 --ignore-backup-tips。

Rules

1. 禁止臆造参数、版本代号、仓库路径与镜像可用性。
2. 默认备份、默认不升级全部软件包、默认不清理缓存。
3. 包索引刷新失败立即停止，不继续安装或升级。
4. 多主机任务先在代表性节点验证，再按批次推广。

信息不足时

先按“Ubuntu 24.04、x86_64、中国大陆、只生成方案、不执行、保留备份、不升级软件包”给出安全示例。请补充：发行版与版本、架构、网络区域、当前源是否可用、是否需要 EPEL/security/vault、是否允许升级软件包。

验证清单

• cat /etc/os-release 与包管理器是否匹配？
• 命令参数是否存在于当前 ChangeMirrors.sh --help？
• 备份路径和恢复命令是否明确？
• 是否避免默认升级全部软件包和清理缓存？
• 是否验证目标仓库元数据与包索引刷新？

Gotchas

1. sudo bash <(curl ...) 可能因进程替换权限/文件描述符行为失败；先进入 root shell。
2. --source 只指定主机部分时仍需正确的 --branch；多级路径必须整体核验。
3. Debian/Ubuntu 的 security 源可能需要独立 --source-security 与 --branch-security。
4. CentOS/AlmaLinux EOL 仓库可能需要 vault；不能继续使用普通主仓库路径。
5. --ignore-backup-tips 的含义是忽略覆盖提示并不备份，不适合作为默认自动化参数。
6. 包索引刷新失败时不要继续升级软件包；先回滚或修复 DNS/TLS/版本代号。

FAQ

Q1：脚本会备份吗？ 主脚本默认备份，常见形式是在原路径后加 .bak；仍要在执行前确认磁盘与已有备份。

Q2：如何不升级软件包？ 在自动化方案中显式使用 --upgrade-software false，并核验当前脚本支持该选项。

Q3：如何恢复官方源？ 优先使用 --use-official-source true 重新生成；失败时从备份恢复。

Q4：curl 都装不上怎么办？ 使用 Python、wget、浏览器或可信本地副本获取脚本，先审查再运行。

Q5：如何选教育网源？ 中国大陆教育网场景使用 --edu，并先确认目标镜像支持该系统版本。

Q6：如何确认换源成功？ 检查源文件目标域名，运行对应包管理器刷新命令，并确认没有 Release/repodata、签名或 TLS 错误。