Skip to main content

Run a SOCKS proxy over an SSH dynamic forwarding connection

Project description

A simple tool for temporarily configuring a SOCKS proxy over an SSH dynamic forwarding connection.


To install:

$ pip install ssh-proxy


Run the SSH proxy with:

$ sshproxy hostname

where the hostname is a valid hostname provided to the SSH command line, e.g., If you need to configure SSH keys etc., it is recommended to do so using your ~/.ssh/config file, e.g.:

Host myhost
    User myuser
    IdentityFile ~/.ssh/myhost

networksetup requires enhanced permissions to run. To avoid entering your password in a dialog several times, run with --sudo to run networksetup as root:

$ sshproxy myhost --sudo

For other command line options, run:

$ sshproxy --help


The source is hosted in GitHub at At present the code assumes that no password needs to be entered and that the user is on a Mac and therefore has networksetup available. Improvements, including ridding the code of these assumptions, are welcome via pull request.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
ssh-proxy-0.1.2.tar.gz (3.4 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page