一个能够适配不同 Linux 发行版（Debian、Ubuntu、Kali 等）的通用配置模板，其中关键参数（如发行版代号、架构等）使用变量占位符，用户可根据自己的系统环境替换。下面分别给出 APT 源模板 和 Docker 源模板（包括 APT 源和镜像加速器配置）。

一、APT 源通用配置模板

APT 源配置文件通常位于 /etc/apt/sources.list 或 /etc/apt/sources.list.d/ 下。以下是通用模板，使用占位符 {{DISTRO}}、{{CODENAME}}、{{COMPONENTS}}。

模板内容

bash

# 默认官方源（可根据需要换成国内镜像）
deb http://deb.debian.org/debian {{CODENAME}} main contrib non-free
deb http://deb.debian.org/debian {{CODENAME}}-updates main contrib non-free
deb http://security.debian.org/debian-security {{CODENAME}}-security main contrib non-free

# 对于 Ubuntu 系统，官方源格式略有不同，可使用以下模板：
# deb http://archive.ubuntu.com/ubuntu {{CODENAME}} main universe restricted multiverse
# deb http://archive.ubuntu.com/ubuntu {{CODENAME}}-updates main universe restricted multiverse
# deb http://security.ubuntu.com/ubuntu {{CODENAME}}-security main universe restricted multiverse

# 对于 Kali Linux，官方源为：
# deb https://http.kali.org/kali {{CODENAME}} main non-free contrib

变量说明

使用示例

Debian 12 (Bookworm)

bash

deb http://deb.debian.org/debian bookworm main contrib non-free

Ubuntu 22.04 (Jammy)

bash

deb http://archive.ubuntu.com/ubuntu jammy main universe restricted multiverse

Kali Rolling

bash

deb https://http.kali.org/kali kali-rolling main non-free contrib

二、Docker APT 源通用配置模板

用于安装 Docker 引擎的 APT 源。不同发行版需要指定对应的发行版代号，但 Docker 官方源地址模式固定。

模板内容

bash

# 添加 Docker 官方 GPG 密钥
curl -fsSL https://download.docker.com/linux/{{DISTRO}}/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

# 添加 Docker APT 源
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/{{DISTRO}} {{CODENAME}} stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# 更新并安装
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-compose-plugin

变量说明

使用示例

• Debian 12 (Bookworm)：{{DISTRO}}=debian, {{CODENAME}}=bookworm

• Ubuntu 22.04：{{DISTRO}}=ubuntu, {{CODENAME}}=jammy

• Kali Rolling (基于 Debian 12)：{{DISTRO}}=debian, {{CODENAME}}=bookworm（不能使用 kali-rolling）

三、Docker 镜像加速器配置模板（/etc/docker/daemon.json）

此配置用于加速 docker pull 拉取容器镜像，与操作系统版本无关。

模板内容

json

{
  "registry-mirrors": [
    "https://mirror1.example.com",
    "https://mirror2.example.com"
  ]
}

变量说明

• https://mirror1.example.com 等替换为实际可用的镜像加速地址。国内常用加速器包括：

  • 阿里云（需登录获取专属地址）

  • 中科大：https://docker.mirrors.ustc.edu.cn

  • 网易：https://hub-mirror.c.163.com

  • 其他公益镜像：如 https://docker.1ms.run 等

使用步骤

1. 编辑或创建文件：sudo nano /etc/docker/daemon.json

2. 填入上述模板（替换为自己的镜像地址列表）

3. 重启 Docker：sudo systemctl restart docker

4. 验证：docker info | grep -A 5 "Registry Mirrors"

📌 通用变量获取脚本示例

为了方便填写变量，可以编写一个通用脚本自动检测并输出建议值：

bash

#!/bin/bash
echo "=== 系统信息检测 ==="
echo "发行版 ID: $(. /etc/os-release && echo $ID)"
echo "发行版代号: $(. /etc/os-release && echo $VERSION_CODENAME)"
echo "架构: $(dpkg --print-architecture)"
echo -e "\n建议:"
if [[ $(. /etc/os-release && echo $ID) == "kali" ]]; then
    echo "  Docker APT 源应使用 DISTRO=debian, CODENAME=bookworm (当前 Kali 基于 Debian 12)"
else
    echo "  Docker APT 源使用 DISTRO=$(. /etc/os-release && echo $ID), CODENAME=$(. /etc/os-release && echo $VERSION_CODENAME)"
fi

您可以根据输出手动替换模板中的占位符。

总结

• APT 源模板 适用于所有 Debian 系发行版，只需替换 {{CODENAME}} 和镜像站地址。

• Docker APT 源模板 需要根据发行版正确设置 {{DISTRO}} 和 {{CODENAME}}，特别注意 Kali 要映射到对应的 Debian 代号。

• Docker 镜像加速器模板 是跨发行版通用的，只需填入有效的加速器 URL。

将上述模板保存为文档，在配置时根据当前系统的实际值替换占位符即可。如果有特殊发行版（如 Fedora、RHEL），APT 源不适用，但 Docker 官方也提供了相应 RPM 源模板，可类似扩展。