Lat som om du er Xyzzy Server på Raspberry Pi: 19 trinn

2024 Forfatter: John Day | [email protected]. Sist endret: 2024-01-30 11:22

Denne guiden viser deg hvordan du konfigurerer en late som om du er Xyzzy (PYX) -server på en Raspberry Pi. Jeg kaller det en XyzzyPi

Lat som om du er Xyzzy er en online, åpen kildekode-kort mot menneskeheten som klones i en nettleser.

På Android kan du også bruke klienten for late som om du er Xyzzy -appen.

Da jeg begynte å se på å sette opp min egen PYX -server, hadde jeg vanskelig for å finne instruksjoner som ikke var utdaterte og som var enkle å følge. Det så ut til at de fleste av dem var skrevet for folk som allerede hadde litt erfaring med å sette opp en PYX -server. Jeg klarte å finne ut av ting, men jeg ønsket å lage en trinnvis guide for de som er mindre teknisk kunnskapsrike eller som ikke har mye erfaring med slike ting. Jeg kunne heller ikke finne noen instruksjoner for hvordan den skal kjøres på en Raspberry Pi. Etter litt prøving og feiling klarte jeg å få PYX -serveren til å kjøre på en Pi med bare noen små modifikasjoner av filene. Jeg håper dette vil spare litt tid for de som er interessert.

Jeg har gjort dette på en Pi 3 modell B+ og en Pi 4 modell B 4GB. Det er noen problemer med å bruke en Pi Zero W på grunn av at prosessoren ikke håndterer en Java VM riktig. Jeg prøver for tiden å få det til å fungere på en Zero W, og vil oppdatere instruksjonene hvis jeg lykkes. Jeg har ikke en Pi 1 eller 2 å teste på, så dette fungerer kanskje ikke med dem.

Jeg har prøvd å gjøre denne opplæringen lett å følge for folk på alle ferdighetsnivåer, så det kan være ting her du allerede vet.

Hvis du allerede vet hvordan du installerer Raspbian og kobler til Pi, hopper du til trinn 6

Hvis du har erfaring med å sette opp en PYX -server og bare vil vite redigeringene som er nødvendige for å få det til å fungere på et Pi, gå til trinn 13

Ansvarsfraskrivelse: Jeg opprettet ikke late som om du er Xyzzy eller Android -klientappen.

Kreditt for å lage late som om du er Xyzzy går til GitHub -bruker ajanata (https://github.com/ajanata/PretendYoureXyzzy)

Kreditt for å opprette klient For late som om du er Xyzzy går til Gianlu (https://play.google.com/store/apps/dev?id=8675761046824387020)

Gi meg beskjed hvis det er noen jeg savnet.

Rekvisita

Maskinvare:

Raspberry Pi 3 eller 4

Micro SD -kort (jeg bruker 32 GB micro SD -kort fordi det er det jeg har for hånden. Du kan sikkert klare deg med så lite som 2 GB, men jeg vil anbefale minst 4 GB.)

PC med SD -kortleser (jeg bruker Windows for denne opplæringen. Hvis du kjører Linux, er du sannsynligvis allerede kjent med mye av dette, så juster instruksjonene etter behov.)

Programvare:

Raspbian -bilde: https://www.raspberrypi.org/downloads/raspbian/ (Alle skal fungere. Jeg bruker Raspbian Buster Lite i skrivende stund.)

Win32 Disk Imager: https://sourceforge.net/projects/win32diskimager/ (Det er andre programmer du kan bruke til å blinke Raspbian -bildet, men dette er min personlige preferanse.)

Kitt:

Trinn 1: Flash Raspbian på SD -kortet ditt

Sett SD -kortet i datamaskinens kortleser før du åpner Win32 Disk Imager. Velg deretter ditt Raspbian -bilde og SD -kortets stasjonsbokstav og klikk "Skriv".

FORSIKTIG: Alt på SD -kortet blir slettet og overskrevet. Hvis det er viktige data på SD -kortet, må du sikkerhetskopiere det først. Sørg også for at du velger riktig stasjonsbokstav for SD -kortet. Ellers kan du utilsiktet tørke/overskrive feil stasjon

Når den er ferdig, vil du ha to separate stasjoner på SD -kortet. En gang kalt boot og en som Windows ikke kan lese. Du vil sannsynligvis få en pop -up i Windows som ber deg formatere kortet. Bare klikk på Avbryt. Hvis du formaterer det, må du blinke Raspbian igjen.

Trinn 2: Lag en tekstfil med navnet "wpa_supplicant.conf" på oppstartsstasjonen

Lag en tekstfil med navnet wpa_supplicant.conf på SD -kortets oppstartsdisk og lim inn koden nedenfor inne. Erstatt "wifi -navn" og "passord" med ditt faktiske wifi -navn og passord, men behold anførselene rundt dem. Lagre filen.

Dette vil tillate Pi å koble til wifi. Hvis du bruker en ethernet -kabel for å koble Pi til nettverket, kan du sannsynligvis hoppe over dette trinnet.

Sørg for at filtypen er riktig. Det bør være wpa_supplicant.conf ikke wpa_supplicant.conf.txt

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

nettverk = {

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

Trinn 3: Lag en tom fil med navnet "ssh" på oppstartsstasjonen

Lag en tom fil som heter ssh på oppstartstasjonen på SD -kortet

Det trenger ikke å ha noe i det, det må bare navngis riktig.

Dette vil aktivere ssh på Pi som lar deg koble til den ved hjelp av Putty.

Sørg for at filen ganske enkelt heter ssh uten utvidelse. Ikke ssh.txt etc

Trinn 4: Løs ut SD -kortet fra PC -en, sett det inn i Pi -enheten og slå på Pi -enheten

Ta ut SD -kortet fra PC -en, sett det i Pi -enheten og slå på Pi -enheten.

Hvis alt fungerte, vil Pi starte opp og koble til wifi.

Gi det et par minutter å gå gjennom det første oppsettet.

Trinn 5: Koble til din Pi ved hjelp av kitt

Åpne Putty og skriv inn raspberrypi i boksen Host Name, og sørg for at tilkoblingstypen er SSH og porten er 22. Hvis den kobles til, blir du ført til en svart skjerm med tekst på den kjent som en terminal. Det vil be om brukernavn og passord. Standard brukernavn er "pi" og standardpassordet er "bringebær". Det anbefales på det sterkeste at du endrer passordet, spesielt hvis du planlegger å få din Pi eksponert for internett. For å gjøre det, skriver du "passwd" når du er logget inn og følger instruksjonene. Sørg for å velge et passord du vil huske.

Hvis den ikke kobles til, må du kanskje finne IP -adressen som Pi bruker. Det er flere måter å gjøre dette på, men personlig logger jeg bare på ruteren min og sjekker listen over tilkoblede enheter. Når du har funnet IP -en til Pi -typen, skriver du den inn i Host Name -boksen i Putty i stedet for raspberrypi, og prøver å koble til igjen.

Hvis du fortsatt ikke kan koble til, har du kanskje ikke opprettet ssh -filen riktig. Les gjennom de foregående trinnene og dobbeltsjekk alt.

Trinn 6: Valgfritt: Endre vertsnavnet til din Pi

Dette er ikke nødvendig, men jeg foretrekker å ha vertsnavnet til Pi -en min som noe relevant for hva den brukes til i stedet for bare den generiske "raspberrypi". I dette tilfellet kalte jeg det "xyzzypi", men du kan kalle det hva du vil.

Slik endrer du vertstypen:

sudo raspi-config

Velg Nettverksalternativer

Velg Vertsnavn

Skriv inn hvilket vertsnavn du vil

Velg Fullfør

Den vil spørre om du vil starte Pi på nytt nå. Det nye vertsnavnet trer ikke i kraft før du starter på nytt. Hvis du gjør det, vil Putty -økten koble fra. Når den er fullført, må du bruke det nye vertsnavnet du angav for å koble til igjen med Putty. Hvis du koblet til med IP -adressen i stedet for vertsnavnet, bør det fortsatt være det samme.

Det er mange andre alternativer du kan angi ved hjelp av raspi-config-verktøyet, men det er mange opplæringsprogrammer om det online allerede, så jeg skal ikke gå inn på dem her.

Trinn 7: Oppdater applikasjonspakker

Oppdater applikasjonspakkene dine med følgende kommando:

sudo apt-get oppdatering

La den gå til den er ferdig.

Merk: Teknisk trenger du ikke å skrive "apt-get" lenger, du kan bare skrive "apt". Imidlertid er jeg så vant til å skrive "apt-get" at det bare er muskelminne for meg på dette tidspunktet.

Trinn 8: Installer Git

Når applikasjonspakkene er ferdige med å oppdatere installer Git ved å bruke følgende kommando:

sudo apt -get -y installer git

La den gå til den er ferdig.

Trinn 9: Installer Maven

Installer Maven ved å bruke følgende kommando:

sudo apt -get -y install maven

La den gå til den er ferdig

Trinn 10: Last ned late som om du er Xyzzy -serverfiler

Last ned serveren Filer som om du er Xyzzy ved å bruke følgende kommando:

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

Dette vil opprette en katalog på Pi som heter PretendYoureXyzzy og laste ned filene til den.

La den gå til den er ferdig.

Trinn 11: Bytt til PretendYoureXyzzy -katalogen

Bytt til PretendYoureXyzzy -katalogen ved å bruke følgende kommando:

cd late som din xyzzy

Merk: Linux -kommandoer er store og små bokstaver, så cd PretendYoureXyzzy vil fungere, men cd pretendyourexyzzy vil ikke.

Trinn 12: Åpne og rediger "build.properties.example" -filen og lagre den som "build.properties"

Åpne build.properties.example -filen med nano -tekstredigerer ved å bruke følgende kommando:

sudo nano build.properties.example

Å bruke en terminalbasert tekstredigerer kan virke litt skremmende for de som ikke er vant til det, men det vi gjør er veldig enkelt.

Bruk pil ned for å bla ned til du finner seksjonene som sier "dvalemodus.brukernavn" og "dvalemodus.passord".

Bruk høyre piltast for å gå over til slutten av linjene og endre brukernavn og passord til noe annet. Ærlig talt vet jeg ikke om det egentlig er nødvendig, men jeg er ikke komfortabel med å la dem stå på standard brukernavn og passord som de fulgte med.

Når du har endret dem, trykker du på ctrl+o for å åpne dialogboksen for lagring.

Tilbake for å fjerne ".eksemplet" fra slutten av filnavnet, så du sitter igjen med bare "build.properties"

Den vil spørre om du vil lagre filen under et annet navn. Trykk på y for ja.

Trykk ctrl+x for å lukke nano -tekstredigerer.

Trinn 13: Åpne og rediger "pom.xml" -filen (DET ER DET FØR DET KJØR PÅ PI)

Åpne pom.xml -filen med nano -tekstredigerer ved å bruke følgende kommando:

sudo nano pom.xml

Rull nedover som du gjorde før. Denne gangen er linjen du leter etter sqlite-jdbc

Like under denne linjen er det en linje med et versjonsnummer. Du må endre dette tallet til 3.28.0 slik at det ser ut som:

3.28.0

Når du har redigert versjonsnummeret, trykker du på ctrl+o for å åpne dialogboksen for lagring.

Behold filnavnet som "pom.xml" og lagre det.

Når den er lagret, trykk ctrl+x for å lukke nano -tekstredigeringsprogrammet.

Dette er redigeringen som gjør at late som du er Xyzzy -serveren kjører på en Pi. Sqlite-jdbc-versjonen som den kommer med, vil ikke kjøre ordentlig på en Pi. Versjon 3.28.0 fungerer bra i testene mine så langt

Trinn 14: Start opp late som om du er Xyzzy -serveren og sørg for at den fungerer

Nå som du har gjort de nødvendige redigeringene for å kjøre en late som om du er Xyzzy -server på Pi, la oss starte den og se om alt fungerer. Start serveren med følgende kommando:

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

Den vil laste ned noen ekstra filer, kompilere dem og starte serveren. Dette vil trolig ta et par minutter.

Merk: Foreløpig er dette den eneste måten jeg vet hvordan jeg skal få serveren til å kjøre, slik at den vil kompilere hver gang du starter den.

Du vil vite at det er gjort når du får en melding som sier "Konsollinnlasting er AKTIVERT. Trykk ENTER på konsollen for å starte konteksten på nytt."

På dette tidspunktet kan du åpne nettleseren din og skrive inn vertsnavnet (eller IP -adressen) til Pi -porten 8080 på slutten. Så vertsnavn: 8080 eller IP: 8080

Hvis du brukte xyzzypi som vertsnavn, ville det være xyzzypi: 8080 eller i mitt tilfelle å bruke IP ville det være 192.168.1.189:8080

Hvis alt fungerte, vil du bli ført til hovedsiden for late som om du er Xyzzy.

Gratulerer! Du har gjort det

Imidlertid vil den bare kjøre hvis du logger deg på Pi med Putty og kjører kommandoen ovenfor for å starte serveren. Når du lukker Putty, stopper serveren. Dette kan være greit for noen mennesker, men du vil kanskje at late som om du er Xyzzy -serveren skal kjøres automatisk når Pi starter opp eller startes på nytt uten å måtte logge inn. De neste trinnene vil dekke hvordan det fungerer.

Trinn 15: Lag et skript for å starte som om du er Xyzzy -server

Hvis vi vil at late som om du er Xyzzy -serveren starter automatisk når Pi starter eller starter på nytt, er det første vi må gjøre å lage et skript.

Trykk ctrl+c for å stoppe serveren.

Når den stopper skriver du inn følgende kommando:

sudo nano xyzzy.sh

Merk: Jeg kalte skriptet mitt xyzzy.sh, men du kan navngi det hva du vil. Bare sørg for at den har.sh som filtypen.

Bruk nano -tekstredigerertype eller lim inn følgende i filen:

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

Trykk ctrl+o for å åpne dialogboksen for lagring

Lagre filen og trykk ctrl+x for å lukke nano

Trinn 16: Gjør scriptet ditt kjørbart

Vi må gjøre skriptet kjørbart med følgende kommando:

sudo chmod 755 xyzzy.sh

Merk: Hvis du ga skriptet ditt noe annet i forrige trinn, kan du bruke det filnavnet i stedet.

Trinn 17: Opprett en Crontab -oppføring for å kjøre skriptet ditt automatisk ved oppstart

Det er flere måter å få et skript til å kjøre på oppstart. Jeg bruker crontab her.

Rediger crontab -tabellene ved å bruke følgende kommando:

crontab -e

Det kommer til å spørre hvilken redaktør du vil bruke. Skriv 1 og trykk enter for å bruke nano.

Når den åpnes, ruller du helt til bunnen og legger til følgende linje:

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

Merk: Igjen, hvis du brukte et annet filnavn for skriptetypen i stedet.

Trykk ctrl+o for å åpne dialogboksen for lagring.

Lagre og trykk ctrl+x for å lukke nano.

Trinn 18: Start Pi på nytt og se om du kan koble deg til å late som om du er Xyzzy

Nå som du har late som om du er Xyzzy -serveren satt til å kjøre på oppstart, kan du starte Pi på nytt og sørge for at alt fungerer.

Start på nytt med følgende kommando:

sudo omstart

Når Pi starter opp igjen, vil det ta et par minutter å kompilere alt for serveren på nytt. Gi det tid, og prøv deretter å koble til i nettleseren igjen enten ved å bruke vertsnavnet eller IP -en til Pi -tilleggsporten 8080 på slutten.

xyzzypi: 8080 eller IP -adresse: 8080

Hvis alt fungerte, vil du bli ført til siden som om du er Xyzzy.

Gratulerer! Du har nå late som om du er en Xyzzy -server som kjører automatisk på en Raspberry Pi

Trinn 19: Valgfritt: Videresend porter for å gi tilgang til din late som om du er en Xyzzy -server over Internett

Så nå har du en fungerende late som om du er Xyzzy -server, men for øyeblikket er den bare tilgjengelig på ditt lokale nettverk. Dette fungerer fint hvis du har en gruppe venner som skal spille hjemme hos deg, men folk utenfor ditt lokale nettverk ikke kan koble til.

Du må slå opp portvideresendingsinstruksjoner for din spesifikke ruter hvis du ikke allerede vet hvordan. Lat som om du er Xyzzy bruker port 8080, så det er porten du vil videresende. Når du har konfigurert det, vil du kunne gi vennene dine din eksterne IP -adresse og port, og de vil kunne koble til serveren din over internett.

Hvis du ville, kan du også sette opp dynamisk DNS slik at du har din egen URL (noe som JoesPYXserver.noip.com) du kan dele med venner for å koble til serveren din. Det er mange opplæringsprogrammer der ute for den slags ting.