🧑‍💻 تثبيت Opengist — منصة حفظ ومشاركة مقتطفات الأكواد المدعومة بـ Git على Docker

نشر منصة Opengist على Ubuntu باستخدام Docker — البديل مفتوح المصدر لمنصة GitHub Gist لحفظ ومشاركة مقتطفات الأكواد البرمجية والملفات مع تتبع الإصدارات الكامل بـ Git وتلوين الأكواد.

⚠️ راجع أي سكريبت دائمًا قبل تشغيله على سيرفرك، واختبره في بيئة تجريبية أولاً.

📦 الملفات والأكواد المطلوبة

قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.

سكريبت تثبيت مؤتمت — أمر واحد ينشر Opengist على المنفذ 6157 (الويب وGit HTTP) ومنفذ 2224 (Git SSH) مع حفظ دائم للمستودعات.
عرض على GitHub

التثبيت السريع:

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/dev/opengist/opengist-ubuntu.sh
chmod +x opengist-ubuntu.sh
sudo bash opengist-ubuntu.sh

خطوات التنفيذ

1 تحميل السكريبت

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/dev/opengist/opengist-ubuntu.sh

2 منح صلاحية التنفيذ

chmod +x opengist-ubuntu.sh

3 تشغيل المثبت

يقوم السكريبت بتثبيت Docker وتجهيز مجلدات التخزين لمستودعات Git وتشغيل حاوية Opengist على المنفذ 6157 (واجهة الويب وHTTP Git) والمنفذ 2224 (SSH Git).

sudo bash opengist-ubuntu.sh

4 إتمام الإعداد عبر الويب

افتح متصفحك وانتقل إلى الرابط http://ip-سيرفرك:6157 لإنشاء حساب المشرف والبدء في إنشاء ومشاركة أول مقتطف برمجي لك.

http://<your-server-ip>:6157

المنافذ المستخدمة

المنفذالغرض
6157Web UI + Git over HTTP
2224Git over SSH (host → container 2222)

نظرة عامة

تعد Opengist منصة مفتوحة المصدر لمشاركة وحفظ مقتطفات الأكواد البرمجية (Pastebin) مبنية بلغة Go وSvelte، ومصممة كبديل متكامل لمنصة GitHub Gist الشهيرة. الميزة الأساسية في Opengist هي أن كل مقتطف يتم إنشاؤه هو عبارة عن مستودع Git حقيقي ومستقل في الخلفية. تعمل المنصة على المنفذ 6157 (الويب) ومنفذ 2224 (Git عبر SSH)، وتدعم المقتطفات متعددة الملفات، وتتبع سجل التعديلات الكامل (Commit Diffs)، وعرض ملفات Markdown، وتلوين صياغة مئات اللغات البرمجية، وإمكانية سحب ودفع التعديلات عبر سطر أوامر Git مباشرة.

لماذا تستخدمه

لصق الأكواد البرمجية الحساسة أو إعدادات السيرفرات في خدمات Pastebin العامة يعرض أسرار المشاريع لخطر التسريب ومسجلات الإنترنت العامة. تمنحك الاستضافة الذاتية لـ Opengist خزنة أكواد خاصة ومستقلة؛ حيث يمكنك إنشاء مقتطفات عامة، أو غير مدرجة (برابط سري)، أو خاصة تماماً، مع القدرة على استنساخها مباشرة إلى طرفية حاسوبك بأوامر `git clone` المعتادة.

متى تحتاجه

  • ترغب في بديل مستضاف ذاتياً لـ GitHub Gist لتنظيم وحفظ ومشاركة مقتطفات الأكواد وقوالب الإعدادات
  • يحتاج فريق التطوير لديك لمشاركة السكريبتات واستعلامات SQL والملفات داخلياً بأمان وخصوصية تامة
  • تحتاج إلى دعم المقتطفات متعددة الملفات مع تتبع الإصدارات والفروقات عبر مستودع Git حقيقي
  • تريد إمكانية تعديل واستنساخ المقتطفات مباشرة من سطر الأوامر (Terminal) عبر HTTP أو SSH
  • تبحث عن بيئة سريعة ونظيفة وخالية من الإعلانات مع دعم تنسيق Markdown وتلوين الأكواد

من يحتاجه

  • مطور البرمجيات لتنظيم مكتبات الأكواد المتكررة وتعبيرات Regex والقوالب الجاهزة
  • مهندسو DevOps لمشاركة سكريبتات Shell وإعدادات Ansible وملفات Terraform داخل الفريق
  • المدونون والتقنيون لمشاركة نماذج الأكواد والشروحات البرمجية وملاحظات Markdown
  • مديرو الأنظمة لحفظ قوالب تكوين السيرفرات (Nginx blocks وDockerfiles وخدمات systemd)
  • أصحاب السيرفرات المنزلية لبناء مكتبة مركزية وسريعة للأوامر البرمجية وشروحات الأتمتة

حالات الاستخدام الشائعة

  • حفظ ومشاركة المقتطفات متعددة الملفات (مثل مكون React مع ملفات الـ CSS واختبارات الوحدة في مقتطف واحد)
  • حفظ إعدادات السيرفرات واستنساخها مباشرة داخل السيرفرات البعيدة عبر أمر `git clone`
  • نشر ملاحظات وشروحات Markdown بروابط غير مدرجة مع تنسيق الجداول والأكواد
  • متابعة تاريخ تعديل ملفات الإعداد بمقارنة الفروقات سطراً بسطر عبر واجهة Git المرئية
  • توفير روابط تنزيل مباشرة للملفات الخام (Raw) لاستخدامها في تهيئة السيرفرات بالأمر `curl .../raw | bash`

الميزات الرئيسية

  • نواة Git حقيقية: كل مقتطف هو مستودع Git مستقل بالكامل مع سجل تعديلات وفروقات بصرية
  • مقتطفات متعددة الملفات: تجميع عدة ملفات وسكريبتات ومستندات مرتبطة في مقتطف واحد
  • ثلاثة مستويات للخصوصية: عام (Public)، غير مدرج (Unlisted برابط سري)، وخاص (Private للمالك فقط)
  • تلوين صياغة لأكثر من 200 لغة برمجة مع أرقام الأسطر وأزرار النسخ السريع
  • عرض كامل لمستندات Markdown مع الجداول وقوائم المهام والأكواد المنسقة
  • دعم كامل لـ Git عبر HTTP (منفذ 6157) وGit عبر SSH (منفذ 2224) للتعامل عبر الطرفية
  • واجهة مستخدم عصرية فائقة السرعة تدعم الوضع الليلي مبنية بـ Svelte وGo تستهلك أقل قدر من الموارد
  • نشر في حاوية موحدة مع ربط مجلد ./data لحفظ الإعدادات ومستودعات الأكواد بشكل دائم

كيفية الاستخدام بعد التثبيت

  • افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:6157 لعرض الصفحة الرئيسية لـ Opengist
  • سجل حسابك بالنقر على 'Sign Up' — يحصل أول مستخدم مسجل تلقائياً على صلاحيات المشرف العام
  • انتقل إلى ملفك الشخصي ← SSH Keys لرفع مفتاح SSH العام للتوثيق مع Git عبر الطرفية
  • انقر على 'New Gist' لإنشاء أول مقتطف برمجي متعدد الملفات، واختر مستوى الخصوصية، ثم اضغط حفظ
  • جرب استنساخ المقتطف لجهازك عبر سطر الأوامر: `git clone http://ip-سيرفرك:6157/username/gist-id.git`
  • ضع Opengist خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx أو Caddy) مع شهادة SSL صالحة
  • يمكنك اختيارياً تعطيل التسجيل العام من إعدادات الإدارة لقصر الاستخدام على أعضاء فريقك فقط

أفضل ممارسات الأمان

  • يحصل أول حساب مسجل على صلاحيات المشرف؛ أكمل إنشاء حسابك فور تشغيل الحاوية لمنع غيرك من أخذ الصلاحية
  • عطل التسجيل المفتوح للعامة من إعدادات المشرف إذا كنت تريد قصر المنصة على فريقك فقط لمنع السبام
  • استخدم تشفير HTTPS دائماً عبر وكيل عكسي لحماية الأكواد وبيانات تسجيل الدخول أثناء النقل
  • تأكد من تعيين المقتطفات الحساسة كـ 'Private' لمنع ظهورها في نتائج البحث العامة
  • احمِ مجلد البيانات ./data بصلاحيات مناسبة على السيرفر
  • حدّث حاوية ghcr.io/thomiceli/opengist دورياً للحصول على أحدث التحديثات الأمنية والميزات

المنافذ وإعدادات جدار الحماية

يستمع Opengist لواجهة الويب وGit عبر HTTP على منفذ TCP 6157، ويستقبل اتصالات Git عبر SSH على منفذ TCP 2224 (المحول من 2222 الداخلي). في الإنتاج، قم بتهيئة وكيل عكسي مشفر بـ SSL على المنفذ 443 ووجهه لمنفذ 6157. وافتح المنفذ 2224 في جدار الحماية (ufw allow 2224/tcp) إذا كنت ترغب في تمكين المطورين من سحب ورفع المقتطفات عبر SSH.

النسخ الاحتياطي والصيانة

  • انسخ مجلد ./data (/opengist) احتياطياً، والذي يحتوي على قاعدة بيانات SQLite وحسابات المستخدمين وكافة مستودعات Git
  • أتمت النسخ الاحتياطي اليومي لمجلد البيانات وارفعه إلى مساحة تخزين سحابية آمنة عبر restic أو rsync
  • احتفظ بنسخة من ملفات إعداد الوكيل العكسي وشهادات SSL
  • اختبر الاستعادة بربط مجلد البيانات بحاوية تجريبية للتأكد من ظهور كافة المقتطفات والمستخدمين بنجاح

الأخطاء الشائعة

  • ترك التسجيل العام مفتوحاً للإنترنت، مما يتيح للبوتات إنشاء مقتطفات سبام واستهلاك السيرفر
  • نسيان فتح المنفذ 2224 لبروتوكول Git SSH في جدار الحماية، مما يؤدي لفشل أوامر الاستنساخ عبر SSH
  • استخدام HTTP غير المشفر عند نقل أسرار وكود الإنتاج الحساس في شبكات عامة
  • عدم ربط مجلد التخزين الدائم ./data، مما يسبب فقدان كافة المقتطفات والحسابات عند تحديث الحاوية
  • تحديد المقتطفات الحساسة كـ 'Public' بدلاً من 'Private' أو 'Unlisted'

استكشاف الأخطاء وإصلاحها

  • فشل استنساخ Git عبر SSH — تأكد من فتح منفذ 2224 في جدار الحماية وإضافة مفتاح SSH في الملف الشخصي
  • رابط الملف الخام (Raw) يرجع خطأ 404 — راجع إعدادات خصوصية المقتطف وتأكد من وجود الملف المطلوب داخل المقتطف
  • واجهة الويب لا تفتح على 6157 — افحص سجلات الحاوية بالأمر: docker logs opengist -f
  • فشل الدفع عبر Git CLI — تأكد من صحة رابط المستودع: `git remote set-url origin http://ip-سيرفرك:6157/user/gist.git`
  • نسيان كلمة مرور المشرف — افتح قاعدة البيانات SQLite في ./data/opengist.db أو استخدم أمر إعادة التعيين داخل الحاوية

البدائل

منصة PrivateBin هي منصة لصق نصوص مشفرة تماماً من طرف لطرف بدون علم السيرفر بالمحتوى. منصات Pastebin وGitHub Gist بدائل سحابية تجارية. خوادم Gitea وForgejo تدعم حفظ مقتطفات الأكواد بجانب المستودعات الكاملة. منصة Wastebin خيار فائق السرعة بلغة Rust.

متى لا تستخدمه

تجنب استخدام Opengist إذا كنت تبحث فقط عن منصة لمشاركة كلمات المرور والنصوص الحساسة لمرة واحدة ذاتية التدمير ومشفرة بالكامل في المتصفح (منصة PrivateBin أنسب بكثير لهذه الحالات). وإذا كنت تحتاج لنظام تطوير برمجيات كامل يحتوي على طلبات سحب وخطوط بناء CI/CD، فاستخدم Gitea أو OneDev بدلاً منه.

هل تحتاج مساعدة احترافية؟

توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.

  • التثبيت وتجهيز السيرفر
  • الإعداد المتقدم وإعداد التوجيه
  • تصليب الأمان وتحسين جدار الحماية
  • إعداد شهادات SSL/TLS مع Let's Encrypt
  • ربط النطاق المخصص والوكيل العكسي
  • جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
  • المراقبة الفورية وتنبيهات الجاهزية
  • الترحيل من المنصات القائمة
  • استكشاف مشكلات الاتصال والأداء وإصلاحها
  • سكريبتات أتمتة مخصصة وعقود دعم مستمر
تواصل مع PrismaTechWork

الأسئلة الشائعة

ما الذي يميز Opengist عن مواقع الـ Pastebin العادية؟

في Opengist، كل مقتطف كود هو عبارة عن مستودع Git حقيقي بالكامل. هذا يمنحك سجلاً كاملاً للتعديلات، ودعم تعدد الملفات في المقتطف الواحد، والقدرة على استنساخ ودفع التعديلات عبر سطر أوامر Git.

هل يمكن استخدام أوامر Git في الطرفية مع Opengist؟

نعم، يمكنك استنساخ أي مقتطف باستخدام أوامر Git القياسية عبر HTTP (`git clone http://ip-سيرفرك:6157/user/gist-id.git`) أو عبر SSH (`git clone ssh://git@ip-سيرفرك:2224/user/gist-id.git`) وتعديل الملفات ورفعها مجدداً.

ما هي مستويات الخصوصية المتاحة للمقتطفات؟

يدعم Opengist ثلاثة مستويات: 'عام' (Public يظهر للجميع وفي البحث)، و'غير مدرج' (Unlisted مخفي من البحث ومتاح فقط لمن يمتلك الرابط السري)، و'خاص' (Private متاح لمالك الحساب فقط).

هل يمكن تضمين مقتطفات Opengist داخل مواقع ومقالات أخرى؟

نعم، يوفر Opengist كود تضمين جاهز بـ JavaScript وIframe لتضمين الأكواد الملونة والأنيقة بسلاسة داخل مدونتك أو مواقع التوثيق الخاصة بك.

كم يستهلك Opengist من الذاكرة العشوائية؟

تمت برمجة Opengist بلغة Go وهو خفيف للغاية، حيث يستهلك عادة ما بين 20 إلى 50 ميجابايت فقط من الذاكرة العشوائية أثناء التشغيل العادي.