https://github.com/acroz/ssh-proxy
Run a SOCKS proxy over an SSH dynamic forwarding connection
https://github.com/acroz/ssh-proxy
Last synced: 2 months ago
JSON representation
Run a SOCKS proxy over an SSH dynamic forwarding connection
- Host: GitHub
- URL: https://github.com/acroz/ssh-proxy
- Owner: acroz
- License: mit
- Created: 2017-01-15T16:19:39.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2017-07-06T10:30:59.000Z (almost 8 years ago)
- Last Synced: 2025-03-10T17:55:41.161Z (3 months ago)
- Language: Python
- Size: 4.88 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.rst
- License: LICENSE
Awesome Lists containing this project
README
SSH Proxy
=========
A simple tool for temporarily configuring a SOCKS proxy over an SSH dynamic
forwarding connection.
Installation
------------
To install:
.. code-block:: bash
$ pip install ssh-proxy
Usage
-----
Run the SSH proxy with:
.. code-block:: bash
$ sshproxy hostname
where the hostname is a valid hostname provided to the SSH command line, e.g.
``[email protected]``, ``100.10.100.10``. If you need to configure SSH keys etc.,
it is recommended to do so using your ``~/.ssh/config`` file, e.g.::
Host myhost
HostName myhost.com
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:
.. code-block:: bash
$ sshproxy myhost --sudo
For other command line options, run:
.. code-block:: bash
$ sshproxy --help
Contribute
----------
The source is hosted in GitHub at https://github.com/acroz/ssh-proxy.git. 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.