Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/albertodonato/sshoot

Manage sshuttle VPN sessions
https://github.com/albertodonato/sshoot

ssh sshuttle vpn

Last synced: 3 days ago
JSON representation

Manage sshuttle VPN sessions

Host: GitHub
URL: https://github.com/albertodonato/sshoot
Owner: albertodonato
License: gpl-3.0
Created: 2017-05-25T18:45:43.000Z (over 7 years ago)
Default Branch: main
Last Pushed: 2024-10-13T16:29:41.000Z (4 months ago)
Last Synced: 2025-01-25T09:05:43.307Z (10 days ago)
Topics: ssh, sshuttle, vpn
Language: Python
Homepage:
Size: 237 KB
Stars: 92
Watchers: 9
Forks: 12
Open Issues: 5
Metadata Files:
- Readme: README.rst
- Changelog: CHANGES.rst
- License: LICENSE.txt

Awesome Lists containing this project

README

        sshoot - Manage sshuttle VPN sessions

=====================================

|Latest Version| |Build Status| |Coverage Status| |Snap Package|

Command-line interface to manage multiple sshuttle_ VPN sessions.

``sshuttle`` creates a VPN connection from your machine to any remote server

that you can connect to via ssh.

``sshoot`` allows to define multiple VPN sessions using ``sshuttle`` and

start/stop them as needed.

It supports configuration options for most of ``sshuttle``'s features,

providing flexible configuration for profiles.

Usage

-----

Create a profile:

.. code:: bash

    $ sshoot create -r host1.remote -HNd vpn1 10.0.0.0/24

Start it:

.. code:: bash

    $ sshoot start vpn1

    Profile started.

List existing profiles (active ones are marked):

.. code:: bash

    $ sshoot list

         Profile  Remote host   Subnets

    --------------------------------------------

      *  vpn1     host1.remote  10.0.0.0/24

         vpn2     host2.remote  192.168.0.0/16

Stop the profile:

.. code:: bash

    $ sshoot stop vpn1

Remove it:

.. code:: bash

    $ sshoot delete vpn1

    

Install from Snap

-----------------

|Get it from the Snap Store|

``sshoot`` can be installed from `Snap Store`_ on systems where classic Snaps

are supported, via::

  sudo snap install --classic sshoot

.. _sshuttle: https://github.com/sshuttle/sshuttle

.. _`Snap Store`: https://snapcraft.io

.. |Latest Version| image:: https://img.shields.io/pypi/v/sshoot.svg

   :alt: Latest Version

   :target: https://pypi.python.org/pypi/sshoot

.. |Build Status| image:: https://github.com/albertodonato/sshoot/workflows/CI/badge.svg

   :alt: Build Status

   :target: https://github.com/albertodonato/sshoot/actions?query=workflow%3ACI

.. |Coverage Status| image:: https://img.shields.io/codecov/c/github/albertodonato/sshoot/main.svg

   :alt: Coverage Status

   :target: https://codecov.io/gh/albertodonato/sshoot

.. |Snap Package| image:: https://snapcraft.io/sshoot/badge.svg

   :alt: Snap Package

   :target: https://snapcraft.io/sshoot

.. |Get it from the Snap Store| image:: https://snapcraft.io/static/images/badges/en/snap-store-black.svg

   :alt: Get it from the Snap Store

   :target: https://snapcraft.io/sshoot