apt-mirror - apt sources mirroring tool
A small tool that provides ability to mirror any parts (or even all) of Debian GNU/Linux distribution or any other apt sources which often provided by many debian developers.
Main features:
- It uses a config similar to apts "sources.list"
- It's fully pool comply
- It supports multithreaded downloading
- It supports multiple architectures at the same time
- It can automatically remove unneeded files
- It works well on overloaded channel to internet
- It never produces an inconsistent mirror including while mirroring
- It works on all POSIX complied systems with perl and wget
Documentation
There is no easier way to create debian mirror than make it using apt-mirror! Well, to start mirroring with apt-mirror you should do three main tasks:- Install apt-mirror
- Configure sources
- Running apt-mirror
1. Installation
Debian ( Stable "Etch" or Newer ) and Ubuntu ( any Version ) users just need to:# apt-get update # apt-get install apt-mirror
Rest users need to download sources and install it by hand:
- download apt-mirror_xxx.orig.tar.gz
- extract it and put apt-mirror script to /usr/local/bin or somewhere similar
- put mirror.list config file to /etc/apt/ (or any other place such as /usr/local/etc, but in this case do not forget to always specify full path to it in command line)
2. Configuring sources
Open 'mirror.list' (from /etc/apt/ or whatever you installed it to) and add needed sources like in /etc/apt/sources.list. Finally your mirror.list may looks like this:# apt-mirror configuration file ## ## The default configuration options (uncomment and change to override) ## # # set base_path /var/spool/apt-mirror # set mirror_path $base_path/mirror # set skel_path $base_path/skel # set var_path $base_path/var # # set defaultarch <running host architecture> # set nthreads 20 # ## ## Example sources ## # sarge's section deb http://ftp.us.debian.org/debian sarge main contrib non-free deb-src http://ftp.us.debian.org/debian sarge main contrib non-free # this source required for network installation ability (udebs) deb http://ftp.us.debian.org/debian sarge main/debian-installer # security updates is always good thing to install deb http://security.debian.org/debian-security sarge/updates main contrib non-free deb-src http://security.debian.org/debian-security sarge/updates main contrib non-free # sarge-proposed-updates's section deb http://ftp.us.debian.org/debian sarge-proposed-updates main contrib non-free deb-src http://ftp.us.debian.org/debian sarge-proposed-updates main contrib non-free ## ## Cleaner configuration example ## # # set cleanscript $var_path/clean.sh # # What directories should we clean up # (i.e. remove files missing in up-to-date indexes) clean http://security.debian.org/ clean http://ftp.us.debian.org/ # But exclude this directories # (which is not managed by apt and apt-mirror) skip-clean http://ftp.us.debian.org/debian-cd/ skip-clean http://ftp.us.debian.org/debian/dists/sarge/main/installer-i386/ skip-clean http://ftp.us.debian.org/debian/doc/ skip-clean http://ftp.us.debian.org/debian/tools/ skip-clean http://ftp.us.debian.org/debian/project/
3. Running apt-mirror
Ok. Now we may run 'apt-mirror' by the following :Switch to the "apt-mirror" user
# sudo su - apt-mirrorRun apt-mirror
$ apt-mirroror (for non-debian users)
$ apt-mirror /usr/local/etc/mirror.list
You also can run apt-mirror from cron. Uncomment line in /etc/cron.d/apt-mirror for this purpose.