“镜像源错误”是因系统软件源不可用、延迟高或版本不匹配导致依赖下载失败，需按系统类型更换为阿里云（CentOS/AlmaLinux/Rocky）、清华（Ubuntu）或中科大（Debian）镜像源，并可临时禁用GPG校验调试。

如果您在安装宝塔面板时收到“镜像源错误”提示，通常是因为系统当前配置的软件源（yum 或 apt）不可用、响应缓慢或与当前系统版本不匹配，导致依赖包下载失败。以下是解决此问题的具体操作步骤：

一、检查当前系统版本及源状态

确认操作系统类型（CentOS/AlmaLinux/Rocky Linux/Ubuntu/Debian）和版本号，是选择适配源的前提。同时验证现有源是否可连通，避免盲目更换。

1、执行 cat /etc/os-release 查看系统发行版信息。

2、执行 ping -c 3 mirrors.aliyun.com 测试国内镜像源连通性。

3、执行 curl -I http://mirrors.aliyun.com 检查HTTP响应状态是否为200。

二、CentOS 7 / AlmaLinux 8 / Rocky Linux 8 更换为阿里云 yum 源

这些系统默认使用官方源，但官方源在国内常出现超时或404错误。替换为阿里云镜像源可提升稳定性与速度。

1、备份原 repo 文件：mv /etc/yum.repos.d/CentOS-Base.repo /etc/yum.repos.d/CentOS-Base.repo.backup。

2、下载阿里云对应版本源配置：curl -o /etc/yum.repos.d/CentOS-Base.repo https://mirrors.aliyun.com/repo/Centos-vault-7.9.2009.repo（CentOS 7）。

3、清理并重建缓存：yum clean all && yum makecache。

三、Ubuntu 20.04 / 22.04 更换为清华 apt 源

Ubuntu 默认源服务器位于境外，易因网络波动导致 apt update 失败，进而中断宝塔安装脚本中的依赖安装环节。

1、备份原 sources.list：cp /etc/apt/sources.list /etc/apt/sources.list.backup。

2、清空并写入清华源（以 Ubuntu 22.04 为例）：sed -i 's/archive.ubuntu.com/mirrors.tuna.tsinghua.edu.cn/g' /etc/apt/sources.list && sed -i 's/security.ubuntu.com/mirrors.tuna.tsinghua.edu.cn/g' /etc/apt/sources.list。

3、更新软件包列表：apt update。

四、Debian 11 / 12 手动替换为中科大 apt 源

Debian 原始源地址常返回连接拒绝，中科大镜像站对 Debian 支持完善且同步及时，适合生产环境使用。

1、编辑源文件：nano /etc/apt/sources.list。

2、删除全部内容，粘贴以下行（Debian 12）：deb https://mirrors.ustc.edu.cn/debian bookworm main non-free non-free-firmware contrib。

3、添加安全更新源：deb https://mirrors.ustc.edu.cn/debian-security bookworm-security main。

4、执行 apt update 验证新源可用性。

五、临时禁用 GPG 校验（仅限调试场景）

当源配置正确但因密钥缺失或过期导致 apt/yum 报 GPG error 时，可临时跳过校验以完成宝塔安装，后续再修复密钥问题。

1、对于 yum 系统，创建临时配置：echo 'gpgcheck=0' >> /etc/yum.conf。

2、对于 apt 系统，运行：apt -o Acquire::Check-Valid-Until=false -o Acquire::AllowInsecureRepositories=true update。

3、执行宝塔安装命令：wget -O install.sh https://download.bt.cn/install/install-6.0.sh && bash install.sh。