Skip to content
KitploitKITPLOIT
أدواتعمليات الاستغلالالمدونة
Log in
إرسال
أدواتعمليات الاستغلالالمدونة
إرسال

أدوات الاختراق واختبار الاختراق والأمن السيبراني لترسانتك الأمنية!

Kitploit هو دليل لأدوات الاختراق والأمن السيبراني واختبار الاختراق. اكتشف آخر تحديثات المشاريع للعثور على الثغرات وتحليل الأنظمة وأتمتة الاختبارات وتعزيز أمنك.

الخلاصاتاتصالالخصوصية© 2026 Kitploit

دليل الأدوات

الفئات

عرض جميع الفئات
Loading categories
sshtunnel — أنفاق SSH إلى الخادم البعيد. | Kitploit
أدوات/GitHubGitHub/pahaz/sshtunnel
أدوات عامةأمن الشبكاتالأدوات والمكونات
GitHubpahaz/sshtunnel

sshtunnel

أنفاق SSH إلى الخادم البعيد.

عرض المستودع
1.3k20248منذ 6 أيامتمت المراجعة من قبل Kitploit
مشاركة

|الاختبارات| |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

يتبع الكود المقابل لـ الشكل 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()

المثال 2

مثال على إعادة توجيه منفذ إلى خادم خاص غير قابل للوصول مباشرةً، بافتراض مصادقة 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!')

المثال 3

مثال على إعادة توجيه المنفذ لـ 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

المثال 4

فتح جلسة 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(...)

استخدام CLI

::

$ 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
تنزيل الأداة

الأكثر شعبية

عرض الكل →

اكتشف الأدوات الأكثر استخدامًا من قبل مجتمعنا.

لا توجد بيانات شعبية بعد.

استكشف جميع الأدوات

تصفح مجموعتنا من الأدوات

عرض جميع الأدوات →