📧 نفق وكيل SMTP

نفق خفي عالي السرعة يُخفي حركة مرور TCP على شكل اتصالات بريد إلكتروني SMTP لتجاوز جدران الحماية التي تقوم بفحص الحزم العميق (DPI).

┌─────────────┐      ┌─────────────┐      ┌─────────────┐      ┌──────────────┐
│ Application │─────▶│   Client    │─────▶│   Server    │─────▶│  Internet    │
│  (Browser)  │ TCP  │ SOCKS5:1080 │ SMTP │  Port 587   │ TCP  │              │
│             │◀─────│             │◀─────│             │◀─────│              │
└─────────────┘      └─────────────┘      └─────────────┘      └──────────────┘
                            │                    │
                            │   Looks like       │
                            │   Email Traffic    │
                            ▼                    ▼
                     ┌────────────────────────────────┐
                     │     DPI Firewall               │
                     │  ✅ Sees: Normal SMTP Session  │
                     │  ❌ Cannot see: Tunnel Data    │
                     └────────────────────────────────┘

---

🎯 الميزات

الميزة	الوصف
🔒 تشفير TLS	جميع حركة المرور مشفرة باستخدام TLS 1.2+ بعد STARTTLS
🎭 تجنب DPI	المصافحة الأولية تحاكي خوادم SMTP الحقيقية (Postfix)
⚡ سرعة عالية	بروتوكول تدفق ثنائي بعد المصافحة - عبء إضافي ضئيل
👥 متعدد المستخدمين	أسرار خاصة لكل مستخدم، قوائم IP مسموح بها، وإعدادات تسجيل دخول
🔑 المصادقة	مفاتيح مشتركة مسبقة لكل مستخدم مع HMAC-SHA256
🌐 وكيل SOCKS5	واجهة وكيل قياسية - تعمل مع أي تطبيق
📡 تعدد الإرسال	اتصالات متعددة عبر نفق واحد
🛡️ القائمة البيضاء للـ IP	التحكم في الوصول لكل مستخدم حسب عنوان IP / CIDR
📦 تثبيت سهل	تثبيت الخادم بسطر واحد مع خدمة systemd
🎁 حزم العميل	ملفات ZIP مولّدة تلقائياً لكل مستخدم
🔄 إعادة اتصال تلقائي	يتصل العميل تلقائياً عند فقدان الاتصال

📚 للحصول على تفاصيل تقنية متعمقة ومواصفات البروتوكول وتحليل الأمان، راجع TECHNICAL.md.

---

⚡ بداية سريعة

📋 المتطلبات الأساسية

• الخادم: VPS يعمل بنظام Linux و Python 3.8+، المنفذ 587 مفتوح
• العميل: Windows/macOS/Linux مع Python 3.8+
• اسم النطاق: مطلوب للتحقق من شهادة TLS (خيارات مجانية: DuckDNS، No-IP، FreeDNS)

---

🚀 إعداد الخادم (VPS)

الخطوة 1️⃣: احصل على اسم نطاق

احصل على نطاق مجاني يشير إلى VPS الخاص بك:

• 🦆 DuckDNS - موصى به، بسيط ومجاني
• 🌐 No-IP - خطة مجانية متوفرة
• 🆓 FreeDNS - العديد من خيارات النطاق

مثال: myserver.duckdns.org → 203.0.113.50 (عنوان IP لـ VPS الخاص بك)

الخطوة 2️⃣: تشغيل المثبت

curl -sSL https://raw.githubusercontent.com/x011/smtp-tunnel-proxy/main/install.sh | sudo bash

المثبت سيقوم بما يلي:

1. 📥 تنزيل وتثبيت كل شيء
2. ❓ السؤال عن اسم النطاق الخاص بك
3. 🔐 توليد شهادات TLS تلقائياً
4. 👤 عرض إنشاء أول مستخدم لك
5. 🔥 تكوين جدار الحماية
6. 🚀 بدء الخدمة

هذا كل شيء! خادمك جاهز.

➕ إضافة مستخدمين لاحقاً

smtp-tunnel-adduser bob      # إضافة مستخدم + توليد ملف ZIP للعميل
smtp-tunnel-listusers        # عرض جميع المستخدمين
smtp-tunnel-deluser bob      # إزالة مستخدم

🔄 تحديث الخادم

smtp-tunnel-update           # تحديث الكود، الحفاظ على الإعدادات/الشهادات/المستخدمين

---

💻 إعداد العميل

الخيار أ: الطريقة السهلة (موصى به)

1. احصل على ملف username.zip من مسؤول الخادم
2. قم باستخراج ملف ZIP
3. قم بتشغيل المُشغّل:

المنصة	كيفية التشغيل
🪟 Windows	انقر نقرًا مزدوجًا على start.bat
🐧 Linux	قم بتشغيل ./start.sh
🍎 macOS	قم بتشغيل ./start.sh

سوف يقوم المُشغّل بتثبيت التبعيات تلقائياً وبدء تشغيل العميل.

✅ يجب أن ترى:

SMTP Tunnel Proxy Client
User: alice

[INFO] Starting SMTP Tunnel...
[INFO] SOCKS5 proxy will be available at 127.0.0.1:1080

Connecting to myserver.duckdns.org:587
Connected - binary mode active
SOCKS5 proxy on 127.0.0.1:1080

الخيار ب: الطريقة اليدوية

cd alice
pip install -r requirements.txt
python client.py

الخيار ج: التكوين المخصص

# تنزيل الملفات
scp [email protected]:/etc/smtp-tunnel/ca.crt .

# إنشاء config.yaml:
cat > config.yaml << EOF
client:
  server_host: "myserver.duckdns.org"
  server_port: 587
  socks_port: 1080
  username: "alice"
  secret: "your-secret-from-admin"
  ca_cert: "ca.crt"
EOF

# تشغيل العميل
python client.py -c config.yaml

---

📖 الاستخدام

🌐 تكوين تطبيقاتك

اضبط وكيل SOCKS5 على: 127.0.0.1:1080

🦊 فايرفوكس

1. الإعدادات → إعدادات الشبكة → الإعدادات
2. تكوين الوكيل يدويًا
3. مضيف SOCKS: 127.0.0.1، المنفذ: 1080
4. اختر SOCKS v5
5. ✅ تأشير "استخدام وكيل DNS عند استخدام SOCKS v5"

🌐 كروم

1. قم بتثبيت إضافة "Proxy SwitchyOmega"
2. أنشئ ملف تعريف مع SOCKS5: 127.0.0.1:1080

🪟 ويندوز (على مستوى النظام)

الإعدادات → الشبكة والإنترنت → الوكيل → الإعداد اليدوي → socks=127.0.0.1:1080

🍎 ماك (على مستوى النظام)

تفضيلات النظام → الشبكة → خيارات متقدمة → الخوادم الوكيلة → وكيل SOCKS → 127.0.0.1:1080

🐧 لينكس (على مستوى النظام)

export ALL_PROXY=socks5://127.0.0.1:1080

💻 سطر الأوامر

# curl
curl -x socks5h://127.0.0.1:1080 https://ifconfig.me

# git
git config --global http.proxy socks5://127.0.0.1:1080

# متغير البيئة
export ALL_PROXY=socks5://127.0.0.1:1080

✅ اختبار الاتصال

# يجب أن يظهر عنوان IP لـ VPS الخاص بك
curl -x socks5://127.0.0.1:1080 https://ifconfig.me

---

⚙️ مرجع التكوين

🖥️ خيارات الخادم (config.yaml)

الخيار	الوصف	الافتراضي
host	واجهة الاستماع	0.0.0.0
port	منفذ الاستماع	587
hostname	اسم مضيف SMTP (يجب أن يتطابق مع الشهادة)	mail.example.com
cert_file	مسار شهادة TLS	server.crt
key_file	مسار المفتاح الخاص لـ TLS	server.key
users_file	مسار ملف تكوين المستخدمين	users.yaml
log_users	إعداد تسجيل الدخول العام	true

👥 خيارات المستخدم (users.yaml)

يمكن لكل مستخدم الحصول على إعدادات فردية:

users:
  alice:
    secret: "auto-generated-secret"
    # whitelist:              # اختياري: تقييد لعناوين IP محددة
    #   - "192.168.1.100"
    #   - "10.0.0.0/8"        # تدوين CIDR مدعوم
    # logging: true           # اختياري: تعطيل لتوقف تسجيل هذا المستخدم

  bob:
    secret: "another-secret"
    whitelist:
      - "203.0.113.50"        # يمكن لـ Bob الاتصال فقط من هذا الـ IP
    logging: false            # لا تسجل نشاط Bob

الخيار	الوصف	الافتراضي
secret	سر المصادقة للمستخدم	مطلوب
whitelist	عناوين IP المسموح بها لهذا المستخدم (مدعوم CIDR)	جميع عناوين IP
logging	تفعيل تسجيل النشاط لهذا المستخدم	true

💻 خيارات العميل

الخيار	الوصف	الافتراضي
server_host	اسم نطاق الخادم	مطلوب
server_port	منفذ الخادم	587
socks_port	منفذ SOCKS5 المحلي	1080
socks_host	واجهة SOCKS5 المحلية	127.0.0.1
username	اسم المستخدم الخاص بك	مطلوب
secret	سر المصادقة الخاص بك	مطلوب
ca_cert	شهادة CA للتحقق	موصى به

---

📋 إدارة الخدمة

# التحقق من الحالة
sudo systemctl status smtp-tunnel

# إعادة التشغيل بعد تغيير التكوين
sudo systemctl restart smtp-tunnel

# عرض السجلات
sudo journalctl -u smtp-tunnel -n 100

# إلغاء التثبيت
sudo /opt/smtp-tunnel/uninstall.sh

---

🔧 خيارات سطر الأوامر

🖥️ الخادم

python server.py [-c CONFIG] [-d]

  -c, --config    ملف التكوين (الافتراضي: config.yaml)
  -d, --debug     تفعيل تسجيل التصحيح

💻 العميل

python client.py [-c CONFIG] [--server HOST] [--server-port PORT]
                 [-p SOCKS_PORT] [-u USERNAME] [-s SECRET] [--ca-cert FILE] [-d]