
Tunnels SSH vers un serveur distant.
|Tests| |AppVeyor| |readthedocs| |coveralls| |version|
|pyversions| |license|
Auteur : Pahaz_
Dépôt : https://github.com/pahaz/sshtunnel/
Inspiré par https://github.com/jmagnusson/bgtunnel, qui ne fonctionne pas sous Windows.
Voir aussi : https://github.com/paramiko/paramiko/blob/master/demos/forward.py
paramiko_sshtunnel_ est disponible sur PyPI, il suffit donc d'exécuter :
::
pip install sshtunnel
ou ::
easy_install sshtunnel
ou ::
conda install -c conda-forge sshtunnel
pour l'installer dans votre environnement.
Pour installer depuis les sources, clonez le
dépôt <https://github.com/pahaz/sshtunnel>_ et exécutez ::
python setup.py install
Pour exécuter les tests, vous devez d'abord disposer de
tox <https://testrun.org/tox/latest/>_ et exécuter ::
python setup.py test
L'un des scénarios typiques où sshtunnel est utile est illustré dans la
figure ci-dessous. L'utilisateur peut avoir besoin de se connecter à un port d'un serveur distant (par exemple 8080)
où seul le port SSH (généralement le port 22) est accessible. ::
----------------------------------------------------------------------
|
-------------+ | +----------+
LOCAL | | | REMOTE | :22 SSH
CLIENT | <== SSH ========> | SERVER | :8080 web service
-------------+ | +----------+
|
FIREWALL (only port 22 is open)
----------------------------------------------------------------------
Fig1 : Comment se connecter à un service bloqué par un pare-feu via un tunnel SSH.
Si le serveur SSH l'autorise, il est également possible d'atteindre un serveur privé
(du point de vue de REMOTE SERVER) non directement visible depuis
l'extérieur (du point de vue de LOCAL CLIENT). ::
----------------------------------------------------------------------
|
-------------+ | +----------+ +---------
LOCAL | | | REMOTE | | PRIVATE
CLIENT | <== SSH ========> | SERVER | <== local ==> | SERVER
-------------+ | +----------+ +---------
|
FIREWALL (only port 443 is open)
----------------------------------------------------------------------
Fig2 : Comment se connecter à PRIVATE SERVER via un tunnel SSH.
L'API permet soit d'initialiser le tunnel et de le démarrer, soit d'utiliser un contexte with,
qui se chargera de démarrer et d'arrêter le tunnel :
Le code correspondant à la Fig1 ci-dessus suit, en supposant que l'adresse du serveur distant est
pahaz.urfuclub.ru, une authentification par mot de passe et un port de liaison local attribué
aléatoirement.
.. code-block:: python
from sshtunnel import SSHTunnelForwarder
server = SSHTunnelForwarder(
'alfa.8iq.dev',
ssh_username="pahaz",
ssh_password="secret",
remote_bind_address=('127.0.0.1', 8080)
)
server.start()
print(server.local_bind_port) # show assigned local port
# work with `SECRET SERVICE` through `server.local_bind_port`.
server.stop()
Exemple de redirection de port vers un serveur privé non directement accessible, en supposant une authentification par pkey protégée par mot de passe, que le service SSH du serveur distant écoute sur le port 443 et que ce port est ouvert dans le pare-feu (Fig2) :
.. code-block:: python
import paramiko
import sshtunnel
with sshtunnel.open_tunnel(
(REMOTE_SERVER_IP, 443),
ssh_username="",
ssh_pkey="/var/ssh/rsa_key",
ssh_private_key_password="secret",
remote_bind_address=(PRIVATE_SERVER_IP, 22),
local_bind_address=('0.0.0.0', 10022)
) as tunnel:
client = paramiko.SSHClient()
client.load_system_host_keys()
client.set_missing_host_key_policy(paramiko.AutoAddPolicy())
client.connect('127.0.0.1', 10022)
# do some operations with client session
client.close()
print('FINISH!')
Exemple de redirection de port pour le port local MySQL de Vagrant :
.. code-block:: python
from sshtunnel import open_tunnel
from time import sleep
with open_tunnel(
('localhost', 2222),
ssh_username="vagrant",
ssh_password="vagrant",
remote_bind_address=('127.0.0.1', 3306)
) as server:
print(server.local_bind_port)
while True:
# press Ctrl-C for stopping
sleep(1)
print('FINISH!')
Ou simplement en utilisant la CLI :
.. code-block:: console
(bash)$ python -m sshtunnel -U vagrant -P vagrant -L :3306 -R 127.0.0.1:3306 -p 2222 localhost
Ouverture d'une session SSH en sautant par-dessus deux tunnels. Le transport SSH et les tunnels seront démonisés, ce qui ne les fera pas attendre l'arrêt des connexions au moment de la fermeture.
.. code-block:: python
import sshtunnel
from paramiko import SSHClient
with sshtunnel.open_tunnel(
ssh_address_or_host=('GW1_ip', 20022),
remote_bind_address=('GW2_ip', 22),
) as tunnel1:
print('Connection to tunnel1 (GW1_ip:GW1_port) OK...')
with sshtunnel.open_tunnel(
ssh_address_or_host=('localhost', tunnel1.local_bind_port),
remote_bind_address=('target_ip', 22),
ssh_username='GW2_user',
ssh_password='GW2_pwd',
) as tunnel2:
print('Connection to tunnel2 (GW2_ip:GW2_port) OK...')
with SSHClient() as ssh:
ssh.connect('localhost',
port=tunnel2.local_bind_port,
username='target_user',
password='target_pwd',
)
ssh.exec_command(...)
::
$ sshtunnel --help
usage: sshtunnel [-h] [-U SSH_USERNAME] [-p SSH_PORT] [-P SSH_PASSWORD] -R
IP:PORT [IP:PORT ...] [-L [IP:PORT ...]] [-k SSH_HOST_KEY]
[-K KEY_FILE] [-S KEY_PASSWORD] [-t] [-v] [-V] [-x IP:PORT]
[-c SSH_CONFIG_FILE] [-z] [-n] [-d [FOLDER ...]]
ssh_address
Pure python ssh tunnel utils
Version 0.5.1
positional arguments:
ssh_address SSH server IP address (GW for SSH tunnels)
set with "-- ssh_address" if immediately after -R or -L
Découvrez les outils les plus utilisés par notre communauté.
Pas encore de données de popularité.