העמיד פנים שאתה שרת Xyzzy ב- Raspberry Pi: 19 שלבים

2024 מְחַבֵּר: John Day | [email protected]. שונה לאחרונה: 2024-01-30 09:14

מדריך זה יראה לך כיצד להתקין שרת העמיד פנים שאתה Xyzzy (PYX) ב- Raspberry Pi. אני קורא לזה XyzzyPi

העמיד פנים שאתה שיז'י הוא שיבוט מקוון, פתוח בכרטיסי נגד האנושות המשוחזר בדפדפן אינטרנט.

באנדרואיד תוכל גם להשתמש באפליקציית הלקוח להעמיד פנים שאתה Xyzzy.

כשהתחלתי לבדוק את ההקמה של שרת PYX משלי התקשיתי למצוא הוראות שאינן מיושנות ושהן פשוטות לביצוע. נראה שרובם נכתבו לאנשים שכבר היו להם ניסיון בהקמת שרת PYX. הצלחתי להבין את הדברים אבל רציתי ליצור מדריך צעד אחר צעד למי שפחות מתמצא בטכנולוגיה או שאין לו הרבה ניסיון בדברים כאלה. כמו כן, לא הצלחתי למצוא הוראות להריץ אותו ב- Raspberry Pi. לאחר ניסוי וטעייה הצלחתי להפעיל את שרת PYX על פי עם כמה שינויים קלים בקבצים. אני מקווה שזה יחסוך קצת זמן למי שמעוניין.

עשיתי זאת במודל Pi 3 מדגם B+ ובפי 4 דגם B 4GB. יש כמה בעיות בשימוש ב- Pi Zero W בגלל שהמעבד לא מטפל כראוי ב- VM VM. אני כרגע מנסה לגרום לזה לעבוד על אפס W ואעדכן הוראות אם אצליח. אין לי פי 1 או 2 לבדיקה, כך שאולי זה יכול לעבוד עם אלה.

ניסיתי להפוך את ההדרכה לקלה למעקב עבור אנשים בכל רמות המיומנות, כך שיכול להיות שיש כאן דברים שאתה כבר יודע.

אם אתה כבר יודע להתקין Raspbian ולהתחבר ל- Pi שלך דלג לשלב 6

אם יש לך ניסיון בהקמת שרת PYX ורק ברצונך לדעת את העריכות הדרושות כדי לגרום לו לפעול על פי דילוג לשלב 13

כתב ויתור: לא יצרתי להעמיד פנים שאתה שיזי או את אפליקציית הלקוח של Android.

קרדיט ליצירת העמדת פנים שאתה Xyzzy עובר למשתמש ajanata של משתמש GitHub (https://github.com/ajanata/PretendYoureXyzzy)

קרדיט ליצירת לקוח אם תעמיד פנים שאתה זיזי עובר לג'יאנו (https://play.google.com/store/apps/dev?id=8675761046824387020)

אם יש מישהו שפספסתי אנא יידע אותי.

אספקה

חוּמרָה:

פטל פי 3 או 4

כרטיס מיקרו SD (אני משתמש בכרטיסי מיקרו SD של 32 ג'יגה -בתים כי זה מה שיש לי בהישג יד. כנראה שאתה יכול להסתדר עם 2 ג'יגה -בייט אבל אני ממליץ על 4 ג'יגה -בייט לפחות.)

מחשב עם קורא כרטיסי SD (אני משתמש ב- Windows עבור הדרכה זו. אם אתה מפעיל לינוקס אתה כנראה כבר מכיר הרבה דברים אלה, אז שנה את ההוראות לפי הצורך.)

תוֹכנָה:

תמונת 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 לא יכול לקרוא. סביר להניח שתקבל חלונות קופצים המבקשים ממך לעצב את הכרטיס. פשוט לחץ על ביטול. אם אתה מעצב את זה תצטרך להבהב שוב Raspbian.

שלב 2: צור קובץ טקסט בשם "wpa_supplicant.conf" בכונן האתחול

בכונן האתחול של כרטיס ה- SD צור קובץ טקסט בשם wpa_supplicant.conf והדבק את הקוד למטה בפנים. החלף את "שם ה- wifi" ואת "הסיסמה" בשם וסיסמת ה- Wi -Fi שלך בפועל, אך שמור את הציטוטים סביבם. שמור את הקובץ.

זה יאפשר ל- Pi שלך להתחבר ל- wifi שלך. אם אתה משתמש בכבל אתרנט כדי לחבר את ה- Pi לרשת שלך, כנראה שאתה יכול לדלג על שלב זה.

ודא שסיומת הקובץ נכונה. זה צריך להיות wpa_supplicant.conf לא wpa_supplicant.conf.txt

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

רשת = {

scan_ssid = 1 ssid = "שם wifi" psk = "סיסמה"}

שלב 3: צור קובץ ריק בשם "ssh" בכונן האתחול

בכונן האתחול של כרטיס ה- SD צור קובץ ריק בשם ssh

זה לא צריך שיהיה בו כלום, זה רק צריך להיות שמו נכון.

זה יאפשר ssh ב- Pi שלך שיאפשר לך להתחבר אליו באמצעות מרק.

וודא שהקובץ נקרא פשוט ssh ללא סיומת. לא ssh.txt וכו '

שלב 4: הוצא את כרטיס ה- SD מהמחשב האישי שלך, הכנס אותו לפיי שלך והפעל את ה- Pi שלך

הוצא את כרטיס ה- SD מהמחשב, הכנס אותו ל- Pi והפעל את ה- Pi.

אם הכל עבד ה- Pi שלך יאתחל ויתחבר ל- wifi שלך.

תן לו כמה דקות להריץ את ההתקנה הראשונית שלו.

שלב 5: התחבר ל- Pi שלך בעזרת מרק

פתח את מרק ובתיבה שם מארח הקלד raspberrypi וודא שסוג החיבור הוא SSH והיציאה היא 22. אם הוא מתחבר תועבר למסך שחור עם טקסט המכונה מסוף. הוא יבקש את שם המשתמש והסיסמה שלך. שם המשתמש המוגדר כברירת מחדל הוא "pi" וסיסמת ברירת המחדל היא "פטל". מומלץ מאוד לשנות את הסיסמה במיוחד אם אתה מתכוון לחשוף את ה- Pi שלך לאינטרנט. לשם כך, הקלד "passwd" ברגע שאתה מחובר ופעל לפי ההנחיות. הקפד לבחור סיסמה שתזכור.

אם הוא לא מתחבר, ייתכן שיהיה עליך למצוא את כתובת ה- IP שבה הפי שלך משתמש. ישנן דרכים רבות לעשות זאת אך באופן אישי אני פשוט מתחבר לנתב שלי ובודק את רשימת המכשירים המחוברים. לאחר שתמצא את ה- IP של סוג ה- Pi שלך בתיבה שם מארח ב- Putty במקום raspberrypi ונסה להתחבר שוב.

אם עדיין אינך מצליח להתחבר ייתכן שלא יצרת את קובץ ssh כראוי. קרא את השלבים הקודמים ובדוק הכל שוב.

שלב 6: אופציונלי: שנה את שם המארח של ה- Pi שלך

זה לא הכרחי, אבל אני מעדיף שיהיה שם המארח של ה- Pi שלי כמשהו רלוונטי למה הוא משמש, ולא רק "הפטל" הגנרי. במקרה זה קראתי לו "xyzzypi" אבל אתה יכול לקרוא לזה איך שאתה רוצה.

כדי לשנות את סוג שם המארח:

sudo raspi-config

בחר אפשרויות רשת

בחר שם מארח

הזן את שם המארח שאתה רוצה

בחר סיום

הוא ישאל אם אתה רוצה לאתחל את ה- Pi כעת. שם המארח החדש לא ייכנס לתוקף עד שתאתחל מחדש. אם תעשה זאת, הפעלת המרק שלך תתנתק. לאחר סיום האתחול תצטרך להשתמש בשם המארח החדש שהגדרת כדי להתחבר מחדש עם פאט. אם התחברת באמצעות כתובת ה- IP במקום שם המארח, זה עדיין אמור להיות זהה.

יש הרבה אפשרויות אחרות שאתה יכול להגדיר באמצעות הכלי raspi-config אבל יש כבר המון הדרכות על זה באינטרנט אז לא אכנס אליהן כאן.

שלב 7: עדכן את חבילות היישומים שלך

עדכן את חבילות היישומים שלך באמצעות הפקודה הבאה:

עדכון sudo apt-get

תן לזה לרוץ עד שזה יסתיים.

הערה: טכנית אתה כבר לא צריך להקליד "apt-get", אתה יכול פשוט להקליד "apt". עם זאת, אני כל כך רגיל להקליד "apt-get" שזה רק זיכרון שריר בשבילי בשלב זה.

שלב 8: התקן את Git

לאחר סיום חבילות היישומים עדכון ההתקנה Git באמצעות הפקודה הבאה:

sudo apt -get -y להתקין git

תן לזה לרוץ עד שהוא מסיים.

שלב 9: התקן את Maven

התקן את Maven באמצעות הפקודה הבאה:

sudo apt -get -y להתקין maven

תן לזה לרוץ עד שהוא מסיים

שלב 10: הורד את קבצי השרת כאילו אתה Xyzzy

הורד את קבצי השרת כאילו אתה Xyzzy באמצעות הפקודה הבאה:

שיבוט git git: //github.com/ajanata/PretendYoureXyzzy.git

פעולה זו תיצור ספרייה בפי שלך בשם PretendYoureXyzzy ותוריד את הקבצים לתוכה.

תן לזה לרוץ עד שהוא מסיים.

שלב 11: שנה למדריך PretendYoureXyzzy

שנה לספריית PretendYoureXyzzy באמצעות הפקודה הבאה:

CD העמיד פנים שאתה Xyzzy

הערה: פקודות לינוקס תלויות באותיות רישיות ולכן תקליטור 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"

הוא ישאל אם ברצונך לשמור את הקובץ בשם אחר. הקש y על כן.

הקש ctrl+x כדי לסגור את עורך הטקסט של ננו.

שלב 13: פתח וערוך את קובץ "pom.xml" (זה גורם לו לפעול ב- PI)

פתח את הקובץ pom.xml עם עורך טקסט ננו באמצעות הפקודה הבאה:

סודו ננו pom.xml

גלול למטה כמו שעשית בעבר. הפעם השורה שאתה מחפש היא sqlite-jdbc

ממש מתחת לשורה זו יש שורה עם מספר גרסה. עליך לשנות את המספר הזה ל- 3.28.0 כך שייראה כך:

3.28.0

לאחר עריכת מספר הגירסה הקש ctrl+o כדי להציג את תיבת הדו -שיח שמירה.

שמור את שם הקובץ בשם "pom.xml" ושמור אותו.

לאחר השמירה לחץ על ctrl+x כדי לסגור את עורך הטקסט של ננו.

זוהי העריכה שגורמת לשרת להעמיד פנים שאתה Xyzzy פועל על פי. גרסת ה- sqlite-jdbc שהיא מגיעה לא תפעל כראוי על פי. גרסה 3.28.0 עובדת מצוין במבחנים שלי עד כה

שלב 14: הפעל את העמד פנים שאתה שרת Xyzzy וודא שהוא פועל

כעת, לאחר שביצעת את העריכות הדרושות להפעלת שרת העמיד פנים שאתה Xyzzy ב- Pi שלך, בוא נתחיל אותו ונראה אם הכל עובד. הפעל את השרת באמצעות הפקודה הבאה:

מלחמת חבילות נקיות mvn: מזח התפוצץ: הפעל -Dmaven.buildNumber.doCheck = false -Dmaven.buildNumber.doUpdate = false

הוא יוריד כמה קבצים נוספים, יאסוף אותם ויפעיל את השרת. זה כנראה ייקח כמה דקות.

הערה: כרגע זו הדרך היחידה שבה אני יודע איך לגרום לשרת לפעול כך שהוא ירכב בכל פעם שתפעיל אותו.

אתה תדע שזה נעשה כאשר תקבל הודעה שאומרת "טעינת הקונסולה מופעלת. הקש ENTER במסוף כדי להפעיל מחדש את ההקשר."

בשלב זה תוכל לפתוח את הדפדפן שלך ולהקליד בסוף את שם המארח (או כתובת ה- IP) של יציאת הוספת פי 8080. אז שם מארח: 8080 או IP: 8080

אם היית משתמש ב- xyzzypi כשם המארח זה יהיה xyzzypi: 8080 או שבמקרה שלי השימוש ב- IP יהיה 192.168.1.189:8080

אם הכל עבד תועבר לדף הראשי של העמיד פנים שאתה שיזי.

מזל טוב! עשית את זה

אולם כרגע הוא יפעל רק אם תיכנס ל- Pi שלך עם מרק ותפעיל את הפקודה למעלה כדי להפעיל את השרת. ברגע שתסגור את המרק השרת יפסיק. זה יכול להיות בסדר עבור אנשים מסוימים, אך ייתכן שתרצה ששרת העמדת פנים שאתה Xyzzy יפעל באופן אוטומטי בכל פעם שה- Pi יאתחל או יופעל מחדש מבלי שתצטרך להיכנס. השלבים הבאים יעסקו בביצוע העבודה הזו.

שלב 15: צור סקריפט להתחלת השרת כאילו אתה Xyzzy

אם נרצה ששרת העמדת פנים שאתה Xyzzy יתחיל אוטומטית כאשר ה- Pi יאתחל או יפעיל מחדש הדבר הראשון שעלינו לעשות הוא ליצור סקריפט.

הקש ctrl+c כדי לעצור את השרת.

ברגע שהוא מפסיק הקלד את הפקודה הבאה:

סודו ננו xyzzy.sh

הערה: קראתי לתסריט שלי xyzzy.sh אבל אתה יכול לקרוא לו איך שאתה רוצה. רק וודא שיש לו.sh כתוסף הקובץ.

השתמש בסוג עורך הטקסט של ננו או הדבק את הקבצים הבאים בקובץ:

#!/bin/bashcd/home/pi/PretendYoureXyzzy mvn מלחמה חבילה נקייה: מזח התפוצץ: רץ -Dmaven.buildNumber.doCheck = false -Dmaven.buildNumber.doUpdate = false

הקש ctrl+o כדי להציג את תיבת הדו -שיח שמירה

שמור את הקובץ ולחץ על ctrl+x כדי לסגור ננו

שלב 16: הפוך את התסריט שלך להפעלה

עלינו להפוך את התסריט להפעלה באמצעות הפקודה הבאה:

sudo chmod 755 xyzzy.sh

הערה: אם קראת לתסריט שלך משהו אחר בשלב הקודם, השתמש במקום זה בשם הקובץ.

שלב 17: צור ערך Crontab להפעלה אוטומטית של הסקריפט שלך באתחול

ישנן מספר דרכים להפעיל סקריפט בעת אתחול. אני משתמש כאן ב- crontab.

ערוך את טבלאות crontab באמצעות הפקודה הבאה:

crontab -e

זה ישאל באיזה עורך אתה רוצה להשתמש. הקלד 1 והקש Enter כדי להשתמש ב- nano.

ברגע שהוא נפתח גלול כל הדרך לתחתית והוסף את השורה הבאה:

@reboot /home/pi/PretendYoureXyzzy/xyzzy.sh

הערה: שוב, אם השתמשת בשם קובץ אחר עבור סוג הסקריפט שלך במקום זאת.

הקש ctrl+o כדי להציג את תיבת הדו -שיח שמירה.

שמור ולחץ על ctrl+x כדי לסגור ננו.

שלב 18: הפעל מחדש את ה- Pi שלך ובדוק אם אתה יכול להתחבר להעמיד פנים שאתה שיזי

כעת, לאחר שהשרת שלך העמיד פנים שאתה Xyzzy מוגדר לפעול בעת אתחול, תוכל לאתחל את ה- Pi ולוודא שהכל עובד.

אתחל מחדש באמצעות הפקודה הבאה:

sudo אתחול מחדש

ברגע ש- Pi יתחיל לגבות, יידרשו מספר דקות כדי לאסוף מחדש את הכל עבור השרת. תן לזה זמן ולאחר מכן נסה להתחבר לדפדפן שוב או באמצעות שם המארח או ה- IP של יציאת הוספת פי 8080 בסוף.

xyzzypi: 8080 או IP כתובת: 8080

אם הכל עבד תועבר לדף העמיד פנים שאתה שיזי.

מזל טוב! כעת יש לך שרת להעמיד פנים שאתה Xyzzy שפועל אוטומטית ב- Raspberry Pi

שלב 19: אופציונלי: העבר יציאות כדי לאפשר גישה לשרת שלך כאילו אתה Xyzzy דרך האינטרנט

אז עכשיו יש לך שרת העמיד פנים שאתה Xyzzy עובד אבל כרגע הוא נגיש רק ברשת המקומית שלך. זה עובד מצוין אם יש לך קבוצה של חברים לשחק בבית שלך אבל אנשים מחוץ לרשת המקומית שלך לא יוכלו להתחבר.

יהיה עליך לחפש הוראות להעברת יציאות לנתב הספציפי שלך אם אינך יודע עדיין כיצד. העמיד פנים שאתה Xyzzy משתמש ביציאה 8080 אז זו הנמל שתרצה להעביר. לאחר שתגדיר את זה תוכל לתת לחברים שלך את כתובת ה- IP והיציאה החיצונית שלך והם יוכלו להתחבר לשרת שלך דרך האינטרנט.

אם אתה רוצה תוכל גם להגדיר DNS דינאמי כך שיהיה לך כתובת אתר משלך (משהו כמו JoesPYXserver.noip.com) לחלק לחברים כדי להתחבר לשרת שלך. יש כבר המון הדרכות בנושא דברים כאלה.