`jupyter_client.ssh.tunnel:paramiko_tunnel`

source: /jupyter_client/ssh/tunnel.py:325

Signature

def paramiko_tunnel(lport: int, rport: int, server: str, remoteip: str = 127.0.0.1, keyfile: str | None = None, password: str | None = None, timeout: float = 60) → Process

Summary

launch a tunner with paramiko in a subprocess. This should only be used when shell ssh is unavailable (e.g. Windows).

Extended Summary

This creates a tunnel redirecting localhost:lport to remoteip:rport, as seen from server.

If you are familiar with ssh tunnels, this creates the tunnel:

ssh server -L localhost:lport:remoteip:rport

keyfile and password may be specified, but ssh config is checked for defaults.

Parameters

lport : int: local port for connecting to the tunnel from this machine.
rport : int: port on the remote machine to connect to.
server : str: The ssh server to connect to. The full ssh server string will be parsed. user@server:port
remoteip : str [Default: 127.0.0.1]: The remote ip, specifying the destination of the tunnel. Default is localhost, which means that the tunnel would redirect localhost:lport on this machine to localhost:rport on the server.
keyfile : str; path to public key file: This specifies a key to be used in ssh login, default None. Regular default ssh keys will be used without specifying this argument.
password : str;: Your ssh password to the ssh server. Note that if this is left None, you will be prompted for it if passwordless key based login is unavailable.
timeout : int [default: 60]: The time (in seconds) after which no activity will result in the tunnel closing. This prevents orphaned tunnels from running forever.

Aliases

jupyter_client.ssh.paramiko_tunnel