1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
|
.\" Man page copied from apt.conf man page.
.TH "apt-proxy" "8" "05 Feb 2002" "apt-proxy" ""
.SH "Name"
apt-proxy \- A proxy for saving bandwidth to Debian servers
.SH SYNOPSIS
.B apt-proxy
.I "[options] [logfile]"
.br
.PP
.SH "DESCRIPTION"
\fBapt-proxy\fP is an advanced shell script designed to be run out of
inetd, and provides a clean, caching, intelligent proxy for
\fBapt-get\fP, which speaks HTTP to apt-get clients, and http, rsync or ftp to
the back-end server(s)\&. Usually it is run on port 9999, mainly because
that is the default configuration, and people are lazy\&.
.PP
.SH OPTIONS
apt-proxy's command options are as follows:
.TP
.B -c <configfile>
Specify what file the config is stored in, defaults to
/etc/apt-proxy.conf .
.TP
.B -l <logfile>
Specify the file to log to, defaults to /var/log/apt-proxy.
The logfile can also be specified as the first (non-option) parameter
on the command line.
.TP
.B -v, --version
Show the program verison.
.br
.SH "CLIENT CONFIGURATION"
Once \fBapt-proxy\fP is configured, users then edit their
\fBsources\&.list\fP file to point to the proxy (which uses the http
protocol to serve clients), like so:
.nf
deb http://SERVER:9999/main woody main contrib non-free
deb http://SERVER:9999/non-US woody/non-US main contrib non-free
deb-src http://SERVER:9999/main woody main contrib non-free
deb-src http://SERVER:9999/non-US woody/non-US main contrib non-free
deb http://SERVER:9999/helixcode/ woody main
.fi
What path should be specified after the server name and port number
depends on the configuration of \fBapt-proxy\fP (which can restrict
paths and send different paths to different servers)\&. In this
example, non-US/ and helixcode/ actually retrieve files from different
back-end servers\&.
Note that you can also use the nicknames `unstable', `frozen' etc, but
they may be slightly slower for `apt-get update'.
.PP
.SH "SERVER CONFIGURATION"
See
.BR apt-proxy.conf (8)
for details of how to set up apt-proxy to use backends near to you.
.PP
.SH "CARE AND FEEDING OF MIRRORS"
\fBapt-proxy\fP reduces the bandwidth requirements of Debian mirrors
by synchronizing uncompressed Packages files where possible (much
cheaper than downloading the entire compressed file), by restricting
the frequency of Packages, Releases and Sources file updates from the
back end, by keeping partial transfers, and only doing a single fetch
for any file, how ever many users request it from the proxy.
.PP
.SH "FILES"
/etc/apt-proxy/apt-proxy\&.conf
.PP
.SH "SEE ALSO"
.na
.nh
.BR apt-proxy.conf (5)
.hy
.ad
.PP
.SH "BUGS"
Packages are not compressed using gzip --rsyncable, which gives a 30%
reduction in bytes transferred for binary packages, and much greater for
source and other packages.
.PP
.SH "AUTHOR"
apt-proxy was written by the Apt-Proxy World Domination Project.
|
