Lad som om du er Xyzzy Server på Raspberry Pi: 19 trin

2024 Forfatter: John Day | [email protected]. Sidst ændret: 2024-01-30 08:27

Denne vejledning viser dig, hvordan du konfigurerer en Udgiv dig Xyzzy (PYX) server på en Raspberry Pi. Jeg kalder det en XyzzyPi

Lad som om du er Xyzzy er en online, open-source Cards Against Humanity-klon, der spilles i en webbrowser.

På Android kan du også bruge klienten til at foregive, at du er Xyzzy -appen.

Da jeg begyndte at undersøge opsætningen af min egen PYX -server, havde jeg svært ved at finde instruktioner, der ikke var forældede, og som var lette at følge. Det så ud til, at de fleste af dem var skrevet til folk, der allerede havde en vis erfaring med at oprette en PYX -server. Jeg var i stand til at finde ud af tingene, men jeg ville oprette en trin-for-trin guide til dem, der er mindre teknologiske eller som ikke har meget erfaring med sådanne ting. Jeg kunne heller ikke finde nogen instruktioner om at få det til at køre på en Raspberry Pi. Efter nogle forsøg og fejl kunne jeg få PYX -serveren til at køre på en Pi med kun nogle små ændringer af filerne. Jeg håber, at dette vil spare lidt tid for dem, der er interesseret.

Jeg har gjort dette på en Pi 3 model B+ og en Pi 4 model B 4GB. Der er nogle problemer med at bruge en Pi Zero W, fordi processoren ikke håndterer en Java VM korrekt. Jeg prøver i øjeblikket at få det til at fungere på et Zero W og vil opdatere instruktionerne, hvis jeg lykkes. Jeg har ikke en Pi 1 eller 2 at teste på, så dette kan eller ikke kan fungere med dem.

Jeg har forsøgt at gøre denne vejledning let at følge for folk på alle niveauer, så der kan være ting herinde, som du allerede kender.

Hvis du allerede ved, hvordan du installerer Raspbian og opretter forbindelse til din Pi, skal du gå til trin 6

Hvis du har erfaring med at oprette en PYX -server og bare vil vide, hvilke redigeringer der er nødvendige for at få det til at fungere på en Pi, skal du gå videre til trin 13

Ansvarsfraskrivelse: Jeg har ikke oprettet Lad som om du er Xyzzy eller Android -klientappen.

Kredit for at oprette, som om du er Xyzzy, går til GitHub -bruger ajanata (https://github.com/ajanata/PretendYoureXyzzy)

Kredit for at oprette klient For foregive at du er Xyzzy går til Gianlu (https://play.google.com/store/apps/dev?id=8675761046824387020)

Hvis der er nogen jeg savnede, så lad mig det vide.

Forbrugsvarer

Hardware:

Raspberry Pi 3 eller 4

Micro SD -kort (jeg bruger 32 GB micro SD -kort, fordi det er det, jeg har ved hånden. Du kan sikkert klare dig med så lidt som 2 GB, men jeg vil anbefale mindst 4 GB.)

PC med SD -kortlæser (jeg bruger Windows til denne vejledning. Hvis du kører Linux, kender du sikkert allerede mange af disse ting, så juster instruktionerne efter behov.)

Software:

Raspbian -billede: https://www.raspberrypi.org/downloads/raspbian/ (Enhver skal fungere. Jeg bruger Raspbian Buster Lite i skrivende stund.)

Win32 Disk Imager: https://sourceforge.net/projects/win32diskimager/ (Der er andre programmer, du kan bruge til at blinke Raspbian -billedet, men dette er min personlige præference.)

Kitt:

Trin 1: Flash Raspbian på dit SD -kort

Sæt dit SD -kort i din computers kortlæser, før du åbner Win32 Disk Imager. Vælg derefter dit Raspbian -billede og dit SD -korts drevbogstav og klik på "Skriv".

FORSIGTIG: Alt på SD -kortet slettes og overskrives. Hvis der er vigtige data på SD -kortet, skal du først sikkerhedskopiere det. Sørg også for at vælge det korrekte drevbogstav til dit SD -kort. Ellers kan du utilsigtet slette/overskrive det forkerte drev

Når det er færdigt, har du to separate drev på dit SD -kort. Engang kaldet boot og en, som Windows ikke kan læse. Du får sandsynligvis en pop op i Windows, der beder dig om at formatere kortet. Bare klik på annuller. Hvis du formaterer det, skal du blinke Raspbian igen.

Trin 2: Opret en tekstfil med navnet "wpa_supplicant.conf" på bootdrevet

På SD -kortets startdrev skal du oprette en tekstfil med navnet wpa_supplicant.conf og indsætte koden herunder inde. Erstat "wifi -navn" og "adgangskode" med dit faktiske wifi -navn og adgangskode, men behold citaterne omkring dem. Gem filen.

Dette giver din Pi mulighed for at oprette forbindelse til din wifi. Hvis du bruger et ethernet -kabel til at slutte din Pi til dit netværk, kan du sandsynligvis springe dette trin over.

Sørg for, at filtypen er korrekt. Det skal være wpa_supplicant.conf ikke wpa_supplicant.conf.txt

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

netværk = {

scan_ssid = 1 ssid = "wifi -navn" psk = "password"}

Trin 3: Opret en tom fil med navnet "ssh" på bootdrevet

Opret en tom fil ved navn ssh på SD -kortets startdrev

Det behøver ikke at have noget i det, det skal bare navngives korrekt.

Dette aktiverer ssh på din Pi, som giver dig mulighed for at oprette forbindelse til den ved hjælp af Putty.

Sørg for, at filen simpelthen hedder ssh uden udvidelse. Ikke ssh.txt osv

Trin 4: Skub SD -kortet ud fra din pc, sæt det i din Pi, og tænd for din Pi

Skub SD -kortet ud af din pc, sæt det i din Pi, og tænd for din Pi.

Hvis alt fungerede, starter din Pi op og opretter forbindelse til din wifi.

Giv det et par minutter til at gennemgå det første setup.

Trin 5: Opret forbindelse til din Pi ved hjælp af kitt

Åbn Putty og i feltet Host Name skriv raspberrypi, og sørg for, at forbindelsestypen er SSH, og porten er 22. Hvis den opretter forbindelse, bliver du ført til en sort skærm med tekst på, kendt som en terminal. Det vil bede om dit brugernavn og din adgangskode. Standardbrugernavnet er "pi", og standardadgangskoden er "hindbær". Det anbefales stærkt, at du ændrer adgangskoden, især hvis du planlægger at få din Pi udsat for internettet. For at gøre det skal du skrive "passwd", når du er logget ind og følge vejledningen. Sørg for at vælge en adgangskode, som du vil huske.

Hvis den ikke opretter forbindelse, skal du muligvis finde den IP -adresse, som din Pi bruger. Der er flere måder at gøre dette på, men personligt logger jeg bare på min router og tjekker listen over tilsluttede enheder. Når du har fundet IP'en af din Pi -type, der ligger i boksen Værtsnavn i Putty i stedet for raspberrypi, og prøv at oprette forbindelse igen.

Hvis du stadig ikke kan oprette forbindelse, har du muligvis ikke oprettet ssh -filen korrekt. Læs de foregående trin igennem, og kontroller alt igen.

Trin 6: Valgfrit: Skift værtsnavn for din Pi

Dette er ikke nødvendigt, men jeg foretrækker at have værtsnavnet på min Pi som noget, der er relevant for, hvad det bruges til frem for bare det generiske "raspberrypi". I dette tilfælde kaldte jeg det "xyzzypi", men du kan kalde det, hvad du vil.

Sådan ændrer du værtsnavnetypen:

sudo raspi-config

Vælg Netværksindstillinger

Vælg værtsnavn

Indtast det værtsnavn, du ønsker

Vælg Afslut

Det vil spørge, om du vil genstarte Pi nu. Det nye værtsnavn træder ikke i kraft, før du genstarter. Hvis du gør det, afbrydes din Putty -session. Når den er genstartet, skal du bruge det nye værtsnavn, du har indstillet til at genoprette forbindelse til Putty. Hvis du forbandt ved hjælp af IP -adressen i stedet for værtsnavnet, skulle det stadig være det samme.

Der er masser af andre muligheder, du kan indstille ved hjælp af raspi-config-værktøjet, men der er allerede masser af tutorials om det online, så jeg vil ikke gå ind på dem her.

Trin 7: Opdater dine applikationspakker

Opdater dine applikationspakker ved hjælp af følgende kommando:

sudo apt-get opdatering

Lad det køre, indtil det er færdigt.

Bemærk: Teknisk behøver du ikke at skrive "apt-get" længere, du kan bare skrive "apt". Jeg er dog så vant til at skrive "apt-get", at det bare er muskelhukommelse for mig på dette tidspunkt.

Trin 8: Installer Git

Når programpakkerne er færdige med at opdatere installation af Git ved hjælp af følgende kommando:

sudo apt -get -y installer git

Lad det køre, indtil det er færdigt.

Trin 9: Installer Maven

Installer Maven ved hjælp af følgende kommando:

sudo apt -get -y installer maven

Lad det køre, indtil det er færdigt

Trin 10: Download foregiv, at du er Xyzzy serverfiler

Download forestil dig, at du er Xyzzy -serverfiler ved hjælp af følgende kommando:

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

Dette vil oprette en mappe på din Pi ved navn PretendYoureXyzzy og downloade filerne til den.

Lad det køre, indtil det er færdigt.

Trin 11: Skift til PretendYoureXyzzy Directory

Skift til biblioteket PretendYoureXyzzy ved hjælp af følgende kommando:

cd foregiveYoureXyzzy

Bemærk: Linux -kommandoer er store og små bogstaver, så cd PretendYoureXyzzy fungerer, men cd pretendyourexyzzy vil ikke.

Trin 12: Åbn og rediger filen "build.properties.example" og gem den som "build.properties"

Åbn build.properties.example -filen med nano -teksteditor ved hjælp af følgende kommando:

sudo nano build.properties.example

Brug af en terminalbaseret teksteditor kan virke lidt skræmmende for dem, der ikke er vant til det, men det vi laver er meget enkelt.

Brug pil ned til at rulle ned, indtil du finder sektionerne, der siger "dvale.brugernavn" og "dvale.passord".

Brug den højre piletast til at flytte til slutningen af disse linjer og ændre brugernavn og adgangskode til noget andet. Ærligt talt ved jeg ikke, om det overhovedet er virkelig nødvendigt, men jeg er ikke fortrolig med at lade dem stå på det standard brugernavn og adgangskode, som de fulgte med.

Når du har ændret dem, skal du trykke på ctrl+o for at få vist dialogboksen Gem.

Tilbage for at fjerne ".eksempel" fra slutningen af filnavnet, så du står tilbage med bare "build.properties"

Den vil spørge, om du vil gemme filen under et andet navn. Tryk på y for ja.

Tryk på ctrl+x for at lukke nano -teksteditor.

Trin 13: Åbn og rediger "pom.xml" -filen (DET ER DET, DET GØR DET KØRER PÅ et PI)

Åbn pom.xml -filen med nano -teksteditor ved hjælp af følgende kommando:

sudo nano pom.xml

Rul ned som du gjorde før. Denne gang er linjen, du leder efter, sqlite-jdbc

Lige under denne linje er en linje med et versionsnummer. Du skal ændre dette nummer til 3.28.0, så det ser ud som:

3.28.0

Når du har redigeret versionsnummeret, skal du trykke på ctrl+o for at åbne dialogboksen Gem.

Behold filnavnet som "pom.xml", og gem det.

Når det er gemt, skal du trykke på ctrl+x for at lukke nano -teksteditor.

Dette er redigeringen, der får serveren til at lade som om du er Xyzzy køre på en Pi. Den sqlite-jdbc-version, den følger med, kører ikke korrekt på en Pi. Version 3.28.0 fungerer godt i mine tests indtil videre

Trin 14: Start forestillingen om, at du er Xyzzy -serveren, og sørg for, at den fungerer

Nu hvor du har foretaget de nødvendige redigeringer for at køre en Forestil dig Xyzzy -server på din Pi, lad os starte den og se, om alt fungerer. Start serveren ved hjælp af følgende kommando:

mvn ren pakke krig: eksploderet anløbsbro: kør -Dmaven.buildNumber.doCheck = false -Dmaven.buildNumber.doUpdate = false

Det vil downloade nogle ekstra filer, kompilere dem og starte serveren. Dette vil sandsynligvis tage et par minutter.

Bemærk: I øjeblikket er det den eneste måde, jeg ved, hvordan jeg får serveren til at køre, så den vil kompilere hver gang du starter den.

Du ved, at det er gjort, når du får en besked, der siger "Genindlæsning af konsol er AKTIVERET. Tryk på ENTER på konsollen for at genstarte konteksten."

På dette tidspunkt kan du åbne din browser og indtaste værtsnavnet (eller IP -adressen) på Pi -tilføjelsesporten 8080 i slutningen. Så værtsnavn: 8080 eller IP: 8080

Hvis du brugte xyzzypi som værtsnavn, ville det være xyzzypi: 8080 eller i mit tilfælde ville det være 192.168.1.189:8080 i mit tilfælde

Hvis alt fungerede, blev du taget til hovedsiden for at foregive, at du er Xyzzy.

Tillykke! Du har gjort det

Men lige nu vil det kun køre, hvis du logger ind på din Pi med Putty og kører kommandoen ovenfor for at starte serveren. Når du lukker Putty, stopper serveren. Dette kan være fint for nogle mennesker, men du vil måske have, som om du lader som om du er Xyzzy -serveren, automatisk kører, når Pi starter eller genstartes uden at skulle logge ind. De næste trin vil dække, hvordan det fungerer.

Trin 15: Lav et script til at starte som om du er Xyzzy -server

Hvis vi vil have, at foregive at du er Xyzzy -serveren starter automatisk, når Pi starter eller genstarter, er det første, vi skal gøre, at oprette et script.

Tryk på ctrl+c for at stoppe serveren.

Når den stopper, skal du skrive følgende kommando:

sudo nano xyzzy.sh

Bemærk: Jeg navngav mit script xyzzy.sh, men du kan navngive det, hvad du vil. Bare sørg for at den har.sh som filtypen.

Brug nano tekst editor type eller indsæt følgende i filen:

#!/bin/bashcd/home/pi/PretendYoureXyzzy mvn ren pakke krig: eksploderet anløbsbro: kør -Dmaven.buildNumber.doCheck = false -Dmaven.buildNumber.doUpdate = false

Tryk på ctrl+o for at åbne dialogboksen Gem

Gem filen, og tryk på ctrl+x for at lukke nano

Trin 16: Gør dit script eksekverbart

Vi skal gøre scriptet eksekverbart ved hjælp af følgende kommando:

sudo chmod 755 xyzzy.sh

Bemærk: Hvis du navngav dit script noget anderledes i det foregående trin, skal du bruge det filnavn i stedet.

Trin 17: Opret en Crontab -post for automatisk at køre dit script ved opstart

Der er flere måder at få et script til at køre på boot. Jeg bruger crontab her.

Rediger crontab -tabellerne ved hjælp af følgende kommando:

crontab -e

Det vil spørge, hvilken editor du vil bruge. Skriv 1, og tryk på enter for at bruge nano.

Når den åbnes, skal du rulle helt til bunden og tilføje følgende linje:

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

Bemærk: Igen, hvis du i stedet brugte et andet filnavn til din scripttype.

Tryk på ctrl+o for at åbne dialogboksen Gem.

Gem og tryk på ctrl+x for at lukke nano.

Trin 18: Genstart din Pi og se om du kan oprette forbindelse til at foregive at du er Xyzzy

Nu hvor du har din Forestil dig Xyzzy -server indstillet til at køre på boot, kan du genstarte Pi og sikre, at det hele fungerer.

Genstart ved hjælp af følgende kommando:

sudo genstart

Når Pi starter igen, tager det et par minutter at genkompilere alt til serveren. Giv det tid, og prøv derefter at oprette forbindelse i browseren igen enten ved hjælp af værtsnavnet eller IP'en på Pi -tilføjelsesporten 8080 i slutningen.

xyzzypi: 8080 eller IP -adresse: 8080

Hvis alt fungerede, vil du blive ført til siden, som om du er Xyzzy.

Tillykke! Du har nu lad som om du er en Xyzzy server, der kører automatisk på en Raspberry Pi

Trin 19: Valgfrit: Videresend porte for at give adgang til din foregivelse af, at du er en Xyzzy -server over internettet

Så nu har du en fungerende Forestil dig Xyzzy -server, men i øjeblikket er den kun tilgængelig på dit lokale netværk. Dette fungerer fint, hvis du har en gruppe venner til at spille hjemme hos dig, men folk uden for dit lokale netværk ikke kan oprette forbindelse.

Du skal slå op på port forwarding -instruktioner til din specifikke router, hvis du ikke allerede ved hvordan. Lad som om du er Xyzzy bruger port 8080, så det er den port, du vil videresende. Når du har konfigureret det, kan du give dine venner din eksterne IP -adresse og port, og de vil kunne oprette forbindelse til din server via internettet.

Hvis du ville, kunne du også konfigurere dynamisk DNS, så du har din egen URL (noget som JoesPYXserver.noip.com), som du kan give til venner for at oprette forbindelse til din server. Der er masser af selvstudier derude til den slags.