
NAT Tunnel: لتقديم الخدمات بسهولة من خلف NAT
ملاحظة: نسخة Python القديمة نهائية وغير مُصانة. توجد تعليماتها في نهاية هذا الملف. وهي غير متوافقة مع نسخة C الحالية. استخدم C فقط.
إذا كان لديك وصول إلى خادم ذي IP عام ومنافذ غير مُفلترة يمكنك تشغيل خادم NAT Tunnel (NT) على الخادم، وعميل NT على جهازك خلف NAT. يتطلب الخادم منفذين مفتوحين: أحدهما للتواصل مع عميل NT (--admin)، والآخر لاتصال العملاء العاديين به (--public: هذا هو المنفذ الذي تريد أن يستخدمه مستخدموك).
يفتح عميل NT اتصالاً بعنوان IP/منفذ الإدارة الخاص بالخادم. بمجرد أن يستقبل الخادم اتصالاً جديداً، فإنه يُشير إلى عميل NT، الذي ينشئ بعد ذلك اتصال نفق جديداً إلى الخادم، والذي يتصل بعد ذلك بالخدمة المطلوبة على جانب عميل NT (--local)
الاتصال بين عميل NT وخادم NT على واجهة الإدارة محمي بسر مشترك ضد الاستخدام غير المصرح به. يمكن لخصم قادر على اعتراض الحزم كسر السر إذا لم يكن بدرجة كافية من التعقيد. يُوصى بما لا يقل عن 10 أحرف وأرقام عشوائية.
مثال: لديك خادم HTTP يستمع على جهازك المحلي على المنفذ 80. تريد إتاحته على IP العام لخادمك السحابي/VPS/إلخ على المنفذ 8000. نستخدم المنفذ 7000 على الخادم السحابي لقناة التحكم.
الخادم:
./natsrv --mode server --secret-file secret.txt --server-key server.key --public 0.0.0.0:8000 --admin 0.0.0.0:7000
العميل:
./natsrv --mode client --secret-file secret.txt --server-pubkey PUBKEY_HEX --local localhost:80 --admin example.com:7000
يعمل كل من IPv4 وIPv6 في كل مكان. صيغة العنوان هي host:port. بالنسبة لعناوين IPv6 الحرفية استخدم الأقواس المربعة: [::1]:8080، [2001:db8::1]:7000. يُرفض عنوان IPv6 المجرد بدون أقواس مربعة، لأن النقطتين تجعلان المنفذ غامضاً. بالنسبة لأسماء المضيفين يُفضَّل IPv4 ويكون IPv6 هو البديل؛ والعنوان الرقمي الحرفي الصريح يفوز دائماً لعائلته الخاصة. عنوان الاستماع 0.0.0.0 يعني IPv4 على جميع الواجهات، و:: يعني IPv6 على جميع الواجهات. على الشبكة يُبلِّغ الخادم عن النظير بصيغة ip:port لـ IPv4 و [ip]:port لـ IPv6، ويحلل الجانبان كلتا الصيغتين.
ولّد مفتاح توقيع الخادم مرة واحدة:
./natsrv --genkey server.key
يكتب هذا المفتاح الخاص بأذونات 0600 ويطبع المفتاح العام بصيغة hex. أعطِ سلسلة hex هذه للعميل كـ --server-pubkey. يتطلب الخادم --server-key، ويتطلب العميل --server-pubkey. فضِّل --secret-file PATH على --secret في الأجهزة المشتركة، لأن --secret يتسرب عبر ps aux.
ابنِ باستخدام GNU Make العادي (3.82 أو أحدث):
make
ينتج هذا ./natsrv. يبدأ ملف Makefile بـ -include config.mak قبل الهدف الأول، لذا يمكن لملف config.mak محلي أن يضبط CFLAGS وCPPDFGS وLDFLAGS وما شابه ذلك بشكل دائم. يُلحق Makefile إعداداته الافتراضية بـ CFLAGS += -Wall -std=c99. كما تمر الخيارات على سطر أوامر Make أيضاً:
make CPPFLAGS=-DHAVE_GETRANDOM
make CFLAGS="-Wall -Wextra -std=c99 -pedantic"
make USE_SODIUM=1
make clean
HAVE_GETRANDOM: افتراضياً تأتي العشوائية من /dev/urandom. عرِّف HAVE_GETRANDOM لاستخدام استدعاء النظام getrandom() بدلاً من ذلك (Linux 3.17+ / glibc 2.25+). كلا المسارين يفشل مغلقاً. الربط هو -lpthread افتراضياً، بالإضافة إلى -lsodium مع USE_SODIUM=1. الكود نفسه هو C99 ومحمول بدون امتدادات GNU99. تُستخدم علامات الجدولة للمسافة البادئة، اتباعاً لأسلوب كود microsocks.
يستخدم تشفير النفق XSalsa20. افتراضياً يوفره كود TweetNaCl المضمَّن (tweetnacl.c، tweetnacl.h). مع USE_SODIUM=1 فإنه يربط libsodium بدلاً من ذلك. كود sha256 في sha256.c مكتوب من الصفر؛ لا حاجة إلى مكتبة تشفير للبناء الافتراضي.
على x86 مع امتدادات Intel SHA، يستخدم sha256.c دوال SHA-NI الجوهرية تلقائياً عندما يعرِّف المترجم SHA و__SSSE3__. يبقى التنفيذ العددي هو البديل. فعِّله بدون -march=native:
make CPPFLAGS="-msha -msse4.1"
يبني هذا ملفًا ثنائيًا يحتاج إلى أي معالج x86 يدعم SHA-NI و SSE4.1، دون ميزات -march=native الأخرى. لا يزال make العادي دون تلك الأعلام يعمل في كل مكان.
مقيس على i7-1160G7، SHA256 الخام لكتل بحجم 16 KiB: scalar -O2 حوالي 257 MB/s، SHA-NI -O2 حوالي 1574 MB/s (أسرع بنحو 6 مرات).
لمقابس النفق مهلات إرسال واستقبال، تُضبط بـ --timeout SECS (الافتراضي 1800، و0 يعطّلها). القيمة الافتراضية متحفظة عمدًا: خادم بطيء مثل llama.cpp أقل من 10 رموز في الثانية، أو رفع موجه نظام ضخم، قد يحجب بشكل مشروع لعدة دقائق. القيم الأقصر تقتل مثل هذه الأنفاق؛ والقيم الأطول تؤخر اكتشاف المقبس الميت. لا تحصل مقابس التحكم على المهلة أبدًا، لذا لا يُقتل اتصال تحكم خامل.
تستخدم جميع المقابس TCP keepalive مع فحوص كل 30 ثانية من وقت الخمول (فاصل 5 ثوانٍ، 3 فحوص)، لذا يُكتشف الطرف الميت بصمت في حوالي 45 ثانية بدلًا من الافتراضي البالغ ساعتين.
يشغّل كل من العميل والخادم حلقة poll واحدة. لا يحجب أي من الطرفين في accept. يستقصي العميل مقبس التحكم والمقبس الاحتياطي معًا، ويعيد تسليح الاحتياطي عندما يُظهر الاحتياطي بيانات أو خطأ أو يفشل في فحص الموت كل 5 ثوانٍ. يستقصي الخادم مستمع الإدارة، والمستمع العام، ومقبس التحكم، و المقبس الاحتياطي معًا. ونتيجة لذلك، يخدم الخادم المنفذ العام بينما لا يملك احتياطيًا، ولا يتوقف أبدًا عن مراقبة مقبس التحكم.
يُعاد تعيين أي اتصال عام يصل بينما لا يوجد احتياطي حي فورًا. يرى الطرف الآخر فشلًا، لا تعليقًا. يُسقط الاحتياطي الذي يُظهر بالفعل FIN أو RST ويُعاد تسليحه قبل إقرانه، لذا لا يصل احتياطي ميت إلى نفق أبدًا. لا تُعامل البيانات القابلة للقراءة وحدها كموت على احتياطي على وشك الإقران، لأن بايتات النفق قد تكون مشروعة في الطريق.
شغّل المجموعة كاملة بـ:
make test
يتطلب هذا python3 ويبني natsrv أولًا. تبدأ المجموعة عمليات خادم وعميل حقيقية على منافذ loopback. يحصل كل اختبار على منافذه ودليل عمله وسجلاته الخاصة، لذا لا يتسرب فشل إلى الاختبار التالي أبدًا.
يمكن اختيار الاختبارات بالاسم، وسردها:
python3 tests/natt.py --list
python3 tests/natt.py spare_rst control_rst
يستخدم حقن الأعطال وكيل TCP أمام منفذ الإدارة (tests/natt.py، الفئة FaultProxy). يحصل كل اتصال مقبول على معرّف بترتيب القبول ودور يُقرأ من تحية عميله، لذا يُفصل بين مقبس التحكم والمقبس الاحتياطي. يمكن للاختبار إسقاط أحدهما بـ RST، أو إسقاطه بـ FIN، أو تجميده، أي إيقاف تمرير البايتات بينما يبقى المقبسان مفتوحين. تجميد مقبس التحكم يحاكي مسارًا ميتًا بصمت. تستمر نواة الطرف الآخر في الرد على فحوص keepalive على loopback، لذا يُسقط اختبار control_blackhole الحزم بـ iptables بدلًا من ذلك. يتطلب ذلك الاختبار صلاحيات الجذر ويُتخطى بخلاف ذلك.
تكتشف الاختبارات البطيئة الثقب الأسود عبر TCP keepalive، وهو يستغرق حوالي 45 ثانية. تعمل فقط عند الطلب:
make test-slow
يذهب كل إخراج وحدة التحكم إلى stderr، عبر استدعاء dprintf() واحد لكل سطر (الماكرو dolog، منقول من microsocks sockssrv.c). لا يكون stderr مخزنًا سطريًا، ويكتب dprintf مباشرة إلى fd. لا يحتاج أي منهما إلى قفل stdio، لذا فإن dolog آمن من أي خيط ولا حاجة إلى fflush بعد السطر. وجّه السجل بـ 2> file.
الطابع الزمني جزء من استدعاء dprintf نفسه الذي يحمل الرسالة. لذلك لا تتشابك المصافحات المتزامنة أبدًا داخل سطر. الخيط الرئيسي فقط هو من يطبع عمليًا، لذا يبقى الترتيب مقروءًا.
نص المساعدة (--help) هو إجابة استدعاء CLI ويذهب إلى stdout. كل شيء آخر، بما في ذلك إخراج --genkey، يذهب إلى stderr.
كل قرين يتصل بمنفذ الإدارة يستقبل تحية الخادم (server hello) ثم مهلة قدرها 1.5 ثانية لاستقبال تحية عميل (client hello) صالحة. القرين الذي لا يملك السر المشترك يفشل في فحص MAC ويُعاد ضبط مقبسه. لذلك لا يكلف ماسح منافذ عابر سوى مصافحة واحدة، ولا يُسقط أبدًا مقبس تحكم نشطًا. فقط القرين الذي يثبت امتلاكه للسر المشترك يمكنه استبدال مقبس تحكم نشط، وهكذا يتولى العميل المُعاد تشغيله التحكم. تجري المصافحة داخل حلقة الاستقصاء الرئيسية، لذا فإن الماسح الذي يتوقف يؤخر الحلقة بمقدار مهلة التحية على الأكثر.
إطارات ثنائية مسبوقة بالطول: بايت النوع زائد طول الحمولة uint16 بترتيب big endian زائد الحمولة. الأنواع: 1 تحية الخادم، 2 تحية العميل، 3 تحكم، 4 نفق، 5 خطأ، 6 إغلاق. بيانات النفق نفسها هي تدفق بايتات خام داخل إطارات النفق على القناة الاحتياطية، مشفرة بـ XSalsa20 عندما يكون بايت الطلب 2 (sk2). تحمل إطارات التحكم عناوين أقران CONN وهي مشفرة دائمًا.