summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorDavid Kalnischkies <david@kalnischkies.de>2016-08-26 10:12:27 +0200
committerDavid Kalnischkies <david@kalnischkies.de>2016-08-26 10:38:27 +0200
commit53533ccccd7f7d4cd422e6ba33bb5d4c4d7f71b4 (patch)
tree3736806c4ef860dca7a2e6899da106e0c01bee54 /README.md
parentea2de30794af69d5936dcfae033f80ca94299095 (diff)
use apt 1.3 directly instead of an embedded copy
APT 1.3 supports socks5h proxies out of the box now, so instead of using a copy of the -https transport as a proof of concept, we can now deligate all of the technical implementation details to APT via a few simple symlinks. Closes: #835128
Diffstat (limited to 'README.md')
-rw-r--r--README.md39
1 files changed, 6 insertions, 33 deletions
diff --git a/README.md b/README.md
index e518799..05bef94 100644
--- a/README.md
+++ b/README.md
@@ -5,25 +5,6 @@ Easily install Debian packages via Tor.
This package implements an APT "acquire method" that handles URLs starting
with "tor+http://" or "tor+https://" in your sources.list.
-## Installation
-
-### Via apt
-
-
- apt-get install apt-transport-tor
-
-### From source
-
-If you are working from a git checkout, first run:
-
- autoreconf -i
-
-Then, or if installing from a tarball:
-
- ./configure --prefix=/usr
- make
- sudo make install
-
## Usage
Edit your /etc/apt/sources.list like so, adjusting the suite/components
@@ -48,20 +29,17 @@ Most users should not need to adjust SOCKS settings.
By default, apt-transport-tor uses the following SOCKS proxy setting, which
matches the default Tor SOCKS port:
- socks5h://apt:apt@localhost:9050
+ socks5h://apt-transport-tor@localhost:9050
If you want to use a different port, you can edit the Acquire::tor::proxy
apt preference:
- Acquire::tor::proxy "socks5h://apt:apt@localhost:9050";
+ Acquire::tor::proxy "socks5h://apt-transport-tor@localhost:9050";
-Note the use of a username/password to make use of the default
-IsolateSOCKSAuth Tor setting for stream isolation, which requires bug fixes
-from Tor 0.2.4.19 to work well. This means your apt traffic will be sent
-over a different circuit from your regular Tor traffic.
-
-Although "sock5h://" is put explicitly in these examples, at the moment its
-use is hardcoded (to avoid DNS leaks).
+Note the use of a username to make use of the default IsolateSOCKSAuth Tor
+setting for stream isolation, which requires bug fixes from Tor 0.2.4.19 to
+work well. This means your apt traffic will be sent over a different circuit
+from your regular Tor traffic for each host you connect to.
## Caveats
@@ -83,11 +61,6 @@ Download speeds will be slower via Tor.
Copyright (C) 2014 Tim Retout <diocles@debian.org>
-apt-transport-tor was forked from the APT https transport. APT has this
-copyright notice:
-
- Apt is copyright 1997, 1998, 1999 Jason Gunthorpe and others.
-
License:
This program is free software; you can redistribute it and/or modify