1. 为什么你需要一个靠谱的国内镜像源如果你在Ubuntu上敲下sudo apt update然后看着进度条以每秒几KB的速度缓慢爬行或者干脆直接报错“无法连接”那你肯定明白我在说什么。对于国内的开发者和用户来说访问Ubuntu官方软件仓库的速度很多时候就像在早高峰挤地铁一样充满了不确定性。网络延迟、连接中断、下载超时这些不仅仅是浪费时间更会打断你的工作流尤其是在进行系统更新、安装大型开发套件或者部署服务时一个缓慢的源会让你抓狂。这时候一个稳定、高速的国内镜像源就成了必需品。它就像在你家门口开了一家大型超市的分店所有商品软件包都是原装正品只是进货渠道更近你自然能更快地拿到手。华为云作为国内主流的云服务提供商其提供的Ubuntu镜像源Mirror在速度和稳定性上一直有不错的口碑。无论是个人开发者在家里的x86电脑amd64架构还是在公司服务器或树莓派这类ARM设备arm64架构上配置华为源都能显著提升软件包管理体验。今天我们就来手把手搞定Ubuntu 22.04 LTS长期支持版的华为镜像源配置覆盖amd64和arm64两种主流架构。这不仅仅是改个配置文件那么简单我会带你理解背后的原理告诉你为什么这么改以及改完之后如何验证和排查常见问题。毕竟配置源是Linux入门后的第一道实用关卡值得你花时间彻底弄懂。2. 动手之前理解你的系统与备份原配置在动任何系统配置文件之前养成备份的好习惯能救你于水火。对于软件源配置这一步尤其重要。2.1 确认你的系统架构首先你得知道自己正在操作的这台Ubuntu机器是什么架构的。虽然标题提到了arm64和amd64但你的系统具体是哪一个打开终端输入以下命令uname -m或者更详细一些arch常见的输出结果有x86_64: 这通常就是amd64架构。这是目前个人电脑和服务器上最常见的64位处理器架构。aarch64: 这通常就是arm64架构。常见于树莓派Raspberry Pi、苹果M系列芯片的Mac通过虚拟机或容器、以及越来越多的云服务器和嵌入式设备。i686,i386: 这是32位的x86架构现在比较少见。注意uname -m输出的是机器硬件名称而软件源列表里用的是amd64和arm64这样的“端口”名称。对于华为源或者其他镜像源你需要根据这个结果去选择对应的仓库路径。x86_64对应amd64aarch64对应arm64。2.2 备份现有的软件源列表Ubuntu的软件源配置文件是/etc/apt/sources.list以及/etc/apt/sources.list.d/目录下的一些额外列表。我们主要修改前者。在终端中执行备份命令sudo cp /etc/apt/sources.list /etc/apt/sources.list.backup.$(date %Y%m%d)这个命令做了两件事cp是复制命令。/etc/apt/sources.list.backup.$(date %Y%m%d)是目标文件名其中的$(date %Y%m%d)会自动替换成今天的日期例如20231027。这样你的备份文件就会像sources.list.backup.20231027一样带有时间戳方便日后追溯。有了这个备份万一新配置的源有问题或者你想回退到官方源只需要执行sudo cp /etc/apt/sources.list.backup.20231027 /etc/apt/sources.list就能一键还原。这是系统管理中最基础的“安全绳”。2.3 查看并理解默认的 sources.list在修改前我们先看看它原本的样子。用cat命令查看cat /etc/apt/sources.list你会看到很多以deb或deb-src开头的行后面跟着一个网址通常是http://archive.ubuntu.com/ubuntu或http://ports.ubuntu.com/ubuntu-ports然后是发行版代号和组件。例如一个典型的行可能是deb http://archive.ubuntu.com/ubuntu jammy main restricted universe multiverse我们来拆解一下deb: 表示这是一个二进制软件包的仓库。如果是deb-src则表示是源代码包仓库普通用户很少用到。http://archive.ubuntu.com/ubuntu: 这是仓库的基准URL。我们接下来要做的就是把这个地址替换成华为镜像源的地址。jammy: 这是Ubuntu 22.04 LTS的发行版代号。每个版本都有一个可爱的动物代号22.04是“Jammy Jellyfish”果酱水母。这个代号不能改改了就会尝试从错误的版本仓库拉取软件包导致版本混乱。main restricted universe multiverse: 这些是软件包的组件Component。简单理解main: 官方支持的自由开源软件。restricted: 官方支持的专有驱动如显卡驱动。universe: 社区维护的自由开源软件。multiverse: 有版权或法律限制的软件。 通常我们会保留所有这些组件以确保软件库的完整性。理解了这些我们的任务就很明确了把文件中所有指向archive.ubuntu.com或ports.ubuntu.com的URL统一替换为华为镜像源的URL同时保持jammy和各个组件不变。3. 配置华为镜像源两种方法详解替换源有两种主流方法一是直接编辑sources.list文件二是使用sed命令进行批量替换。我推荐第二种因为它更快速、不易出错。但为了让你理解本质我们先看手动编辑。3.1 方法一使用文本编辑器手动修改理解过程使用sudo权限打开你喜欢的命令行文本编辑器比如nano对新手友好或vim。sudo nano /etc/apt/sources.list接下来你需要将文件中所有的http://archive.ubuntu.com/ubuntu和http://ports.ubuntu.com/ubuntu-ports替换为华为源的地址。对于amd64 (x86_64)架构华为源的基准URL是http://repo.huaweicloud.com/ubuntu/对于arm64 (aarch64)架构华为源的基准URL也是http://repo.huaweicloud.com/ubuntu-ports/注意很多镜像源对ARM架构会使用-ports子目录华为源也是如此。这是因为ARM包的维护仓库路径与x86不同。根据你的架构在编辑器中找到对应的旧URL逐一修改。例如如果你的是amd64架构就把deb http://archive.ubuntu.com/ubuntu jammy main...改为deb http://repo.huaweicloud.com/ubuntu/ jammy main...特别注意URL末尾的斜杠/很重要最好保留它指向正确的目录路径。修改完成后按CtrlO保存再按CtrlX退出nano。这个方法直观但如果你文件里有很多行或者有注释行干扰手动修改既慢又容易漏。所以更高效的方法是3.2 方法二使用sed命令一键替换推荐sed是流编辑器非常适合做这种文本替换工作。我们可以针对不同架构用一条命令完成所有替换。针对 amd64 (x86_64) 架构如果你的uname -m输出是x86_64执行以下命令sudo sed -i s|http://archive.ubuntu.com/ubuntu|http://repo.huaweicloud.com/ubuntu|g /etc/apt/sources.list-i参数表示直接修改原文件。s|原字符串|新字符串|g是替换语法g表示全局替换一行内所有匹配项。这里我们用竖线|作为分隔符因为URL里包含斜杠/用竖线可以避免转义更清晰。针对 arm64 (aarch64) 架构如果你的uname -m输出是aarch64执行以下命令sudo sed -i s|http://ports.ubuntu.com/ubuntu-ports|http://repo.huaweicloud.com/ubuntu-ports|g /etc/apt/sources.list注意ARM架构的默认源地址是ports.ubuntu.com所以我们的替换对象也是它。一个更通用的“双保险”命令有时候系统里的sources.list可能混合了不同格式的URL或者你不确定具体是哪个。我们可以用一条稍复杂的sed命令同时处理两种可能的旧地址并将其统一到正确的华为源。这需要根据你的目标架构来选择新地址。对于目标为华为 amd64 源sudo sed -i -e s|http://archive.ubuntu.com/ubuntu|http://repo.huaweicloud.com/ubuntu|g -e s|http://ports.ubuntu.com/ubuntu-ports|http://repo.huaweicloud.com/ubuntu|g /etc/apt/sources.list对于目标为华为 arm64 源sudo sed -i -e s|http://archive.ubuntu.com/ubuntu|http://repo.huaweicloud.com/ubuntu-ports|g -e s|http://ports.ubuntu.com/ubuntu-ports|http://repo.huaweicloud.com/ubuntu-ports|g /etc/apt/sources.list-e参数允许在同一行指定多个编辑命令。这里我们连续执行了两个替换操作确保无论旧文件里是archive.ubuntu.com还是ports.ubuntu.com都会被替换成我们想要的华为源地址。执行完替换命令后强烈建议再用cat命令看一眼文件内容确认替换是否正确。cat /etc/apt/sources.list | head -5检查开头的几行确认URL已经变成了repo.huaweicloud.com。4. 更新软件包列表并验证配置修改源地址只是第一步让系统识别并信任这个新源还需要更新本地软件包索引。4.1 执行 apt update在终端中输入sudo apt update这个命令会读取我们刚刚修改的/etc/apt/sources.list文件连接到新的华为镜像源服务器下载最新的软件包列表信息存储在/var/lib/apt/lists/目录下。如果配置正确你会看到输出中连接的URL变成了华为云的地址并且下载速度通常会有肉眼可见的提升。4.2 解读 apt update 的输出成功运行的输出末尾通常是这样的命中:1 http://repo.huaweicloud.com/ubuntu jammy InRelease 获取:2 http://repo.huaweicloud.com/ubuntu jammy-updates InRelease [119 kB] ... 正在读取软件包列表... 完成 正在分析软件包的依赖关系树... 完成 正在读取状态信息... 完成 有 12 个软件包可以升级。请执行 ‘apt list --upgradable’ 来查看它们。关键点“命中”或“获取”前面是华为云的URL说明正在从新源拉取数据。没有报错如“无法连接”、“404 Not Found”、“GPG错误”等。最后提示“完成”表示本地软件包列表已成功更新。如果出现错误最常见的是GPG公钥错误。这是因为APT需要验证从仓库下载的元数据是否来自可信来源。每个仓库都有一个GPG密钥。当你换源后系统可能没有新镜像源的公钥。错误信息可能包含NO_PUBKEY后面跟着一长串密钥ID。解决方法使用apt-key命令添加公钥注意在更新的Ubuntu版本中apt-key已被弃用更推荐将密钥添加到/etc/apt/trusted.gpg.d/目录但针对主流镜像源通常apt-key仍可临时解决。不过对于华为源一个更简单的方法是再次运行sudo apt update。很多时候第一次更新失败是因为网络或缓存问题第二次运行就能成功拉取到密钥。如果持续失败可以尝试搜索“Ubuntu 华为源 GPG 密钥”寻找手动添加方案但这种情况在我多年的使用中极少遇到。4.3 进行一次试安装为了彻底验证源是否工作正常可以尝试安装或更新一个小型工具比如htop一个进程查看器sudo apt install htop -y观察下载过程。如果软件包能快速从repo.huaweicloud.com下载并安装成功那就说明你的华为源配置完美生效了。5. 进阶配置与深度优化基础的源替换已经能解决90%的问题。但如果你追求极致或者环境特殊下面这些进阶知识会让你对APT源的管理更加得心应手。5.1 使用 HTTPS 镜像源我们之前配置的都是HTTP源。华为云也提供HTTPS镜像地址就是把http://换成https://。例如amd64:https://repo.huaweicloud.com/ubuntu/arm64:https://repo.huaweicloud.com/ubuntu-ports/为什么要用HTTPSHTTPS会对传输数据进行加密防止被中间人窃听或篡改。虽然对于公开的软件包分发HTTP的安全性风险相对较低但在对安全有要求的内部网络或公共网络环境下使用HTTPS是更佳实践。配置方法同上只需在替换URL时使用HTTPS地址即可。5.2 配置 apt 缓存代理适用于企业内网如果你在公司内网可能无法直接访问外网镜像源。这时通常会有内部搭建的代理服务器或缓存服务器如apt-cacher-ng或Squid。配置方法是在/etc/apt/apt.conf.d/目录下创建一个配置文件例如00proxysudo nano /etc/apt/apt.conf.d/00proxy加入以下内容假设你的代理服务器地址是proxy.internal.company.com:3142Acquire::http::Proxy http://proxy.internal.company.com:3142; Acquire::https::Proxy http://proxy.internal.company.com:3142;这样所有APT的HTTP/HTTPS流量都会通过指定的代理服务器。注意如果你配置了华为源又配置了代理那么APT会先尝试通过代理连接华为源。请确保你的代理规则允许访问repo.huaweicloud.com。5.3 管理 sources.list.d 中的额外源除了主配置文件很多第三方软件如Docker, Kubernetes, Node.js等会把自己的源列表文件放在/etc/apt/sources.list.d/目录下文件名通常是[软件名].list。例如安装Docker后你可能会有一个/etc/apt/sources.list.d/docker.list文件。这些文件的源地址默认可能也是国外的。如果你希望这些软件的更新也走国内镜像需要逐一检查并修改这些文件。你可以用这个命令查看所有额外的源列表ls -la /etc/apt/sources.list.d/对于其中指向download.docker.com,packages.cloud.google.com等国外地址的文件你需要根据该软件提供的国内镜像站信息进行修改。并非所有第三方软件都有可用的国内镜像这是一个需要具体情况具体分析的工作。5.4 选择性使用不同镜像源高级技巧有时候你可能希望系统源用华为但某个特定的PPA个人软件包存档或仓库保持原样。或者华为源偶尔出现某个软件包同步延迟时你想临时换回官方源。这时备份文件就派上用场了。你可以准备多个sources.list文件比如sources.list.huawei,sources.list.aliyun,sources.list.official。当需要切换时只需sudo cp /etc/apt/sources.list.huawei /etc/apt/sources.list sudo apt update这是一种非常灵活的手动切换方式。当然也有工具可以管理多个源配置但对于大多数用户手动备份和替换已经足够。6. 排错指南当换源后 apt update 失败时即使按照步骤操作也可能遇到问题。别慌按照以下思路排查99%的问题都能解决。6.1 错误现象无法解析主机 (Could not resolve host)错误:1 http://repo.huaweicloud.com/ubuntu jammy InRelease 暂时不能解析域名 “repo.huaweicloud.com”原因你的系统DNS无法解析repo.huaweicloud.com这个域名。排查测试网络连通性ping -c 4 114.114.114.114国内公共DNS。如果不通检查物理网络。测试域名解析nslookup repo.huaweicloud.com或dig repo.huaweicloud.com。如果无法解析问题出在DNS。临时解决方案修改/etc/resolv.conf在文件开头添加一行nameserver 114.114.114.114或8.8.8.8作为备选。但注意这个文件可能被网络管理器重写。永久解决方案修改系统的DNS配置。对于使用systemd-resolved的Ubuntu 22.04更可靠的方法是修改/etc/systemd/resolved.conf设置DNS114.114.114.114 8.8.8.8然后重启服务sudo systemctl restart systemd-resolved。6.2 错误现象404 Not Found错误:1 http://repo.huaweicloud.com/ubuntu-ports jammy InRelease 404 Not Found [IP: xx.xx.xx.xx 80]原因仓库路径拼写错误或者该镜像站不支持你指定的发行版/架构组合。排查仔细检查URL确认你用的是ubuntu-ports还是ubuntu末尾的斜杠/有没有多余或缺失发行版代号jammy是否正确手动访问URL用浏览器或curl命令尝试访问你配置的完整URL去掉deb和组件。例如curl -I http://repo.huaweicloud.com/ubuntu-ports/dists/jammy/。如果返回404说明路径不对。访问镜像站首页在浏览器打开http://repo.huaweicloud.com看看有没有Ubuntu目录并手动导航确认正确的路径。有时镜像站的结构会有微调。6.3 错误现象GPG公钥错误W: GPG 错误http://repo.huaweicloud.com/ubuntu jammy InRelease: 由于没有公钥无法验证下列签名 NO_PUBKEY 3B4FE6ACC0B21F32原因系统缺少该仓库的GPG密钥无法验证软件包列表的完整性。解决首选方案如4.2节所述再运行一次sudo apt update。有时只是网络问题导致密钥没下载下来。手动添加密钥如果上述无效错误信息中的3B4FE6ACC0B21F32就是缺失的密钥ID。你可以尝试从Ubuntu密钥服务器获取并添加需要网络能访问 keyserver.ubuntu.comsudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 3B4FE6ACC0B21F32添加成功后再次运行sudo apt update。终极方案如果镜像站提供了自己的密钥文件.asc或.gpg可以下载并添加到可信密钥环。但主流镜像源通常都会将其密钥托管到公共服务器方法2基本能解决。6.4 错误现象速度依然很慢原因可能你选择的华为云镜像节点离你的物理位置网络不佳或者当前网络拥塞。解决尝试其他国内源国内优秀的Ubuntu镜像源不止华为一家还有阿里云(mirrors.aliyun.com)、腾讯云(mirrors.cloud.tencent.com)、清华(mirrors.tuna.tsinghua.edu.cn)、中科大(mirrors.ustc.edu.cn)等。方法完全一样只需替换基准URL。你可以用curl -s -w ‘时间: %{time_total}s\n’ -o /dev/null http://mirrors.aliyun.com/ubuntu/这类命令简单测试不同源的响应速度选择最快的。检查系统代理如果你之前配置过全局代理或APT代理但它现在不可用或速度慢也会影响。检查/etc/apt/apt.conf.d/下是否有代理配置或环境变量http_proxy和https_proxy。使用 apt 的镜像选择器有些工具如netselect-apt可以自动测试并生成最快的sources.list但对于固定环境手动测试一次选好就够了。7. 举一反三其他发行版与特定软件源的配置思路掌握了Ubuntu换源的精髓你就能轻松应对其他Linux发行版。核心思想万变不离其宗找到软件源配置文件将其中的基准URL替换为国内镜像站的对应URL。Debian配置文件同样是/etc/apt/sources.list。将deb.debian.org替换为华为云repo.huaweicloud.com/debian/、阿里云等镜像地址。发行版代号如bookworm和组件main contrib non-free保持不变。CentOS/RHEL/Rocky Linux/AlmaLinux这类基于RPM的发行版源配置文件在/etc/yum.repos.d/目录下后缀为.repo。你需要修改文件中baseurl或mirrorlist指向的URL。国内镜像站通常也提供EPEL等扩展仓库。DockerDocker Engine的安装源可以修改。编辑/etc/apt/sources.list.d/docker.list将其中的download.docker.com替换为国内镜像站如阿里云Docker镜像加速器地址需要参考镜像站提供的具体文档因为Docker的仓库结构比较特殊。Python Pip虽然不是系统包管理器但原理相通。创建或修改~/.pip/pip.conf配置index-url为清华、阿里云等PyPI镜像。Node.js npm同样可以配置镜像。命令npm config set registry https://registry.npmmirror.com/。配置国内源的核心价值在于将软件生态的“下载”这个环节本地化极大地提升了效率减少了因网络问题导致的失败。这几乎是每一位国内Linux用户和开发者的必修课。花半小时配置好换来的是日后无数小时的顺畅体验这笔时间投资绝对划算。