humanmade/hm-proxy

Name: hm-proxy

Owner: Human Made

Description: A simple script to proxy from your computer

Created: 2015-07-29 11:27:25.0

Updated: 2018-05-24 18:04:45.0

Pushed: 2018-05-24 18:04:46.0

Homepage: null

Size: 13

Language: null

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

HM Proxy

A super simple script to connect to the closest proxy to you automatically.

Must be run with sudo.

e: hmproxy [options] [<command>]

ommand>
  One of:
    on             Connect to the proxy connection
    off            Disconnect from the proxy connection
    sh/ssh         Open a shell to the proxy
                   (Reuses the connection; nice and fast!)
    run (default)  Connect and keep in foreground
                   (Allows exiting with Ctrl-C)

github
  Proxy all SSH connections (e.g git@github.com) to GitHub

, --region <proxy>
  One of EU/AU/US-WEST/US-EAST
  Default is geolocated from your IP.

, --port <port>
  Port to connect to proxy on
  Default is 22, use 443 if proxy is blocked

, --service <service>
  Network service to enable the proxy on
  Default is your top enabled network ('Wi-Fi')

, --user <user>
  Proxy username
  Default is local username ('root')

Install

To install:

• Clone this repo
• cd into the new directory
• Run ./hmproxy

To make it available everywhere:

• cd into the hmproxy directory
• ln -s $PWD/hmproxy /usr/local/bin

Examples

For example, I run it as follows:

 hmproxy -u ryan

If I'm in a cafe that blocks port 22:

 hmproxy -u ryan -p 443

If I'm in a cafe in Berlin, and want to force EU-Central:

 hmproxy -u ryan -p 443 -r eu-central

FAQ

Why does it pick the wrong service (e.g. Bluetooth instead of Wi-Fi)?

HM Proxy tries to pick the right service, but it may be picking the wrong one if your system order is set incorrectly.

To fix this, open System Preferences > Network, click the gear, and select “Set Service Order…”

If you just want to do it for a one-off request, use -s or --service