summaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorAvery Pennarun <apenwarr@gmail.com>2010-05-04 23:21:16 -0400
committerAvery Pennarun <apenwarr@gmail.com>2010-05-04 23:42:36 -0400
commit8fe3592be3fafb04d12f056a264c73cb846c1a0e (patch)
treebf2bb55632fba90c22318ba7706c37b4ef64ac6c /README.md
parentba19d9c72d86436a405d4f544f75c4d3dc76ab05 (diff)
Don't require the remote server to have sshuttle installed.sshuttle-0.20
Instead, grab our source code, send it over the link, and have python eval it and then start the server.py main() function. Strangely, there's now *less* horrible stuff in ssh.py, because we no longer have to munge around with the PATH environment variable. And this significantly reduces the setup required to get sshuttle going. Based on a suggestion from Wayne Scott.
Diffstat (limited to 'README.md')
-rw-r--r--README.md15
1 files changed, 13 insertions, 2 deletions
diff --git a/README.md b/README.md
index 92a1d1d..b86c4ff 100644
--- a/README.md
+++ b/README.md
@@ -36,11 +36,17 @@ Prerequisites
- sudo, su, or logged in as root on your client machine.
(The server doesn't need admin access.)
- - Linux+iptables on your client machine, including at
+ - If you use Linux on your client machine:
+ iptables installed on the client, including at
least the iptables DNAT, REDIRECT, and ttl modules.
- This is available by default on most Linux distributions.
+ These are installed by default on most Linux distributions.
(The server doesn't need iptables and doesn't need to be
Linux.)
+
+ - If you use MacOS or BSD on your client machine:
+ Your kernel needs to be compiled with IPFIREWALL_FORWARD
+ (MacOS has this by default) and you need to have ipfw
+ available. (The server doesn't need to be MacOS or BSD.)
This is how you use it:
@@ -58,6 +64,11 @@ That's it! Now your local machine can access the remote network as if you
were right there! And if your "client" machine is a router, everyone on
your local network can make connections to your remote network.
+You don't need to install sshuttle on the remote server;
+the remote server just needs to have python available.
+sshuttle will automatically upload and run its source code
+to the remote python interpreter.
+
This creates a transparent proxy server on your local machine for all IP
addresses that match 0.0.0.0/0. (You can use more specific IP addresses if
you want; use any number of IP addresses or subnets to change which