镜像加速配置

国内服务器访问官方源较慢时，可以把默认软件源换成可信的国内镜像。以下示例优先使用清华大学 TUNA 镜像源，也可按需替换为阿里云 mirrors.aliyun.com、中科大 mirrors.ustc.edu.cn。

改源前先备份

更换软件源前务必备份原配置，方便随时回滚：

sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak   # Debian/Ubuntu

系统软件源

发行版软件源

• Ubuntu 软件源加速 — 覆盖 Ubuntu 24.04+ deb822 与 22.04 及更早版本的传统 sources.list。
• Debian 软件源加速 — Debian 11 / 12 换源为清华或阿里云镜像。
• CentOS / Rocky / Alma 换源 — yum / dnf 换源，含 CentOS 7 EOL 归档源处理。

Ubuntu 22.04 及更早（经典 sources.list）

# 一键把官方源替换为清华镜像
sudo sed -i 's@//.*archive.ubuntu.com@//mirrors.tuna.tsinghua.edu.cn@g' /etc/apt/sources.list
sudo sed -i 's@//.*security.ubuntu.com@//mirrors.tuna.tsinghua.edu.cn@g' /etc/apt/sources.list
sudo apt update

Ubuntu 24.04+（新版 deb822 格式）

24.04 起源配置在 /etc/apt/sources.list.d/ubuntu.sources。

sudo sed -i 's@//.*archive.ubuntu.com@//mirrors.tuna.tsinghua.edu.cn@g' /etc/apt/sources.list.d/ubuntu.sources
sudo sed -i 's@//.*security.ubuntu.com@//mirrors.tuna.tsinghua.edu.cn@g' /etc/apt/sources.list.d/ubuntu.sources
sudo apt update

Debian 11 / 12

sudo sed -i 's@//.*deb.debian.org@//mirrors.tuna.tsinghua.edu.cn@g' /etc/apt/sources.list
sudo sed -i 's@//.*security.debian.org@//mirrors.tuna.tsinghua.edu.cn@g' /etc/apt/sources.list
sudo apt update

CentOS / Rocky / Alma（yum / dnf）

CentOS 7 已于 2024-06 停止维护（EOL）

官方源已下线，请改用 vault 归档源 或迁移到 Rocky / Alma Linux。

# Rocky Linux：替换为清华镜像
sudo sed -e 's|^mirrorlist=|#mirrorlist=|g' \
  -e 's|^#baseurl=http://dl.rockylinux.org/$contentdir|baseurl=https://mirrors.tuna.tsinghua.edu.cn/rocky|g' \
  -i.bak /etc/yum.repos.d/rocky-*.repo
sudo dnf makecache

开发语言包管理器

pip（Python）

# 临时使用
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple <package>

# 永久设为默认源
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

npm / pnpm / yarn（Node.js）

npm  config set registry https://registry.npmmirror.com
pnpm config set registry https://registry.npmmirror.com
yarn config set registry https://registry.npmmirror.com

Go

go env -w GOPROXY=https://goproxy.cn,direct

开发工具镜像

• pip 镜像加速 — Python pip 临时与永久切换国内源。
• npm 镜像加速 — npm / pnpm / yarn 切换淘宝 npmmirror。
• Go 模块代理 — 配置 GOPROXY 加速 Go 模块下载。
• Docker Registry 镜像加速 — 配置 Docker daemon.json 使用国内 Registry 镜像。

容器镜像

Docker Registry Mirror

# 写入 /etc/docker/daemon.json 并重启 Docker
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<'EOF'
{
  "registry-mirrors": [
    "https://docker.m.daocloud.io",
    "https://docker.1panel.live"
  ]
}
EOF
sudo systemctl daemon-reload
sudo systemctl restart docker

验证镜像是否生效：

docker info | grep -A 3 "Registry Mirrors"

TIP

公共 Docker 镜像加速地址时有变动，若拉取失败可换用上面列表中的其它地址，或自建 registry 代理。