🔑 تثبيت Pocket ID — خادم المصادقة الموحدة (SSO) بمفاتيح المرور البيومترية (Passkeys) على Docker
نشر خادم Pocket ID على Ubuntu باستخدام Docker — مزود الهوية المفتوح المصدر خفيف الوزن المعتمد على مفاتيح المرور البيومترية (Passkeys) وبروتوكول OpenID Connect لتسجيل الدخول الموحد بدون كلمات مرور عبر بصمة الإصبع والوجه.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/security/pocket-id/pocket-id-ubuntu.sh
chmod +x pocket-id-ubuntu.sh
sudo bash pocket-id-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/security/pocket-id/pocket-id-ubuntu.sh
2 منح صلاحية التنفيذ
chmod +x pocket-id-ubuntu.sh
3 تشغيل المثبت
يقوم السكريبت بتثبيت Docker وتجهيز مجلد التخزين الدائم (`./data`) وتشغيل حاوية Pocket ID الرسمية على المنفذ 8170 (المحول من 1411 الداخلي).
sudo bash pocket-id-ubuntu.sh
4 تسجيل مفتاح المرور وربط التطبيقات
افتح متصفحك وانتقل إلى الرابط http://ip-سيرفرك:8170. أنشئ حساب المشرف وسجل مفتاح المرور البيومتري (Passkey)، وابدأ في إضافة تطبيقاتك عبر بروتوكول OIDC.
http://<your-server-ip>:8170/setup
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 8170 | Web UI + OIDC endpoints (host → container 1411) |
| APP_URL | Must match the URL users visit — passkeys are origin-bound |
| TRUST_PROXY | false by default; set true only behind a real reverse proxy |
نظرة عامة
يعد Pocket ID خادم مصادقة ومزود هوية (OIDC Provider) حديث وخفيف جداً مفتوح المصدر مبني بلغة Go، ويعتمد كلياً على مفاتيح المرور البيومترية (Passkeys). يعمل الخادم على المنفذ 8170، ويستبدل كلمات المرور التقليدية بالكامل بمعايير FIDO2 / WebAuthn المشفرة (مثل Touch ID، وFace ID، ومفاتيح الأمان الفيزيائية YubiKey). ويتيح لمديري السيرفرات حماية وتوحيد تسجيل الدخول لكافة التطبيقات المستضافة (مثل Nextcloud وGrafana وPortainer وProxmox) عبر بروتوكول OpenID Connect الموحد بدون إدارة كلمات مرور معقدة.
لماذا تستخدمه
تتسم خوادم الهوية المؤسسية التقليدية (مثل Keycloak أو Authentik) بضخامة استهلاكها للموارد (تتطلب مئات الميجابايت من الرامات وقواعد بيانات PostgreSQL معقدة) وصعوبة إعدادها. يوفر Pocket ID مزود هوية خفيفاً للغاية يعمل في ملف تنفيذي واحد باستهلاك ذاكرة يقل عن 30 ميجابايت، ويقدم أعلى درجات الأمان التشفيري بمقاومة تامة لهجمات التصيد الإلكتروني وسرقة كلمات المرور.
متى تحتاجه
- تريد تسجيل دخول موحد وسريع (SSO) لبصمة الإصبع أو الوجه عبر كافة تطبيقات سيرفرك المنزلي
- تبحث عن خادم هوية OIDC خفيف جداً يستهلك أقل قدر من الذاكرة العشوائية ليعمل بسلاسة على السيرفرات الصغيرة أو أجهزة Raspberry Pi
- تريد التخلص نهائياً من كلمات المرور ومخاطر اختراقها وهجمات التخمين باستخدام تقنيات Passkeys المشفرة
- تحتاج إلى واجهة إدارية بسيطة لإضافة تطبيقات OIDC دون التعقيدات المؤسسية المرهقة
- تدير فريق عمل صغيراً أو شبكة منزلية وتبحث عن تجربة دخول عصرية وآمنة 100%
من يحتاجه
- أصحاب السيرفرات المنزلية لتوحيد تسجيل الدخول للتطبيقات (Portainer وNextcloud وGrafana وPaperless)
- مديرو الأنظمة والمهندسون المهتمون بتطبيق معايير الأمان المتقدمة المعتمدة على مفاتيح الأمان FIDO2
- الشركات الصغيرة والناشئة الباحثة عن مزود هوية خفيف وسريع لأدوات العمل الداخلية
- مطور البرمجيات لاختبار عمليات تسجيل الدخول بـ OIDC وWebAuthn في البيئات التجريبية
- المستخدمون الذين يعانون من حفظ كلمات المرور المتعددة ويرغبون في الدخول ببصمة الهاتف أو الحاسوب
حالات الاستخدام الشائعة
- تسجيل الدخول إلى لوحات Grafana وProxmox وPortainer بنقرة واحدة على بصمة الإصبع أو الوجه عبر OIDC
- تأمين الوصول الإداري للسيرفر باشتراط مفتاح أمان فيزيائي (YubiKey) لكافة الحسابات الإدارية
- حماية أفراد العائلة من هجمات التصيد الإلكتروني عبر إلغاء كلمات المرور الضعيفة في خوادم المنزل
- إدارة بيانات اعتماد تطبيقات OIDC (معرف العميل والسر وروابط إعادة التوجيه) من واجهة واحدة
- نشر خادم مصادقة موثوق وسريع على خوادم الحافة (Edge Servers) بموارد محدودة
الميزات الرئيسية
- مصادقة تعتمد حصرياً على مفاتيح المرور (Passkeys): دعم كامل لمعايير FIDO2 / WebAuthn (البصمات ومفاتيح YubiKey)
- مزود هوية متوافق مع معايير OpenID Connect (OIDC) لاكتشاف ومصادقة التطبيقات تلقائياً
- معمارية فائقة الخفة مبنية بـ Go مع قاعدة بيانات SQLite مدمجة باستهلاك ذاكرة يقل عن 30 ميجابايت
- لوحة تحكم ويب نظيفة وبسيطة لإدارة المستخدمين ومفاتيح المرور المسجلة وتطبيقات OIDC
- تخصيص الهوية البصرية: تعديل اسم الموقع والشعار والألوان لتطابق هوية مؤسستك
- سجل تدقيق أمني مدمج لتتبع محاولات الدخول ومفاتيح المرور المسجلة ورموز المصادقة الصادرة
- تهيئة مرنة عبر متغيرات البيئة (`APP_URL` و`TRUST_PROXY`) للتكامل مع الوكلاء العكسيين
- نشر منظم في حاوية موحدة عبر Docker مع ربط مجلد `./data` لحفظ البيانات ومفاتيح التشفير بشكل دائم
كيفية الاستخدام بعد التثبيت
- افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:8170 لعرض صفحة إعداد Pocket ID
- أنشئ حساب المشرف الأساسي واتبع تعليمات المتصفح لتسجيل أول مفتاح مرور (Passkey) ببصمتك
- تنبيه تقني حاسم: اضبط متغير البيئة `APP_URL` (مثل `https://id.yourdomain.com`) في ملف Compose ليطابق نطاقك الفعلي تماماً
- ضع Pocket ID خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx) مع شهادة SSL (حيث تشترط المتصفحات HTTPS لتشغيل WebAuthn)
- انتقل إلى OIDC Clients ← Add Client لتسجيل تطبيقك الأول (مثل Portainer أو Nextcloud)
- انسخ معرف العميل والسر ورابط الاكتشاف (`https://id.yourdomain.com/.well-known/openid-configuration`) داخل إعدادات تطبيقك
- أضف مفتاح مرور احتياطي إضافي (مثل هاتف آخر أو مفتاح YubiKey) من إعدادات الحساب لتجنب قفل الحساب في حال فقدان جهازك
أفضل ممارسات الأمان
- تنبيه تقني حاسم: استخدم تشفير HTTPS دائماً — حيث تعطل المتصفحات الحديثة تقنية WebAuthn ومفاتيح المرور تماماً في الاتصالات غير المشفرة بـ SSL
- يجب أن يطابق متغير `APP_URL` اسم النطاق الفعلي المستخدم لفتح الموقع في المتصفح تماماً؛ حيث ترتبط مفاتيح المرور تشفيرياً بالنطاق الأصلي
- سجل دائماً مفتاحي مرور على جهازين مختلفين على الأقل (مثل بصمة اللابتوب ومفتاح YubiKey) لتجنب فقدان الوصول للحساب
- لا تكشف المنفذ 8170 للإنترنت العام مباشرة واقصر الاتصال عبر وكيل عكسي مشفر
- احمِ مجلد البيانات `./data` الذي يحتوي على قاعدة بيانات SQLite ومفاتيح التوقيع الرقمية بصلاحيات مناسبة
- حدّث صورة الحاوية دورياً للحصول على الميزات والتحديثات الأمنية المستمرة
المنافذ وإعدادات جدار الحماية
يقدم Pocket ID واجهته ومسارات OIDC عبر منفذ TCP 8170 (المحول من 1411 الداخلي). في الإنتاج، قم بتهيئة وكيل عكسي مشفر بـ SSL على المنفذ 443 ووجهه لمنفذ 8170، مع إبقاء المنفذ 8170 مغلقاً في جدار الحماية الخارجي وفتح المنفذين 80 و443 لاستقبال الزوار.
النسخ الاحتياطي والصيانة
- انسخ مجلد `./data` احتياطياً، والذي يحتوي على ملف قاعدة بيانات `pocket-id.db` بكافة المستخدمين ومفاتيح المرور والتطبيقات المسجلة
- احتفظ بنسخة من مفاتيح التوقيع الرقمية وملف `docker-compose.yml`
- أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية عبر restic أو rsync
- اختبر الاستعادة بربط مجلد البيانات بحاوية تجريبية والتأكد من استرجاع التطبيقات ومفاتيح المرور بنجاح
الأخطاء الشائعة
- التشغيل عبر بروتوكول HTTP غير المشفر: حيث تحظر المتصفحات تسجيل مفاتيح المرور WebAuthn في المواقع غير المشفرة
- تغيير اسم النطاق في `APP_URL` بعد تسجيل مفاتيح المرور (حيث ترتبط المفاتيح تشفيرياً بالنطاق الأصلي وتفشل إذا تغير)
- تسجيل مفتاح مرور واحد فقط على جهاز واحد، مما يعرضك لفقدان الحساب نهائياً في حال تلف الجهاز
- نسيان ضبط متغير `TRUST_PROXY=true` عند التشغيل خلف وكيل عكسي مثل Nginx أو Caddy
- عدم ربط مجلد التخزين الدائم `./data`، مما يسبب مسح المستخدمين والتطبيقات عند تحديث الحاوية
استكشاف الأخطاء وإصلاحها
- فشل تسجيل مفتاح المرور بخطأ 'Origin mismatch' — تأكد من مطابقة `APP_URL` في ملف Compose للرابط المكتوب في شريط المتصفح بدقة
- المتصفح يظهر 'WebAuthn not supported' — تأكد من تشغيل Pocket ID عبر رابط HTTPS مشفر بشهادة SSL صالحة
- تكرار إعادة التوجيه في التطبيقات — تأكد من صحة رابط Redirect URI المسجل في إعدادات العميل
- واجهة الويب لا تفتح على 8170 — افحص سجلات الحاوية بالأمر: `docker logs pocket-id -f`
- قفل حساب المشرف وفقدان الأجهزة — استخدم أوامر سطر الأوامر داخل الحاوية لاستعادة الحساب أو استرجع نسخة احتياطية سابقة
البدائل
منصة Authentik خادم هوية شامل يدعم LDAP وSAML والمصادقة المتقدمة. منصة Authelia خادم مصادقة خفيف مخصص للوكلاء العكسيين. منصة Keycloak نظام إدارة الهويات المؤسسي الشهير من Red Hat. منصة Zitadel نظام حديث للهوية السحابية.
متى لا تستخدمه
تجنب استخدام Pocket ID إذا كانت تطبيقاتك القديمة تتطلب بروتوكول LDAP أو RADIUS بدلاً من بروتوكول OpenID Connect (OIDC) الحديث (استخدم Authentik أو Keycloak بدلاً منه). وإذا كنت مضطراً للسماح بكلمات المرور النصية القديمة لمستخدمين لا يملكون أجهزة تدعم البصمة أو مفاتيح الأمان، فإن Authentik أو Authelia يوفران خيارات هجينة تجمع كلمات المرور مع المصادقة الثنائية.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ما هو Pocket ID وكيف يعمل تسجيل الدخول بدون كلمات مرور؟
يعد Pocket ID مزود هوية OIDC يستبدل كلمات المرور التقليدية بمفاتيح المرور المشفرة FIDO2 / WebAuthn. ويسجل المستخدم دخوله عبر بصمة الإصبع أو الوجه في جهازه (Touch ID وFace ID) أو مفاتيح الأمان الفيزيائية (YubiKey).
لماذا يشترط Pocket ID وجود تشفير HTTPS؟
تفرض معايير أمان المتصفحات العالمية تشغيل واجهات WebAuthn البرمجية داخل بيئات اتصال مشفرة بـ SSL (HTTPS) فقط، وتفشل عمليات تسجيل مفاتيح المرور تماماً عبر اتصالات HTTP غير المشفرة.
هل يمكن استخدام Pocket ID لتسجيل الدخول في Nextcloud وGrafana وPortainer؟
نعم! أي تطبيق يدعم بروتوكول المصادقة الموحدة OpenID Connect (OIDC) يمكنه استخدام Pocket ID كبوابة تسجيل الدخول الموحدة له.
ماذا يحدث إذا فقدت جهازي المسجل عليه مفتاح المرور؟
احرص دائماً على تسجيل مفاتيح مرور متعددة (مثل حاسوبك وهاتفك ومفتاح أمان احتياطي). وإذا فقدت جهازاً، يمكنك الدخول من جهازك البديل وإلغاء المفتاح المفقود.
كم يستهلك Pocket ID من الذاكرة العشوائية؟
Pocket ID خفيف جداً ومبني بلغة Go ويعتمد على SQLite، ويستهلك ما بين 15 إلى 30 ميجابايت فقط من الذاكرة العشوائية داخل Docker.