镜像

本页面是选择和配置镜像的指南，以及当前可用镜像的列表。

官方镜像

官方 Arch Linux 镜像列表可通过 pacman-mirrorlist 软件包获得。要获取更新的镜像列表，请使用 Pacman Mirrorlist Generator 页面。

通过访问 Mirror Status 页面检查镜像状态。建议仅使用最新的镜像，即未不同步的镜像。

如果您希望将自己的镜像添加到官方列表，请参阅 DeveloperWiki:NewMirrors。在此期间，可将其添加到 Unofficial mirrors 文章中。

支持 IPv6 的镜像

Pacman Mirrorlist Generator 也可用于查找当前的 IPv6 镜像列表。

支持通过 TLS 使用 rsync 的镜像

镜像列表生成器页面上没有针对支持通过 TLS 使用 rsync 的镜像的过滤器：它们列在下方。*.pkgbuild.com 由 Arch Linux 团队自行管理，而其他镜像则由社区贡献。有关设置的更多信息，请参阅 DeveloperWiki:NewMirrors

rsync://berlin.mirror.pkgbuild.com/packages/ - Arch Linux 德国地理镜像
rsync://frankfurt.mirror.pkgbuild.com/packages/ - Arch Linux 德国地理镜像
rsync://singapore.mirror.pkgbuild.com/packages/ - Arch Linux 新加坡地理镜像
rsync://johannesburg.mirror.pkgbuild.com/packages/ - Arch Linux 南非地理镜像
rsync://umea.mirror.pkgbuild.com/packages/ - Arch Linux 瑞典地理镜像
rsync://taipei.mirror.pkgbuild.com/packages/ - Arch Linux 台湾地理镜像
rsync://london.mirror.pkgbuild.com/packages/ - Arch Linux 英国地理镜像
rsync://losangeles.mirror.pkgbuild.com/packages/ - Arch Linux 美国地理镜像

启用特定镜像

要启用镜像，请编辑 /etc/pacman.d/mirrorlist 并找到您所在的地理区域。取消注释您想使用的镜像。

例如：

## Worldwide
#Server = https://geo.mirror.pkgbuild.com/$repo/os/$arch
#Server = http://mirror.rackspace.com/archlinux/$repo/os/$arch
Server = https://mirror.rackspace.com/archlinux/$repo/os/$arch

有关帮助选择镜像的工具，请参阅 #镜像排序。

提示： 取消注释 5 个最喜欢的镜像并将其置于 mirrorlist 文件的顶部。这样在列表中的第一个镜像出现问题时，可以轻松找到并移动它们。这还能让合并 mirrorlist 更新变得更容易。

也可以在 /etc/pacman.conf 中指定镜像。对于 core 仓库，默认设置是

[core]
Include = /etc/pacman.d/mirrorlist

要将 kernel.org 镜像用作默认镜像，请将其添加到 Include 行之前

[core]
Server = https://mirrors.kernel.org/archlinux/$repo/os/$arch
Include = /etc/pacman.d/mirrorlist

pacman 现在将首先尝试连接到此镜像。如果适用，请对 core-testing、extra 和 extra-testing 执行相同操作。

警告： 如果已在 pacman.conf 中直接声明镜像，请务必为所有仓库使用相同的镜像。否则会导致部分升级，因为可能会安装互不兼容的软件包，例如来自 core 的 linux 和来自 extra 的旧版内核模块。

强制 pacman 刷新软件包列表

镜像可能会不同步，旧镜像的软件包列表可能与新镜像的软件包列表不对应，即使列表日期显示它们是一致的。

在创建/编辑 /etc/pacman.d/mirrorlist 后，运行以下命令

# pacman -Syyu

传递两个 --refresh/-y 标志会强制 pacman 刷新所有软件包列表，即使它们被认为是最新的。

注意： 在大多数情况下，运行 pacman -Syyu 是对带宽的不必要浪费，但有时在从损坏的镜像切换到正常的镜像时可以解决问题。另请参阅 Is -Syy safe?。

警告： 在大多数情况下，如果您强制刷新 pacman 数据库，您会希望强制降级任何可能过新的软件包，使其与新镜像提供的版本一致。这可以防止软件包升级不一致导致的部分更新问题。

# pacman -Syyuu

当使用成功同步的镜像或通过检查镜像的 lastsync 文件时间戳以确保软件包列表是最新的时，这不是必需的。

镜像排序

在下载软件包时，pacman 按照 /etc/pacman.d/mirrorlist 中列出的顺序使用镜像，即服务器在列表中出现的顺序决定了其优先级。如果软件包下载失败（例如找不到文件、连接超时），则使用列表中的下一个条目。

仅根据速度对镜像进行排名并不理想，因为最快的服务器可能不同步。相反，先制作一份按速度排序的镜像列表，然后根据其状态移除其中不同步的镜像。

建议定期重复此过程以保持镜像列表最新。

按速度排序

对现有镜像列表进行排名

pacman-contrib 软件包提供了一个 Bash 脚本 /usr/bin/rankmirrors，可用于根据镜像的连接和打开速度对其进行排名，以便利用最快的本地镜像。

备份现有的 /etc/pacman.d/mirrorlist

# cp /etc/pacman.d/mirrorlist /etc/pacman.d/mirrorlist.backup

要准备 mirrorlist.backup 以供 rankmirrors 排名，可以执行以下操作

编辑 mirrorlist.backup 并取消注释要测试的服务器

如果文件中的服务器是按国家分组的，可以使用以下方式提取特定国家的所有服务器

$ awk '/^## Country Name$/{f=1; next}f==0{next}/^$/{exit}{print substr($0, 1);}' /etc/pacman.d/mirrorlist.backup

要取消注释每个镜像，请运行以下 sed 行

# sed -i 's/^#Server/Server/' /etc/pacman.d/mirrorlist.backup

最后，对镜像进行排名，此处使用操作数 -n 6 仅输出最快的 6 个镜像
```
# rankmirrors -n 6 /etc/pacman.d/mirrorlist.backup > /etc/pacman.d/mirrorlist
```

获取并排名实时镜像列表

为了从基于某些国家的最新镜像简表开始并将其提供给 rankmirrors，可以从 Pacman Mirrorlist Generator 获取列表。下面的命令提取支持 https 协议的法国或英国的最新镜像，取消注释列表中的服务器，然后对其进行排名并输出最快的 5 个。

$ curl -s "https://archlinux.org.cn/mirrorlist/?country=FR&country=GB&protocol=https&use_mirror_status=on" | sed -e 's/^#Server/Server/' -e '/^#/d' | rankmirrors -n 5 -

提示： 此过程可以通过任何基于文本的浏览器（例如 elinks(1)）导航到 https://archlinux.org.cn/mirrorlist 交互式地完成。

现有工具

Rate Mirrors — 它获取镜像，跳过过时/同步中的镜像，然后利用有关海底光缆和互联网交换中心的信息在国家之间跳转以寻找快速镜像。它的速度足够快，可以在每次更新前运行。它还支持通过 stdin 输入自定义镜像列表。

https://github.com/westandskif/rate-mirrors || rate-mirrors^AUR

服务端排序

官方的 Pacman Mirrorlist Generator 提供了一种获取已排名镜像列表的简便方法。因为所有排名都在考虑多个因素的单个服务器上完成，所以与在每个单独客户端上排名相比，镜像和客户端的负载显著降低。

客户端排序

其他流行的替代方案有：

ghostmirror — 与其他镜像软件不同，GhostMirror 会检查镜像是否同步，除了简单的 ping 测试外还执行实际下载速度测试，通过 systemd 自动化一切，并且如果配置得当，可以让您告别手动镜像管理。

https://github.com/vbextreme/ghostmirror || ghostmirror^AUR

mirro-rs — 带有 TUI 的 Arch Linux 镜像列表管理器。

https://github.com/rtkay123/mirro-rs || mirro-rs

rate-mirrors — 日常使用的地图感知客户端镜像排名工具。

https://github.com/westandskif/rate-mirrors || rate-mirrors^AUR

Reflector — 从 MirrorStatus 页面获取最新的镜像列表，按速度进行过滤和排序，并覆盖 /etc/pacman.d/mirrorlist。通过 systemd 服务和定时器提供自动化功能。

https://xyne.dev/projects/reflector/ || reflector

shiny-mirrors — reflector 的替代品，用 Rust 编写。

https://gitlab.com/Arisa_Snowbell/shiny-mirrors || shiny-mirrors^AUR

故障排除

镜像列表丢失

如果您遇到以下错误

error: config file /etc/pacman.d/mirrorlist could not be read: No such file or directory

直接从网站获取镜像列表

# curl -o /etc/pacman.d/mirrorlist https://archlinux.org.cn/mirrorlist/all/

请务必按照 #启用特定镜像中的说明取消注释首选镜像。

或者，使用 #镜像排序下列出的生成镜像列表的方法之一。

运行异常的镜像

如果您确定某个镜像运行不正常，且在镜像状态页面上没有反映出来，请更换镜像并考虑提交错误报告。对于镜像问题，应在 Arch Linux GitLab 的 arch-mirrors 项目中提交。您也可以发送邮件至 mirrors@archlinux.org。

Pacman 无法从 HTTP 镜像获取软件包

请先参阅 Pacman#无法在安装时获取软件包。如果不起作用，请使用 HTTPS 镜像。

参见

GitHub archweb mirrorlist.py - archweb 镜像列表生成器的源代码