
أنفاق SSH إلى الخادم البعيد.
|الاختبارات| |AppVeyor| |readthedocs| |coveralls| |الإصدار|
|إصدارات بايثون| |الترخيص|
المؤلف: Pahaz_
المستودع: https://github.com/pahaz/sshtunnel/
مستوحى من https://github.com/jmagnusson/bgtunnel، والذي لا يعمل على Windows.
انظر أيضًا: https://github.com/paramiko/paramiko/blob/master/demos/forward.py
paramiko_sshtunnel_ موجود على PyPI، لذا ببساطة شغّل:
::
pip install sshtunnel
أو ::
easy_install sshtunnel
أو ::
conda install -c conda-forge sshtunnel
ليتم تثبيته في بيئتك.
للتثبيت من المصدر، استنسخ
المستودع <https://github.com/pahaz/sshtunnel>_ وشغّل::
python setup.py install
من أجل تشغيل الاختبارات تحتاج أولاً إلى
tox <https://testrun.org/tox/latest/>_ ثم شغّل::
python setup.py test
أحد السيناريوهات النموذجية التي يكون فيها sshtunnel مفيدًا موضّح في
الشكل أدناه. قد يحتاج المستخدم إلى الاتصال بمنفذ على خادم بعيد (أي 8080)
حيث لا يكون متاحًا سوى منفذ SSH (عادةً المنفذ 22). ::
----------------------------------------------------------------------
|
-------------+ | +----------+
LOCAL | | | REMOTE | :22 SSH
CLIENT | <== SSH ========> | SERVER | :8080 web service
-------------+ | +----------+
|
FIREWALL (only port 22 is open)
----------------------------------------------------------------------
الشكل 1: كيفية الاتصال بخدمة محجوبة بواسطة جدار حماية عبر نفق SSH.
إذا سمح خادم SSH بذلك، فمن الممكن أيضًا الوصول إلى خادم خاص
(من منظور REMOTE SERVER) غير مرئي مباشرةً من
الخارج (من منظور LOCAL CLIENT). ::
----------------------------------------------------------------------
|
-------------+ | +----------+ +---------
LOCAL | | | REMOTE | | PRIVATE
CLIENT | <== SSH ========> | SERVER | <== local ==> | SERVER
-------------+ | +----------+ +---------
|
FIREWALL (only port 443 is open)
----------------------------------------------------------------------
الشكل 2: كيفية الاتصال بـ PRIVATE SERVER عبر نفق SSH.
تتيح واجهة API إما تهيئة النفق وبدء تشغيله أو استخدام سياق with،
والذي سيتولى بدء وإيقاف النفق:
يتبع الكود المقابل لـ الشكل 1 أعلاه، بافتراض أن عنوان الخادم البعيد هو
pahaz.urfuclub.ru، ومصادقة بكلمة مرور، ومنفذ ربط محلي مُعيَّن عشوائيًا.
.. 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()
مثال على إعادة توجيه منفذ إلى خادم خاص غير قابل للوصول مباشرةً، بافتراض مصادقة pkey محمية بكلمة مرور، وخدمة SSH على الخادم البعيد تستمع على المنفذ 443 وأن هذا المنفذ مفتوح في جدار الحماية (الشكل 2):
.. 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!')
مثال على إعادة توجيه المنفذ لـ Vagrant MySQL المحلي:
.. 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!')
أو ببساطة باستخدام CLI:
.. code-block:: console
(bash)$ python -m sshtunnel -U vagrant -P vagrant -L :3306 -R 127.0.0.1:3306 -p 2222 localhost
فتح جلسة SSH مع القفز عبر نفقين. سيتم تشغيل نقل SSH والأنفاق كخدمات خلفية (daemonised)، والتي لن تنتظر توقف الاتصالات عند الإغلاق.
.. 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