So tun, als wären Sie ein Xyzzy-Server auf Raspberry Pi - Gunook

2024 Autor: John Day | [email protected]. Zuletzt bearbeitet: 2024-01-30 07:17

Diese Anleitung zeigt Ihnen, wie Sie einen Pretend You're Xyzzy (PYX) Server auf einem Raspberry Pi einrichten. Ich nenne es ein XyzzyPi

Pretend You're Xyzzy ist ein Online-Open-Source-Klon von Cards Against Humanity, der in einem Webbrowser gespielt wird.

Auf Android können Sie auch den Client für die App "Pretend You're Xyzzy" verwenden.

Als ich anfing, meinen eigenen PYX-Server einzurichten, fiel es mir schwer, Anweisungen zu finden, die nicht veraltet und leicht zu befolgen waren. Es schien, dass die meisten von ihnen für Leute geschrieben wurden, die bereits Erfahrung mit der Einrichtung eines PYX-Servers hatten. Ich konnte die Dinge herausfinden, aber ich wollte eine Schritt-für-Schritt-Anleitung für diejenigen erstellen, die weniger technisch versiert sind oder nicht viel Erfahrung mit solchen Dingen haben. Außerdem konnte ich keine Anleitung finden, um es auf einem Raspberry Pi zum Laufen zu bringen. Nach einigem Ausprobieren konnte ich den PYX-Server mit nur geringfügigen Änderungen an den Dateien auf einem Pi zum Laufen bringen. Ich hoffe, dass dies Interessenten etwas Zeit spart.

Ich habe dies auf einem Pi 3 Modell B+ und einem Pi 4 Modell B 4GB gemacht. Es gibt einige Probleme bei der Verwendung eines Pi Zero W, da der Prozessor eine Java-VM nicht richtig verarbeitet. Ich versuche derzeit, es auf einem Zero W zum Laufen zu bringen und werde die Anweisungen aktualisieren, wenn ich erfolgreich bin. Ich habe keinen Pi 1 oder 2 zum Testen, also kann dies mit diesen funktionieren oder nicht.

Ich habe versucht, dieses Tutorial für Menschen aller Erfahrungsstufen leicht verständlich zu machen, daher können hier Dinge enthalten sein, die Sie bereits kennen.

Wenn Sie bereits wissen, wie Sie Raspbian installieren und eine Verbindung zu Ihrem Pi herstellen, fahren Sie mit Schritt 6 fort

Wenn Sie Erfahrung mit der Einrichtung eines PYX-Servers haben und nur die erforderlichen Änderungen kennen möchten, damit er auf einem Pi funktioniert, fahren Sie mit Schritt 13 fort

Haftungsausschluss: Ich habe weder Pretend You're Xyzzy noch die Android-Client-App erstellt.

Gutschrift für die Erstellung von Pretend You're Xyzzy geht an GitHub-Benutzer ajanata (https://github.com/ajanata/PretendYoureXyzzy)

Gutschrift für das Erstellen eines Clients für so tun als wärst du Xyzzy geht an Gianlu (https://play.google.com/store/apps/dev?id=8675761046824387020)

Wenn ich jemanden vermisst habe, lass es mich bitte wissen.

Lieferungen

Hardware:

Raspberry Pi 3 oder 4

Micro-SD-Karte (Ich verwende 32-GB-Micro-SD-Karten, weil ich das zur Hand habe. Sie können wahrscheinlich mit nur 2 GB auskommen, aber ich würde mindestens 4 GB empfehlen.)

PC mit SD-Kartenleser (Ich verwende Windows für dieses Tutorial. Wenn Sie Linux verwenden, sind Sie wahrscheinlich bereits mit vielen dieser Dinge vertraut, also passen Sie die Anweisungen nach Bedarf an.)

Software:

Raspbian-Image: https://www.raspberrypi.org/downloads/raspbian/ (Jedes sollte funktionieren. Ich verwende zum Zeitpunkt des Schreibens Raspbian Buster Lite.)

Win32 Disk Imager: https://sourceforge.net/projects/win32diskimager/ (Es gibt andere Programme, mit denen Sie das Raspbian-Image flashen können, aber dies ist meine persönliche Präferenz.)

Spachtelmasse:

Schritt 1: Flashen Sie Raspbian auf Ihre SD-Karte

Legen Sie Ihre SD-Karte in den Kartenleser Ihres Computers ein, bevor Sie Win32 Disk Imager öffnen. Wählen Sie dann Ihr Raspbian-Image und den Laufwerksbuchstaben Ihrer SD-Karte aus und klicken Sie auf "Schreiben".

ACHTUNG: Alles auf der SD-Karte wird gelöscht und überschrieben. Wenn sich auf der SD-Karte wichtige Daten befinden, sichern Sie diese zuerst. Stellen Sie außerdem sicher, dass Sie den richtigen Laufwerksbuchstaben für Ihre SD-Karte auswählen. Andernfalls könnten Sie versehentlich das falsche Laufwerk löschen/überschreiben

Sobald es fertig ist, haben Sie zwei separate Laufwerke auf Ihrer SD-Karte. Einmal boot genannt und eines, das Windows nicht lesen kann. Sie werden wahrscheinlich ein Popup in Windows erhalten, in dem Sie aufgefordert werden, die Karte zu formatieren. Klicken Sie einfach auf Abbrechen. Wenn Sie es formatieren, müssen Sie Raspbian erneut flashen.

Schritt 2: Erstellen Sie eine Textdatei mit dem Namen „wpa_supplicant.conf“auf dem Bootlaufwerk

Erstellen Sie auf dem Boot-Laufwerk der SD-Karte eine Textdatei namens wpa_supplicant.conf und fügen Sie den folgenden Code ein. Ersetzen Sie "wifi name" und "password" durch Ihren tatsächlichen WLAN-Namen und -Passwort, aber behalten Sie die Anführungszeichen bei. Speicher die Datei.

Dadurch kann sich Ihr Pi mit Ihrem WLAN verbinden. Wenn Sie ein Ethernet-Kabel verwenden, um Ihren Pi mit Ihrem Netzwerk zu verbinden, können Sie diesen Schritt wahrscheinlich überspringen.

Stellen Sie sicher, dass die Dateierweiterung korrekt ist. Es sollte wpa_supplicant.conf sein, nicht wpa_supplicant.conf.txt

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

Netzwerk={

scan_ssid=1 ssid="Wifi-Name" psk="Passwort" }

Schritt 3: Erstellen Sie eine leere Datei mit dem Namen "ssh" auf dem Boot-Laufwerk

Erstellen Sie auf dem Bootlaufwerk der SD-Karte eine leere Datei namens ssh

Es muss nichts drin sein, es muss nur richtig benannt werden.

Dadurch wird ssh auf Ihrem Pi aktiviert, sodass Sie sich mit Putty mit ihm verbinden können.

Stellen Sie sicher, dass die Datei einfach ssh ohne Erweiterung heißt. Nicht ssh.txt usw

Schritt 4: Werfen Sie die SD-Karte von Ihrem PC aus, legen Sie sie in Ihren Pi ein und schalten Sie Ihren Pi ein

Werfen Sie die SD-Karte aus Ihrem PC aus, legen Sie sie in Ihren Pi ein und schalten Sie Ihren Pi ein.

Wenn alles funktioniert hat, wird Ihr Pi hochfahren und eine Verbindung zu Ihrem WLAN herstellen.

Geben Sie ihm ein paar Minuten Zeit, um die Ersteinrichtung zu durchlaufen.

Schritt 5: Verbinden Sie sich mit Ihrem Pi mit Putty

Öffnen Sie Putty und geben Sie in das Feld Hostname raspberrypi ein und stellen Sie sicher, dass der Verbindungstyp SSH und der Port 22 ist. Wenn es eine Verbindung herstellt, werden Sie zu einem schwarzen Bildschirm mit Text weitergeleitet, der als Terminal bekannt ist. Es wird nach Ihrem Benutzernamen und Ihrem Passwort gefragt. Der Standardbenutzername ist "pi" und das Standardpasswort ist "raspberry". Es wird dringend empfohlen, das Passwort zu ändern, insbesondere wenn Sie planen, dass Ihr Pi dem Internet ausgesetzt ist. Geben Sie dazu nach der Anmeldung "passwd" ein und folgen Sie den Anweisungen. Achten Sie darauf, ein Passwort zu wählen, das Sie sich merken werden.

Wenn keine Verbindung hergestellt wird, müssen Sie möglicherweise die IP-Adresse finden, die Ihr Pi verwendet. Es gibt mehrere Möglichkeiten, dies zu tun, aber ich persönlich melde mich einfach bei meinem Router an und überprüfe die Liste der verbundenen Geräte. Sobald Sie die IP Ihres Pi gefunden haben, geben Sie diese in das Feld Hostname in Putty anstelle von raspberrypi ein und versuchen Sie erneut, eine Verbindung herzustellen.

Wenn Sie immer noch keine Verbindung herstellen können, haben Sie die SSH-Datei möglicherweise nicht richtig erstellt. Lesen Sie die vorherigen Schritte durch und überprüfen Sie alles.

Schritt 6: Optional: Ändern Sie den Hostnamen Ihres Pi

Dies ist nicht notwendig, aber ich bevorzuge es, den Hostnamen meines Pi als etwas zu verwenden, das für seine Verwendung relevant ist, und nicht nur das generische "raspberrypi". In diesem Fall habe ich es "xyzzypi" genannt, aber Sie können es nennen, wie Sie möchten.

So ändern Sie den Hostnamentyp:

sudo raspi-config

Wählen Sie Netzwerkoptionen

Hostnamen auswählen

Geben Sie einen beliebigen Hostnamen ein

Wählen Sie Fertig stellen

Es wird gefragt, ob Sie den Pi jetzt neu starten möchten. Der neue Hostname wird erst nach einem Neustart wirksam. Wenn Sie dies tun, wird Ihre Putty-Sitzung getrennt. Sobald der Neustart abgeschlossen ist, müssen Sie den neuen Hostnamen verwenden, den Sie festgelegt haben, um sich wieder mit Putty zu verbinden. Wenn Sie die Verbindung mit der IP-Adresse anstelle des Hostnamens hergestellt haben, sollte es immer noch derselbe sein.

Es gibt viele andere Optionen, die Sie mit dem raspi-config-Tool einstellen können, aber es gibt bereits viele Tutorials dazu online, daher werde ich hier nicht darauf eingehen.

Schritt 7: Aktualisieren Sie Ihre Anwendungspakete

Aktualisieren Sie Ihre Anwendungspakete mit dem folgenden Befehl:

sudo apt-get update

Lassen Sie es laufen, bis es fertig ist.

Hinweis: Technisch müssen Sie nicht mehr "apt-get" eingeben, Sie können einfach "apt" eingeben. Ich bin jedoch so daran gewöhnt, "apt-get" zu tippen, dass es für mich zu diesem Zeitpunkt nur noch Muskelgedächtnis ist.

Schritt 8: Git installieren

Sobald die Aktualisierung der Anwendungspakete abgeschlossen ist, installieren Sie Git mit dem folgenden Befehl:

sudo apt-get -y git installieren

Lassen Sie es laufen, bis es fertig ist.

Schritt 9: Maven installieren

Installieren Sie Maven mit dem folgenden Befehl:

sudo apt-get -y install maven

Lass es laufen bis es fertig ist

Schritt 10: Laden Sie die Dateien für den Xyzzy-Server herunter

Laden Sie die Serverdateien von Pretend You're Xyzzy mit dem folgenden Befehl herunter:

git clone git://github.com/ajanata/PretendYoureXyzzy.git

Dadurch wird ein Verzeichnis auf Ihrem Pi namens PretendYoureXyzzy erstellt und die Dateien darin heruntergeladen.

Lassen Sie es laufen, bis es fertig ist.

Schritt 11: Wechseln Sie zum PretendYoureXyzzy-Verzeichnis

Wechseln Sie mit dem folgenden Befehl in das Verzeichnis PretendYoureXyzzy:

cd PretendYoureXyzzy

Hinweis: Bei Linux-Befehlen muss die Groß-/Kleinschreibung beachtet werden, sodass cd PretendYoureXyzzy funktioniert, cd pretendyourexyzzy jedoch nicht.

Schritt 12: Öffnen und bearbeiten Sie die Datei „build.properties.example“und speichern Sie sie als „build.properties“

Öffnen Sie die Datei build.properties.example mit dem Nano-Texteditor mit dem folgenden Befehl:

sudo nano build.properties.example

Die Verwendung eines terminalbasierten Texteditors kann für diejenigen, die nicht daran gewöhnt sind, einschüchternd wirken, aber was wir tun, ist sehr einfach.

Verwenden Sie die Pfeiltaste nach unten, um nach unten zu scrollen, bis Sie die Abschnitte mit der Aufschrift "hibernate.username" und "hibernate.password" finden.

Verwenden Sie die rechte Pfeiltaste, um zum Ende dieser Zeilen zu wechseln und den Benutzernamen und das Passwort in etwas anderes zu ändern. Ehrlich gesagt weiß ich nicht, ob es wirklich notwendig ist, aber ich mag es nicht, sie auf dem Standardbenutzernamen und -kennwort zu belassen, mit dem sie kamen.

Sobald Sie sie geändert haben, drücken Sie Strg + o, um den Speicherdialog aufzurufen.

Rücktaste, um ".example" am Ende des Dateinamens zu entfernen, sodass nur noch "build.properties" übrig bleibt

Sie werden gefragt, ob Sie die Datei unter einem anderen Namen speichern möchten. Drücken Sie y für Ja.

Drücken Sie Strg+x, um den Nano-Texteditor zu schließen.

Schritt 13: Öffnen und bearbeiten Sie die Datei "pom.xml" (DAS LÄUFT SIE AUF einem PI)

Öffnen Sie die Datei pom.xml mit dem Nano-Texteditor mit dem folgenden Befehl:

sudo nano pom.xml

Scrollen Sie wie zuvor nach unten. Diesmal ist die gesuchte Zeile sqlite-jdbc

Direkt unter dieser Zeile befindet sich eine Zeile mit einer Versionsnummer. Sie müssen diese Zahl in 3.28.0 ändern, damit sie wie folgt aussieht:

3.28.0

Nachdem Sie die Versionsnummer bearbeitet haben, drücken Sie Strg+o, um den Speicherdialog aufzurufen.

Behalten Sie den Dateinamen als "pom.xml" bei und speichern Sie ihn.

Drücken Sie nach dem Speichern Strg+x, um den Nano-Texteditor zu schließen.

Dies ist die Bearbeitung, die den Pretend You're Xyzzy-Server auf einem Pi ausführen lässt. Die mitgelieferte sqlite-jdbc-Version läuft auf einem Pi nicht richtig. Version 3.28.0 funktioniert in meinen bisherigen Tests hervorragend

Schritt 14: Starten Sie den Xyzzy-Server und stellen Sie sicher, dass er funktioniert

Nachdem Sie nun die erforderlichen Änderungen vorgenommen haben, um einen Pretend You're Xyzzy-Server auf Ihrem Pi auszuführen, starten wir ihn und sehen, ob alles funktioniert. Starten Sie den Server mit dem folgenden Befehl:

mvn clean package war:exploded jetty:run -Dmaven.buildNumber.doCheck=false -Dmaven.buildNumber.doUpdate=false

Es lädt einige zusätzliche Dateien herunter, kompiliert sie und startet den Server. Dies wird wahrscheinlich ein paar Minuten dauern.

Hinweis: Derzeit ist dies die einzige Möglichkeit, die ich kenne, um den Server zum Laufen zu bringen, damit er bei jedem Start kompiliert wird.

Sie wissen, dass der Vorgang abgeschlossen ist, wenn Sie die Meldung „Neuladen der Konsole ist AKTIVIERT. Drücken Sie die EINGABETASTE auf der Konsole, um den Kontext neu zu starten“erhalten.

An dieser Stelle können Sie Ihren Browser öffnen und den Hostnamen (oder die IP-Adresse) des Pi eingeben, indem Sie am Ende den Port 8080 hinzufügen. Also Hostname:8080 oder IP:8080

Wenn Sie xyzzypi als Hostnamen verwenden, wäre es xyzzypi:8080 oder in meinem Fall die IP-Adresse 192.168.1.189:8080

Wenn alles funktioniert hat, werden Sie zur Hauptseite von Pretend You're Xyzzy weitergeleitet.

Herzliche Glückwünsche! Du hast es geschafft

Im Moment wird es jedoch nur ausgeführt, wenn Sie sich mit Putty bei Ihrem Pi anmelden und den obigen Befehl ausführen, um den Server zu starten. Sobald Sie Putty schließen, wird der Server angehalten. Dies mag für einige Leute in Ordnung sein, aber Sie möchten vielleicht, dass der Pretend You're Xyzzy-Server automatisch ausgeführt wird, wenn der Pi hochfährt oder neu gestartet wird, ohne sich anmelden zu müssen. Die nächsten Schritte behandeln dies.

Schritt 15: Erstellen Sie ein Skript, um so zu tun, als wären Sie Xyzzy-Server

Wenn wir möchten, dass der Pretend You're Xyzzy-Server automatisch startet, wenn der Pi bootet oder neu startet, müssen wir als erstes ein Skript erstellen.

Drücken Sie Strg+C, um den Server zu stoppen.

Sobald es anhält, geben Sie den folgenden Befehl ein:

sudo nano xyzzy.sh

Hinweis: Ich habe mein Skript xyzzy.sh genannt, aber Sie können es beliebig benennen. Stellen Sie nur sicher, dass die Dateierweiterung.sh ist.

Geben Sie mit dem Nano-Texteditor Folgendes ein oder fügen Sie es in die Datei ein:

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

Drücken Sie Strg+o, um den Speicherdialog aufzurufen

Speichern Sie die Datei und drücken Sie Strg+x, um nano zu schließen

Schritt 16: Machen Sie Ihr Skript ausführbar

Wir müssen das Skript mit dem folgenden Befehl ausführbar machen:

sudo chmod 755 xyzzy.sh

Hinweis: Wenn Sie Ihr Skript im vorherigen Schritt anders benannt haben, verwenden Sie stattdessen diesen Dateinamen.

Schritt 17: Erstellen Sie einen Crontab-Eintrag, um Ihr Skript beim Booten automatisch auszuführen

Es gibt mehrere Möglichkeiten, ein Skript beim Booten auszuführen. Ich verwende hier crontab.

Bearbeiten Sie die crontab-Tabellen mit dem folgenden Befehl:

crontab -e

Es wird gefragt, welchen Editor Sie verwenden möchten. Geben Sie 1 ein und drücken Sie die Eingabetaste, um nano zu verwenden.

Scrollen Sie nach dem Öffnen ganz nach unten und fügen Sie die folgende Zeile hinzu:

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

Hinweis: Wenn Sie stattdessen einen anderen Dateinamen für Ihr Skript verwendet haben, geben Sie diesen ein.

Drücken Sie Strg+o, um den Speicherdialog aufzurufen.

Speichern und drücken Sie Strg+x, um nano zu schließen.

Schritt 18: Starten Sie Ihren Pi neu und sehen Sie, ob Sie eine Verbindung herstellen können, um so zu tun, als wären Sie Xyzzy

Nachdem Sie Ihren Pretend You're Xyzzy-Server so eingestellt haben, dass er beim Booten ausgeführt wird, können Sie den Pi neu starten und sicherstellen, dass alles funktioniert.

Starten Sie mit dem folgenden Befehl neu:

sudo neu starten

Sobald der Pi wieder hochgefahren ist, dauert es einige Minuten, um alles für den Server neu zu kompilieren. Geben Sie ihm Zeit und versuchen Sie dann erneut, sich im Browser zu verbinden, indem Sie entweder den Hostnamen oder die IP des Pi verwenden, indem Sie am Ende Port 8080 hinzufügen.

xyzzypi:8080 oder IP-Adresse:8080

Wenn alles funktioniert hat, werden Sie auf die Seite „So tun, als wären Sie Xyzzy“weitergeleitet.

Herzliche Glückwünsche! Sie haben jetzt einen Pretend You're Xyzzy-Server, der automatisch auf einem Raspberry Pi läuft

Schritt 19: Optional: Weiterleiten von Ports, um den Zugriff auf Ihren vorgebenden Xyzzy-Server über das Internet zu ermöglichen

Jetzt haben Sie also einen funktionierenden Pretend You're Xyzzy-Server, aber im Moment ist er nur in Ihrem lokalen Netzwerk zugänglich. Dies funktioniert gut, wenn Sie eine Gruppe von Freunden haben, die bei Ihnen zu Hause spielen, aber Personen außerhalb Ihres lokalen Netzwerks können sich nicht verbinden.

Sie müssen die Anweisungen zur Portweiterleitung für Ihren spezifischen Router nachschlagen, wenn Sie nicht bereits wissen, wie. Tu so, als wärst du Xyzzy verwendet Port 8080, das ist der Port, den Sie weiterleiten möchten. Sobald Sie es eingerichtet haben, können Sie Ihren Freunden Ihre externe IP-Adresse und Ihren Port mitteilen und sie können sich über das Internet mit Ihrem Server verbinden.

Wenn Sie möchten, können Sie auch dynamisches DNS einrichten, sodass Sie Ihre eigene URL (etwa JoesPYXserver.noip.com) haben, die Sie an Freunde weitergeben können, um sich mit Ihrem Server zu verbinden. Dafür gibt es schon viele Tutorials.