تظاهر بأنك خادم Xyzzy على Raspberry Pi: 19 خطوة

2024 مؤلف: John Day | [email protected]. آخر تعديل: 2024-01-30 07:38

سيوضح لك هذا الدليل كيفية إعداد خادم Pretend You're Xyzzy (PYX) على Raspberry Pi. أسميها XyzzyPi

Pretend You Xyzzy عبارة عن نسخة مفتوحة المصدر من Cards Against Humanity عبر الإنترنت يتم لعبها في مستعرض ويب.

على نظام Android ، يمكنك أيضًا استخدام تطبيق Client for Pretend You Xyzzy.

عندما بدأت في البحث في إعداد خادم PYX الخاص بي ، واجهت صعوبة في العثور على تعليمات لم تكن قديمة وكان من السهل اتباعها. يبدو أن معظمها مكتوب للأشخاص الذين لديهم بالفعل بعض الخبرة في إعداد خادم PYX. تمكنت من اكتشاف الأشياء ولكني أردت إنشاء دليل تفصيلي خطوة بخطوة لأولئك الذين هم أقل خبرة في التكنولوجيا أو الذين ليس لديهم خبرة كبيرة في مثل هذه الأشياء. أيضًا ، لم أتمكن من العثور على أي تعليمات حول تشغيله على Raspberry Pi. بعد بعض التجارب والخطأ ، تمكنت من تشغيل خادم PYX على Pi مع بعض التعديلات الطفيفة فقط على الملفات. آمل أن يوفر هذا بعض الوقت لأولئك المهتمين.

لقد فعلت ذلك على طراز Pi 3 B + و Pi 4 موديل B 4GB. هناك بعض المشكلات في استخدام Pi Zero W بسبب عدم تعامل المعالج مع Java VM بشكل صحيح. أحاول حاليًا تشغيله على Zero W وسوف أقوم بتحديث التعليمات إذا نجحت. ليس لدي Pi 1 أو 2 للاختبار عليه ، لذلك قد يعمل أو لا يعمل مع هؤلاء.

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

إذا كنت تعرف بالفعل كيفية تثبيت Raspbian والاتصال بـ Pi ، فانتقل إلى الخطوة 6

إذا كانت لديك خبرة في إعداد خادم PYX وتريد فقط معرفة التعديلات اللازمة لجعله يعمل على Pi ، فانتقل إلى الخطوة 13

إخلاء المسؤولية: لم أقم بإنشاء Pretend You Xyzzy أو تطبيق عميل Android.

يذهب الائتمان لإنشاء Pretend You Xyzzy إلى مستخدم GitHub ajanata (https://github.com/ajanata/PretendYoureXyzzy)

الائتمان لإنشاء عميل لتتظاهر بأنك Xyzzy يذهب إلى Gianlu (https://play.google.com/store/apps/dev؟id=8675761046824387020)

إذا كان هناك أي شخص فاتني ، فيرجى إبلاغي بذلك.

اللوازم

المعدات:

Raspberry Pi 3 أو 4

بطاقة Micro SD (أستخدم بطاقات micro SD بسعة 32 غيغابايت لأن هذا هو ما أملكه. ربما يمكنك الحصول عليه بأقل من 2 غيغابايت ولكنني أوصي بـ 4 غيغابايت على الأقل.)

جهاز كمبيوتر مزود بقارئ بطاقة SD (أنا أستخدم Windows لهذا البرنامج التعليمي. إذا كنت تقوم بتشغيل Linux ، فمن المحتمل أن تكون على دراية بالكثير من هذه الأشياء ، لذا اضبط التعليمات حسب الحاجة.)

برمجة:

صورة Raspbian: https://www.raspberrypi.org/downloads/raspbian/ (أي يجب أن يعمل. أنا أستخدم Raspbian Buster Lite وقت كتابة هذا التقرير.)

Win32 Disk Imager: https://sourceforge.net/projects/win32diskimager/ (هناك برامج أخرى يمكنك استخدامها لفلاش صورة Raspbian ولكن هذا هو تفضيلي الشخصي.)

المعجون:

الخطوة 1: فلاش Raspbian على بطاقة SD الخاصة بك

ضع بطاقة SD في قارئ بطاقات الكمبيوتر قبل فتح Win32 Disk Imager. ثم حدد صورة Raspbian الخاصة بك وحرف محرك أقراص بطاقة SD الخاصة بك وانقر فوق "كتابة".

تنبيه: سيتم حذف أي شيء موجود على بطاقة SD والكتابة فوقه. إذا كانت هناك بيانات مهمة على بطاقة SD ، فقم بنسخها احتياطيًا أولاً. تأكد أيضًا من تحديد حرف محرك الأقراص الصحيح لبطاقة SD الخاصة بك. وإلا يمكنك مسح / الكتابة فوق محرك الأقراص الخطأ عن غير قصد

بمجرد الانتهاء سيكون لديك محركان منفصلان على بطاقة SD الخاصة بك. بمجرد استدعاء التمهيد وواحد لا يستطيع Windows قراءته. من المحتمل أن تحصل على نافذة منبثقة في Windows تطلب منك تهيئة البطاقة. فقط انقر فوق إلغاء الأمر. إذا قمت بتهيئته ، فسيتعين عليك وميض Raspbian مرة أخرى.

الخطوة 2: قم بإنشاء ملف نصي باسم "wpa_supplicant.conf" على محرك أقراص التمهيد

على محرك التمهيد الخاص ببطاقة SD ، أنشئ ملفًا نصيًا باسم wpa_supplicant.conf والصق الكود أدناه بالداخل. استبدل "اسم wifi" و "كلمة المرور" باسم wifi الفعلي وكلمة المرور ولكن احتفظ بالاقتباسات من حولهما. حفظ الملف.

سيسمح هذا لـ Pi بالاتصال بشبكة wifi الخاصة بك. إذا كنت تستخدم كبل إيثرنت لتوصيل Pi بشبكتك ، يمكنك على الأرجح تخطي هذه الخطوة.

تأكد من صحة امتداد الملف. يجب أن يكون الملف wpa_supplicant.conf وليس wpa_supplicant.conf.txt

country = usupdate_config = 1 ctrl_interface = / var / run / wpa_supplicant

الشبكة = {

scan_ssid = 1 ssid = "اسم wifi" psk = "كلمة المرور"}

الخطوة 3: إنشاء ملف فارغ باسم "ssh" على محرك أقراص التمهيد

على محرك التمهيد الخاص ببطاقة SD ، قم بإنشاء ملف فارغ باسم ssh

لا يحتاج إلى أي شيء بداخله ، بل يحتاج فقط إلى تسميته بشكل صحيح.

سيؤدي ذلك إلى تمكين ssh على Pi الخاص بك والذي سيسمح لك بالاتصال به باستخدام Putty.

تأكد من تسمية الملف ببساطة باسم ssh بدون امتداد. ليس ssh.txt وما إلى ذلك

الخطوة 4: أخرج بطاقة SD من جهاز الكمبيوتر الخاص بك ، وضعها في Pi الخاص بك ، وقم بتشغيل Pi الخاص بك

أخرج بطاقة SD من جهاز الكمبيوتر الخاص بك ، وضعها في Pi الخاص بك ، وقم بتشغيل Pi الخاص بك.

إذا نجح كل شيء ، فسيتم تشغيل Pi الخاص بك والاتصال بشبكة wifi الخاصة بك.

امنحه بضع دقائق للتشغيل خلال الإعداد الأولي.

الخطوة 5: قم بالاتصال بـ Pi الخاص بك باستخدام المعجون

افتح المعجون وفي مربع اسم المضيف اكتب raspberrypi مع التأكد من أن نوع الاتصال هو SSH والمنفذ هو 22. إذا كان متصلاً ، فسيتم نقلك إلى شاشة سوداء بها نص يُعرف باسم Terminal. سيطلب اسم المستخدم وكلمة المرور الخاصين بك. اسم المستخدم الافتراضي هو "pi" وكلمة المرور الافتراضية "raspberry". يوصى بشدة بتغيير كلمة المرور خاصة إذا كنت تخطط لعرض Pi على الإنترنت. للقيام بذلك ، اكتب "passwd" بمجرد تسجيل الدخول واتبع التعليمات. تأكد من اختيار كلمة مرور ستتذكرها.

إذا لم يتم الاتصال ، فقد تحتاج إلى العثور على عنوان IP الذي يستخدمه Pi الخاص بك. هناك عدة طرق للقيام بذلك ، لكنني شخصياً أقوم بتسجيل الدخول إلى جهاز التوجيه الخاص بي والتحقق من قائمة الأجهزة المتصلة. بمجرد العثور على IP الخاص بك ، اكتب ذلك في مربع اسم المضيف في المعجون بدلاً من raspberrypi وحاول الاتصال مرة أخرى.

إذا كنت لا تزال غير قادر على الاتصال ، فربما لم تقم بإنشاء ملف ssh بشكل صحيح. اقرأ الخطوات السابقة وتحقق مرتين من كل شيء.

الخطوة 6: اختياري: قم بتغيير اسم المضيف الخاص بـ Pi الخاص بك

هذا ليس ضروريًا ولكني أفضل الحصول على اسم مضيف Pi الخاص بي كشيء ذي صلة بما يتم استخدامه بدلاً من مجرد "raspberrypi" العام. في هذه الحالة أطلقت عليها اسم "xyzzypi" ولكن يمكنك تسميتها كما تريد.

لتغيير نوع اسم المضيف:

sudo raspi-config

حدد خيارات الشبكة

حدد اسم المضيف

أدخل أي اسم مضيف تريده

حدد إنهاء

سيسألك عما إذا كنت ترغب في إعادة تشغيل Pi الآن. لن يدخل اسم المضيف الجديد حيز التنفيذ حتى تقوم بإعادة التشغيل. إذا قمت بذلك ، سيتم قطع اتصال جلسة المعجون الخاصة بك. بمجرد الانتهاء من إعادة التشغيل ، ستحتاج إلى استخدام اسم المضيف الجديد الذي قمت بتعيينه لإعادة الاتصال بـ Putty. إذا كنت تتصل باستخدام عنوان IP بدلاً من اسم المضيف ، فيجب أن يظل هو نفسه.

هناك الكثير من الخيارات الأخرى التي يمكنك تعيينها باستخدام أداة تكوين raspi ولكن هناك الكثير من البرامج التعليمية حول ذلك عبر الإنترنت بالفعل ، لذا لن أخوضها هنا.

الخطوة 7: قم بتحديث حزم التطبيق الخاصة بك

قم بتحديث حزم التطبيق الخاصة بك باستخدام الأمر التالي:

sudo apt-get update

دعها تعمل حتى تنتهي.

ملاحظة: من الناحية الفنية ، ليس عليك كتابة "apt-get" بعد الآن ، يمكنك فقط كتابة "apt". ومع ذلك ، أنا معتاد على كتابة "apt-get" بحيث إنها مجرد ذاكرة عضلية بالنسبة لي في هذه المرحلة.

الخطوة 8: قم بتثبيت Git

بمجرد الانتهاء من تحديث حزم التطبيق ، قم بتثبيت Git باستخدام الأمر التالي:

sudo apt-get -y install git

دعها تعمل حتى تنتهي.

الخطوة 9: تثبيت Maven

قم بتثبيت Maven باستخدام الأمر التالي:

sudo apt-get -y install maven

دعها تعمل حتى تنتهي

الخطوة 10: قم بتنزيل Pretend you're Xyzzy Server Files

قم بتنزيل ملفات خادم Pretend You Xyzzy باستخدام الأمر التالي:

بوابة استنساخ git: //github.com/ajanata/PretendYoureXyzzy.git

سيؤدي هذا إلى إنشاء دليل على Pi يسمى PretendYoureXyzzy وتنزيل الملفات فيه.

دعها تعمل حتى تنتهي.

الخطوة 11: قم بالتغيير إلى دليل PretendYoureXyzzy

غيّر إلى دليل PretendYoureXyzzy باستخدام الأمر التالي:

قرص مضغوط PretendYoureXyzzy

ملاحظة: أوامر Linux حساسة لحالة الأحرف ، لذا فإن cd PretendYoureXyzzy ستعمل ولكن cd pretendyourexyzzy لن تعمل.

الخطوة 12: فتح وتحرير ملف "build.properties.example" وحفظه باسم "build.properties"

افتح ملف build.properties.example باستخدام محرر نصوص نانوي باستخدام الأمر التالي:

sudo nano build.properties.example

قد يبدو استخدام محرر نصوص قائم على المحطة أمرًا مخيفًا بعض الشيء لأولئك الذين لم يعتادوا عليه ولكن ما نقوم به بسيط للغاية.

استخدم مفتاح السهم لأسفل للتمرير لأسفل حتى تجد الأقسام التي تقول "hibernate.username" و "hibernate.password".

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

بمجرد تغييرها ، اضغط على ctrl + o لإظهار مربع حوار الحفظ.

Backspace لإزالة ".example" من نهاية اسم الملف حتى يتبقى لك "build.properties" فقط

سيسألك عما إذا كنت تريد حفظ الملف باسم مختلف. اضغط على نعم.

اضغط على ctrl + x لإغلاق محرر نصوص nano.

الخطوة 13: فتح وتحرير ملف "pom.xml" (هذا ما يجعله يعمل على PI)

افتح ملف pom.xml باستخدام محرر نصوص nano باستخدام الأمر التالي:

sudo nano pom.xml

قم بالتمرير لأسفل كما فعلت من قبل. هذه المرة الخط الذي تبحث عنه هو sqlite-jdbc

أسفل هذا السطر مباشرة يوجد سطر برقم الإصدار. تحتاج إلى تغيير هذا الرقم إلى 3.28.0 بحيث يبدو كما يلي:

3.28.0

بمجرد تحرير رقم الإصدار ، اضغط على ctrl + o لإظهار مربع حوار الحفظ.

احتفظ باسم الملف كـ "pom.xml" واحفظه.

بمجرد حفظه ، اضغط على ctrl + x لإغلاق محرر نصوص nano.

هذا هو التعديل الذي يجعل خادم Pretend You Xyzzy يعمل على Pi. إصدار sqlite-jdbc الذي يأتي معه لن يعمل بشكل صحيح على Pi. الإصدار 3.28.0 يعمل بشكل رائع في اختباراتي حتى الآن

الخطوة 14: ابدأ تشغيل خادم Pretend you're Xyzzy وتأكد من أنه يعمل

الآن بعد أن أجريت التعديلات اللازمة لتشغيل خادم Pretend You Xyzzy على Pi الخاص بك ، فلنبدأ تشغيله ونرى ما إذا كان كل شيء يعمل. ابدأ الخادم باستخدام الأمر التالي:

Mvn Clean Package war: exploded jetty: run -Dmaven.buildNumber.doCheck = false -Dmaven.buildNumber.doUpdate = false

سيقوم بتنزيل بعض الملفات الإضافية وتجميعها وبدء الخادم. سيستغرق هذا على الأرجح دقيقتين.

ملاحظة: هذه هي الطريقة الوحيدة حاليًا التي أعرف بها كيفية تشغيل الخادم بحيث يتم تجميعه في كل مرة تبدأ فيها.

ستعرف أن الأمر قد تم عندما تتلقى رسالة تقول "تم تمكين إعادة تحميل وحدة التحكم. اضغط على ENTER في وحدة التحكم لإعادة تشغيل السياق."

في هذه المرحلة ، يمكنك فتح المستعرض الخاص بك وكتابة اسم المضيف (أو عنوان IP) الخاص بـ Pi مضيفًا المنفذ 8080 في النهاية. لذلك اسم المضيف: 8080 أو IP: 8080

إذا استخدمت xyzzypi كاسم مضيف ، فسيكون xyzzypi: 8080 أو في حالتي باستخدام IP ، فسيكون 192.168.1.189:8080

إذا نجح كل شيء ، فسيتم نقلك إلى صفحة Pretend You Xyzzy الرئيسية.

تهانينا! لقد فعلتها

ومع ذلك ، سيتم تشغيله الآن فقط إذا قمت بتسجيل الدخول إلى Pi الخاص بك باستخدام Putty وقمت بتشغيل الأمر أعلاه لبدء تشغيل الخادم. بمجرد إغلاق المعجون سيتوقف الخادم. قد يكون هذا جيدًا بالنسبة لبعض الأشخاص ولكنك قد ترغب في تشغيل خادم Pretend You Xyzzy تلقائيًا عندما يتم تشغيل Pi أو إعادة تشغيله دون الحاجة إلى تسجيل الدخول. ستغطي الخطوات التالية جعل هذا العمل.

الخطوة 15: قم بعمل برنامج نصي لبدء التظاهر بأنك خادم Xyzzy

إذا كنا نريد أن يبدأ خادم Pretend You Xyzzy تلقائيًا عندما يقوم Pi بالتمهيد أو إعادة التشغيل ، فإن أول شيء نحتاج إلى القيام به هو إنشاء برنامج نصي.

اضغط على ctrl + c لإيقاف الخادم.

بمجرد أن يتوقف ، اكتب الأمر التالي:

sudo نانو xyzzy.sh

ملاحظة: قمت بتسمية البرنامج النصي الخاص بي xyzzy.sh ولكن يمكنك تسميته كما تريد. فقط تأكد من أنه يحتوي على.sh كملحق الملف.

باستخدام محرر نصوص نانو اكتب أو الصق ما يلي في الملف:

#! / bin / bashcd / home / pi / PretendYoureXyzzy mvn clean package war: exploded jetty: run -Dmaven.buildNumber.doCheck = false -Dmaven.buildNumber.doUpdate = false

اضغط على ctrl + o لإظهار مربع حوار الحفظ

احفظ الملف واضغط على ctrl + x لإغلاق nano

الخطوة 16: اجعل البرنامج النصي الخاص بك قابلاً للتنفيذ

نحتاج إلى جعل البرنامج النصي قابلاً للتنفيذ باستخدام الأمر التالي:

سودو chmod 755 xyzzy.sh

ملاحظة: إذا قمت بتسمية البرنامج النصي الخاص بك بشيء مختلف في الخطوة السابقة ، فاستخدم اسم الملف هذا بدلاً من ذلك.

الخطوة 17: قم بإنشاء إدخال Crontab لتشغيل البرنامج النصي تلقائيًا عند التمهيد

توجد طرق متعددة لتشغيل البرنامج النصي عند التشغيل. أنا أستخدم crontab هنا.

قم بتحرير جداول crontab باستخدام الأمر التالي:

كرونتاب -e

سوف يسأل عن أي محرر تريد استخدامه. اكتب 1 واضغط على Enter لاستخدام nano.

بمجرد فتحه ، قم بالتمرير طوال الطريق إلى الأسفل وأضف السطر التالي:

reboot /home/pi/PretendYoureXyzzy/xyzzy.sh

ملاحظة: مرة أخرى ، إذا استخدمت اسم ملف مختلف للنص البرمجي ، فاكتب ذلك بدلاً من ذلك.

اضغط على ctrl + o لإظهار مربع حوار الحفظ.

احفظ واضغط على ctrl + x لإغلاق nano.

الخطوة 18: أعد تشغيل Pi الخاص بك ومعرفة ما إذا كان يمكنك الاتصال لتتظاهر بأنك Xyzzy

الآن بعد أن تم تعيين خادم Pretend You Xyzzy للتشغيل عند التمهيد ، يمكنك إعادة تشغيل Pi والتأكد من أن كل شيء يعمل.

أعد التشغيل باستخدام الأمر التالي:

sudo إعادة التشغيل

بمجرد بدء تشغيل Pi احتياطيًا ، سيستغرق الأمر بضع دقائق لإعادة تجميع كل شيء للخادم. امنحه الوقت ثم حاول الاتصال في المتصفح مرة أخرى إما باستخدام اسم المضيف أو IP الخاص بـ Pi الذي يضيف المنفذ 8080 في النهاية.

xyzzypi: 8080 أو IPaddress: 8080

إذا نجح كل شيء ، فسيتم نقلك إلى صفحة Pretend You Xyzzy.

تهانينا! لديك الآن خادم Pretend You Xyzzy الذي يعمل تلقائيًا على Raspberry Pi

الخطوة 19: اختياري: إعادة توجيه المنافذ للسماح بالوصول إلى التظاهر بأنك خادم Xyzzy عبر الإنترنت

الآن لديك خادم Pretend You Xyzzy عامل ولكن في الوقت الحالي لا يمكن الوصول إليه إلا على شبكتك المحلية. يعمل هذا بشكل جيد إذا كان لديك مجموعة من الأصدقاء للعب في منزلك ولكن الأشخاص خارج شبكتك المحلية لن يتمكنوا من الاتصال.

ستحتاج إلى البحث عن تعليمات إعادة توجيه المنفذ لجهاز التوجيه الخاص بك إذا كنت لا تعرف بالفعل كيف. Pretend you're Xyzzy يستخدم المنفذ 8080 لذلك هذا هو المنفذ الذي تريد إعادة توجيهه. بمجرد الانتهاء من إعداده ، ستتمكن من إعطاء أصدقائك عنوان IP الخارجي والمنفذ الخاص بك وسيتمكنون من الاتصال بخادمك عبر الإنترنت.

إذا أردت ، يمكنك أيضًا إعداد Dynamic DNS بحيث يكون لديك عنوان URL الخاص بك (شيء مثل JoesPYXserver.noip.com) لتقدمه للأصدقاء للاتصال بخادمك. هناك الكثير من البرامج التعليمية المتوفرة بالفعل لهذا النوع من الأشياء.