العودة إلى التحديثات
New releaseSep 12, 2026

pingtunnel master-d7cd0d6ab5f18e7d8d050385e8d240b3b2f41e6c

Pingtunnel هي أداة ترسل حركة مرور TCP/UDP عبر ICMP

مشاركة

Pingtunnel

codecov

Pingtunnel هي أداة شبكة تقوم بنفق حركة مرور TCP/UDP/SOCKS5 عبر حزم ICMP Echo (Ping) لتجاوز جدران الحماية الشبكية الصارمة أو حركة مرور TCP/UDP المقيّدة.

⚠️ ملاحظة: هذه الأداة مخصصة بشكل صارم لأغراض الدراسة والبحث. لا تستخدمها لأي غرض غير قانوني.

image


🌟 الميزات

  • بنية أمان v3 موحّدة: اختفى المفتاح الرقمي القديم ومفاتيح التشفير المنفصلة. كلمة مرور مشتركة واحدة (-password) تقود المصادقة المتبادلة والتشفير الشامل من طرف إلى طرف AEAD (الافتراضي chacha20-poly1305، واختياريًا aes256/aes128).
  • أوضاع متعددة:
    • وكيل SOCKS5: ابدأ وكيل SOCKS5 محليًا بأمر واحد، مع مصادقة اختيارية باسم المستخدم/كلمة المرور؛
    • إعادة توجيه منفذ TCP: الوصول إلى منفذ TCP بعيد محدد (مثل SSH، الويب، RDP)؛
    • إعادة توجيه منفذ UDP: إعادة توجيه حركة مرور UDP للألعاب، DNS 53، إلخ؛
    • إعادة التوجيه الثانوية من جانب الخادم (-forward): يمكن للخادم تمرير حركة المرور الواردة عبر وكيل SOCKS5/HTTP المنبع.
  • تكوين مرن (يُوصى بوضع ملف التكوين):
    • التشغيل مباشرة باستخدام ملف تكوين: pingtunnel config.json أو pingtunnel -c config.json؛
    • يتم تحميل config.json في الدليل الحالي تلقائيًا بشكل افتراضي؛
    • تتجاوز أعلام سطر الأوامر دائمًا قيم ملف التكوين المطابقة.
  • مرونة على الشبكات الضعيفة: خوارزمية تحكم في الازدحام مدمجة تتكيف مع النطاق الترددي (bb) تكبح انتفاخ المخزن المؤقت والتوقفات الناتجة عن فقدان الحزم.

🚀 البدء السريع

الخيار 1: وضع ملف التكوين (موصى به)

تأتي ملفات نموذجية مع المستودع. ما عليك سوى إدخال عنوان IP الخاص بخادمك وكلمة مرور قوية:

1. تكوين الخادم (config-server.json)

{
  "type": "server",
  "password": "YOUR_STRONG_PASSWORD_HERE",
  "encrypt": "chacha20",
  "icmp_listen": "0.0.0.0"
}

ابدأ تشغيل الخادم (يتطلب صلاحيات الجذر / المسؤول):

sudo ./pingtunnel config-server.json
# or: sudo ./pingtunnel -c config-server.json

2. إعدادات العميل (وضع وكيل SOCKS5، config-client-socks5.json)

{
  "type": "client",
  "listen": "127.0.0.1:1080",
  "server": "YOUR_SERVER_IP",
  "socks5": true,
  "password": "YOUR_STRONG_PASSWORD_HERE",
  "encrypt": "chacha20"
}

ابدأ العميل:

./pingtunnel config-client-socks5.json
# or: ./pingtunnel -c config-client-socks5.json

ثم اضبط المتصفح أو وكيل النظام على SOCKS5 127.0.0.1:1080.


الخيار 2: سطر الأوامر (CLI)

1. بدء الخادم

شغّله على جهاز يمتلك عنوان IP عام:

sudo ./pingtunnel -type server -password YOUR_STRONG_PASSWORD_HERE

(اختياري) عطّل ردود صدى ICMP الافتراضية لنواة Linux لتجنب التداخل:

echo 1 > /proc/sys/net/ipv4/icmp_echo_ignore_all

2. بدء العميل

  • وضع وكيل SOCKS5:
    ./pingtunnel -type client -l 127.0.0.1:1080 -s YOUR_SERVER_IP -socks5 -password YOUR_STRONG_PASSWORD_HERE
    
  • إعادة توجيه منفذ TCP (الوضع الافتراضي، مثل تعيين المنفذ الداخلي البعيد 192.168.1.100:22 إلى المنفذ المحلي 2222):
    ./pingtunnel -type client -l :2222 -s YOUR_SERVER_IP -t 192.168.1.100:22 -password YOUR_STRONG_PASSWORD_HERE
    
  • إعادة توجيه UDP (مثل المنفذ المحلي 5353 إلى DNS العام 8.8.8.8:53):
    ./pingtunnel -type client -l :5353 -s YOUR_SERVER_IP -t 8.8.8.8:53 -udp -password YOUR_STRONG_PASSWORD_HERE
    

🐳 Docker

تشغيل الخادم

docker run --name pingtunnel-server -d \
  --restart=always \
  --privileged \
  --network host \
  esrrhs/pingtunnel ./pingtunnel -type server -password YOUR_STRONG_PASSWORD_HERE

التشغيل باستخدام ملف إعدادات مُثبَّت

docker run --name pingtunnel-server -d \
  --restart=always \
  --privileged \
  --network host \
  -v /etc/pingtunnel/server.json:/app/server.json:ro \
  esrrhs/pingtunnel ./pingtunnel /app/server.json

📖 دليل الاستخدام والضبط المفصّل

للاطلاع على الخيارات والبنى الأكثر تقدمًا (الوكيل الثانوي من جانب الخادم، وإعادة توجيه المنافذ، ومصادقة SOCKS5، والتحكم في التدفق وضبط الازدحام)، راجع: 👉 USAGE.md - دليل استخدام وإعداد Pingtunnel

الفئات