apt-mirror 使用指南

apt-mirror 使用指南

项目地址:https://gitcode.com/gh_mirrors/apt/apt-mirror

项目简介

apt-mirror 是一个用于 Debian 和 Ubuntu 等基于 apt 的 Linux 发行版的小工具，它能够帮助用户镜像任何部分或全部的软件包仓库。此项目起初由 Dmitriy Khramtsov 开发，旨在创建其大学的 Debian 镜像，目前由 Brandon Holtsclaw 维护。apt-mirror 可以通过 cron 定时任务自动运行，或手动执行来更新镜像。

1. 项目目录结构及介绍

以下是 apt-mirror 项目的基本目录结构和重要文件的简要说明：

.
├── apt-mirror         # 主脚本文件，执行该脚本来进行镜像操作
├── CHANGELOG          # 版本更新日志
├── LICENSE            # 许可证文件，遵循 GPL-2.0 许可
├── Makefile           # 用于构建或管理项目的一些自动化规则
├── mirror.list        # 核心配置文件，定义了要镜像的仓库源
├── postmirror.sh      # 镜像完成后可能需要执行的脚本
├── README.md          # 项目的主要说明文档，包含了安装和基本使用方法
└── gitignore          # 忽略特定文件或目录的Git配置文件

主要文件简介：

• apt-mirror: 执行程序，负责驱动整个镜像过程。
• mirror.list: 用户需编辑此文件以指定要镜像的仓库源。
• postmirror.sh: 自定义脚本，在镜像完成后可以执行的脚本，适用于后期处理需求。
• Makefile: 用于更高级的自动化任务，虽然在简单使用中可能不会直接交互。
• LICENSE: 显示项目采用的许可协议，确保合规使用。

2. 项目的启动文件介绍

• 主启动命令： 不是直接从源代码启动，而是通过系统包管理器安装后使用。在 Debian 或 Ubuntu 上，安装并使用如下：

  $ apt-get install apt-mirror
  $ sudo apt-mirror
  

  其中，sudo apt-mirror 是启动命令，之前应先配置好 mirror.list 文件。

3. 项目的配置文件介绍

• 配置文件：mirror.list 此文件位于 /etc/apt/mirror.list（在安装 apt-mirror 后自动生成或需手动创建），它是 apt-mirror 工作的核心。你需要在此文件中设定要镜像的仓库地址、选择不同的发布版本（如 stable, testing）以及是否仅镜像特定的软件包组等。例如，包括添加新的存储库镜像源和指定镜像保存的本地路径等设置。

示例配置片段：

deb http://archive.debian.org/debian/ jessie main contrib non-free
deb-src http://archive.debian.org/debian/ jessie main contrib non-free

以上配置段表示将 Debian “jessie” 发行版的主要、贡献和非自由软件包进行镜像。

完成上述配置后，执行 sudo apt-mirror 命令开始镜像同步过程。

---

通过以上步骤和介绍，您应该能够理解和配置 apt-mirror，从而有效地搭建属于自己的 Debian 或 Ubuntu 软件包镜像服务器。

apt-mirror 项目地址: https://gitcode.com/gh_mirrors/apt/apt-mirror