💬 تثبيت Signal REST API — إرسال واستقبال رسائل سيجنال المشفرة برمجياً على Docker
نشر بوابة Signal CLI REST API على Ubuntu باستخدام Docker — البوابة مفتوحة المصدر الرائدة لإرسال واستقبال رسائل Signal المشفرة تماماً والمرفقات والتنبيهات برمجياً عبر واجهة JSON REST API.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/communication/signal-api/signal-api-ubuntu.sh
chmod +x signal-api-ubuntu.sh
sudo bash signal-api-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/communication/signal-api/signal-api-ubuntu.sh
2 منح صلاحية التنفيذ
chmod +x signal-api-ubuntu.sh
3 تشغيل المثبت
يقوم السكريبت بتثبيت Docker وتجهيز مجلد التخزين الدائم للمفاتيح (`./data`) وتشغيل حاوية Signal CLI REST API الرسمية على المنفذ 8225 (المحول من 8080 الداخلي).
sudo bash signal-api-ubuntu.sh
4 ربط حساب سيجنال وإرسال أول رسالة
افتح الرابط http://ip-سيرفرك:8225/v1/qrcodelink، وامسح رمز الـ QR من تطبيق Signal بهاتفك (الإعدادات ← الأجهزة المرتبطة)، واختبر إرسال الرسائل عبر Swagger على مسار `/v1/send`.
http://<your-server-ip>:8225/v1/qrcodelink?device_name=server
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 8225 | REST API (host → container 8080) |
| ./data | Linked-account data — holds the device-link keys |
| device link | Links to an existing Signal account via QR (like Signal Desktop) |
نظرة عامة
تعد Signal CLI REST API بوابة برمجية خفيفة ومفتوحة المصدر تغلف أداة `signal-cli`. تعمل المنصة عبر المنفذ 8225 (المحول من 8080 الداخلي)، وتقوم بتحويل بروتوكول سيجنال الآمن إلى نقاط نهاية JSON بسيطة. وتتيح للسكريبتات وأنظمة المراقبة والمنازل الذكية إرسال واستقبال الرسائل النصية، والصور، والمستندات، والتسجيلات الصوتية، والتفاعلات، وإشعارات المجموعات المشفرة تشفيراً تاماً بين الطرفين (E2EE) عبر شبكة Signal الرسمية باستخدام طلبات HTTP POST عادية.
لماذا تستخدمه
يتطلب استخدام بوابات الرسائل القصيرة التجارية (مثل Twilio) دفع اشتراكات باهظة لكل رسالة، فضلاً عن نقل الرسائل بنصوص مكشوفة عبر شبكات الاتصالات غير الآمنة. تمنحك Signal CLI REST API إمكانية إرسال عدد غير محدود من التنبيهات والإشعارات المشفرة بأقوى المعايير العسكرية إلى هاتفك أو مجموعات فريقك مجاناً بالكامل وبأعلى درجات الخصوصية.
متى تحتاجه
- تريد إرسال تنبيهات السيرفرات وإشعارات النسخ الاحتياطي وإنذارات الأمان لهاتفك عبر رسائل Signal المشفرة
- تبحث عن بديل مجاني ومفتوح المصدر لبوابات الرسائل القصيرة SMS مع تشفير تام من البداية للنهاية
- تحتاج إلى ربط إشعارات Signal مع أنظمة Home Assistant وGrafana وZabbix وUptime Kuma وسكريبتات بايثون
- تريد بناء روبوتات محادثة (Chatbots) تفاعلية على سيجنال تستقبل الأوامر وتنفذ المهام بالسيرفر
- تريد ربط حساب هاتفك الحالي بجهاز خادم كجهاز مقترن ثانوي عبر مسح رمز الاستجابة السريعة (QR)
من يحتاجه
- مديرو الأنظمة لإرسال تنبيهات انقطاع الخوادم ومساحة الأقراص الحرجة لمجموعات Signal المغلقة
- مهندسو الـ DevOps لربط إشعارات نجاح وفشل مسارات النشر في الـ CI/CD
- عشاق المنازل الذكية لاستقبال لقطات كاميرات المراقبة وحساسات الأبواب على تطبيق Signal فورياً
- مسؤولو الأمن السيبراني لبناء قنوات اتصال مشفرة مستقلة ومخصصة لإدارة الطوارئ والحوادث
- المطورون لبناء أدوات خدمة عملاء وروبوتات تفاعلية مؤتمتة على شبكة Signal
حالات الاستخدام الشائعة
- إرسال تنبيه فوري من Uptime Kuma أو Grafana مع تشخيص السيرفر إلى قناة Signal الخاصة بفريق الدعم
- إرسال بصمات وتأكيدات اكتمال النسخ الاحتياطي اليومي لقواعد البيانات لهاتف المشرف
- إرسال لقطات كاميرات المراقبة من Home Assistant عبر Signal فور اكتشاف حركة أمام الباب
- بناء بوت تفاعلي بحيث يؤدي الرد عليه بـ `reboot web1` إلى إعادة تشغيل السيرفر بأمان
- إرسال رموز التحقق الثنائي (2FA) وروابط استعادة كلمات المرور عبر قنوات مشفرة
الميزات الرئيسية
- واجهة برمجية JSON REST API بسيطة: إرسال واستقبال الرسائل بطلبات HTTP GET وPOST القياسية
- توثيق تفاعلي بـ Swagger UI: تجربة واختبار كافة نقاط النهاية البرمجية مباشرة من المتصفح على المنفذ 8225
- ربط الحسابات عبر رمز الـ QR: ربط حساب سيجنال الحالي في ثوانٍ دون الحاجة لاستقبال رسائل SMS تفعيل
- دعم كامل للمرفقات والوسائط: إرسال واستقبال الصور (JPEG/PNG) ومستندات PDF والتسجيلات الصوتية والفيديو
- إدارة المجموعات والتفاعلات: إنشاء وإدارة مجموعات سيجنال، والإشارة للأعضاء، وإرسال تفاعلات الإيموجي
- بث مباشر عبر WebSocket وWebhooks: استقبال الرسائل وإشعارات القراءة الواردة لحظياً في سكريبتاتك
- تشفير تام بين الطرفين: اعتماد بروتوكول Signal Protocol الرسمي الذي يضمن سرية البيانات التامة
- نشر منظم عبر Docker مع ربط مجلد `./data` بالمسار `/home/.local/share/signal-cli` لحفظ المفاتيح المشفرة
كيفية الاستخدام بعد التثبيت
- افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:8225/v1/qrcodelink?device_name=ServerAlerts
- افتح تطبيق Signal على هاتفك، وانتقل إلى الإعدادات ← الأجهزة المرتبطة ← 'ربط جهاز جديد' وامسح رمز الـ QR
- افتح صفحة التوثيق التفاعلي على الرابط `http://ip-سيرفرك:8225/v1/docs`
- جرب إرسال رسالة: أرسل طلب POST إلى `/v2/send` مع رقم هاتفك المسجل ورقم المستلم ونص الرسالة
- ضع الواجهة البرمجية خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx) مع شهادة SSL ومصادقة بالتوكن
- اربط نقطة نهاية الـ API بأدوات المراقبة لديك (مثل Uptime Kuma أو Grafana أو سكريبتات Bash)
أفضل ممارسات الأمان
- تنبيه أمني حاسم: الواجهة البرمجية تعمل بدون كلمة مرور افتراضياً؛ احرص على حمايتها بوضعها خلف وكيل عكسي مع مفتاح API أو Basic Auth
- لا تكشف المنفذ 8225 للإنترنت العام مباشرة، لأن ذلك يتيح لأي شخص إرسال رسائل برقم هاتفك المسجل
- احمِ مجلد البيانات `./data` الذي يحتوي على مفاتيح التشفير الخاصة لحساب سيجنال بصلاحيات نظام صارمة
- افرض تشفير HTTPS على كافة استدعاءات الـ API لمنع تسريب أرقام الهواتف ونصوص الرسائل على الشبكة المحلية
- اقصر الوصول للواجهة البرمجية على السيرفرات والشبكات الداخلية الموثوقة
- حدّث صورة الحاوية دورياً لضمان توافقها المستمر مع بروتوكولات شبكة Signal الرسمية
المنافذ وإعدادات جدار الحماية
يقدم تطبيق Signal CLI REST API واجهته البرمجية وتوثيق Swagger عبر منفذ TCP 8225 (المحول من 8080 الداخلي). يجب السماح بالمنفذ 8225 في جدار الحماية للشبكة المحلية الموثوقة فقط (`ufw allow 8225/tcp`). وفي الإنتاج، وجه حركة المرور عبر وكيل عكسي مشفر بـ SSL على المنفذ 443 مع التحقق من توكن الـ API وأبقِ المنفذ 8225 مغلقاً خارجياً.
النسخ الاحتياطي والصيانة
- انسخ مجلد `./data` احتياطياً، والذي يحتوي على مفاتيح الهوية المشفرة لحساب هاتفك المسجل
- احتفظ بنسخة من ملف `docker-compose.yml` الذي يحتوي على متغيرات البيئة ومسارات التخزين
- أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية عبر restic أو rsync
- اختبر الاستعادة بربط مجلد البيانات بحاوية تجريبية والتأكد من إمكانية قراءة الحساب المسجل بنجاح
الأخطاء الشائعة
- كشف المنفذ 8225 للإنترنت العام بدون مفتاح أمان مما يتيح للغرباء استخدام حسابك لإرسال رسائل عشوائية
- عدم ربط مجلد التخزين الدائم `./data`، مما يسبب فقدان اقتران حساب سيجنال عند تحديث الحاوية
- نسيان تفعيل وضع `MODE=json-rpc` في متغيرات البيئة لضمان سرعة معالجة الرسائل الكثيفة
- محاولة تفعيل رقم هاتف عبر الرسائل النصية على أرقام VoIP المحظورة من سيجنال (استخدم ميزة ربط الأجهزة QR بدلاً من ذلك)
- إرسال رسائل عشوائية مكثفة للغرباء مما يدفع خوارزميات سيجنال لحظر الحساب بسبب السبام
استكشاف الأخطاء وإصلاحها
- فشل مسح رمز الـ QR — تأكد من مزامنة ساعة السيرفر بدقة عبر بروتوكول NTP بالأمر `timedatectl`
- فشل الإرسال وظهور 'Unregistered user' — تأكد من كتابة رقم هاتف المستلم بالصيغة الدولية الكاملة E.164 (مثل `+2010...`)
- ظهور خطأ 502 Bad Gateway في الواجهة — افحص سجلات الحاوية بالأمر: `docker logs signal-api -f`
- الحساب محظور مؤقتاً من سيجنال — انتظر ساعة أو ساعتين وخفف من معدل إرسال الرسائل المتزامنة
- فشل إرسال المرفقات — تأكد من توفر الملف داخل مسار الحاوية أو إرساله مشفراً بنظام Base64
البدائل
بروتوكول Matrix / Synapse اللامركزي. خادم Gotify للإشعارات الفورية. خادم ntfy للإشعارات ببروتوكول HTTP. بوتات Telegram Bot API السحابية. خدمة Twilio السحابية التجارية للـ SMS.
متى لا تستخدمه
تجنب استخدام Signal CLI REST API إذا كنت تريد إرسال رسائل تسويقية جماعية لآلاف الأرقام المجهولة (حيث صُممت شبكة Signal للمحادثات المشفرة الآمنة وتقوم بحظر حسابات السبام فوراً). وإذا كنت تريد فقط وسيلة بسيطة لإرسال تنبيهات من اتجاه واحد لهواتف أندرويد وآيفون دون تسجيل حسابات، فإن Gotify أو ntfy أخف وأسهل.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
هل أحتاج إلى رقم هاتف مستقل ومخصص لـ Signal REST API؟
لا! يمكنك استخدام ميزة ربط الأجهزة عبر رمز الـ QR (`/v1/qrcodelink`) لربط سيرفرك كجهاز مرافق ثانوي بحساب سيجنال الحالي على هاتفك، تماماً كما تفعل عند ربط برنامج Signal Desktop.
هل يمكن لـ Signal REST API إرسال الصور ومرفقات الـ PDF؟
نعم! تدعم نقطة النهاية `/v2/send` إرفاق ملفات الصور والمستندات والتسجيلات الصوتية ومقاطع الفيديو بتمرير مسار الملف أو بياناته المشفرة بـ Base64.
هل استخدام Signal REST API مجاني؟
نعم! شبكة Signal مجانية بالكامل ولا تفرض أي رسوم على الرسائل أو الاشتراكات، مما يجعلها بديلاً مجانياً وقوياً لبوابات الـ SMS التجارية.
هل يمكن استقبال رسائل سيجنال الواردة وبناء بوتات تفاعلية؟
نعم! تدعم Signal CLI REST API تقنيات WebSockets والـ Webhooks لاستقبال الرسائل الواردة لحظياً وتمكين البرامج وبايثون من الرد التلقائي عليها.
كم تستهلك Signal REST API من الذاكرة العشوائية (RAM)؟
تستهلك الحاوية عادة ما بين 150 إلى 300 ميجابايت فقط من الذاكرة العشوائية داخل Docker.