Predstierajte, že ste server Xyzzy na Raspberry Pi: 19 krokov

2024 Autor: John Day | [email protected]. Naposledy zmenené: 2024-01-30 11:57

Táto príručka vám ukáže, ako nastaviť server Predstierajte, že ste Xyzzy (PYX) na Raspberry Pi. Hovorím tomu XyzzyPi

Predstierajte, že ste Xyzzy, je online klon Cards Against Humanity s otvoreným zdrojom, ktorý sa hrá vo webovom prehliadači.

V systéme Android môžete tiež použiť aplikáciu Client for Pretend you're Xyzzy.

Keď som začal skúmať nastavenie vlastného servera PYX, ťažko som našiel pokyny, ktoré neboli zastarané a ktoré bolo ľahké ich dodržať. Zdá sa, že väčšina z nich bola napísaná pre ľudí, ktorí už majú s nastavením servera PYX nejaké skúsenosti. Dokázal som na to prísť, ale chcel som vytvoriť podrobného sprievodcu pre tých, ktorí nie sú tak technicky zdatní, alebo ktorí s takýmito vecami nemajú veľa skúseností. Tiež som nenašiel žiadny návod na jeho spustenie na Raspberry Pi. Po niekoľkých pokusoch a omyloch sa mi podarilo server PYX spustiť na počítači Pi iba s malými úpravami súborov. Dúfam, že to ušetrí nejaký čas tým, ktorí majú záujem.

Urobil som to na zariadení Pi 3 model B+ a Pi 4 modelu B 4 GB. Existuje niekoľko problémov s používaním Pi Zero W, pretože procesor nespracováva správne Java VM. V súčasnej dobe sa snažím, aby to fungovalo na nule W, a ak budem úspešný, aktualizujem pokyny. Nemám Pi 1 alebo 2 na testovanie, takže s nimi to môže, ale nemusí fungovať.

Snažil som sa, aby bol tento návod ľahko použiteľný pre ľudí všetkých úrovní znalostí, aby sa tu mohli nachádzať veci, ktoré už poznáte.

Ak už viete, ako nainštalovať Raspbian a pripojiť sa k svojmu Pi, prejdite na krok 6

Ak máte skúsenosti s nastavením servera PYX a chcete poznať úpravy potrebné na to, aby fungoval na počítači Pi, prejdite na krok 13

Disclaimer: Nevytvoril som Predstierať, že ste Xyzzy alebo klientsku aplikáciu pre Android.

Kredit za vytvorenie predstierania, že ste Xyzzy, patrí používateľovi ajanata GitHub (https://github.com/ajanata/PretendYoureXyzzy)

Kredit za vytvorenie klienta Za predstieranie, že ste Xyzzy, putuje na Gianlu (https://play.google.com/store/apps/dev?id=8675761046824387020)

Ak mi niekto chýbal, dajte mi prosím vedieť.

Zásoby

Hardvér:

Raspberry Pi 3 alebo 4

Karta Micro SD (používam karty micro SD s kapacitou 32 GB, pretože to mám poruke. Pravdepodobne si vystačíte s 2 GB pamäte, ale odporučil by som aspoň 4 GB.)

PC s čítačkou kariet SD (na tento tutoriál používam Windows. Ak používate Linux, veľa z týchto vecí už pravdepodobne poznáte, takže podľa potreby upravte pokyny.)

Softvér:

Obrázok Raspbian: https://www.raspberrypi.org/downloads/raspbian/ (Každý by mal fungovať. V čase písania textu používam Raspbian Buster Lite.)

Win32 Disk Imager: https://sourceforge.net/projects/win32diskimager/ (Existujú aj ďalšie programy, ktoré môžete použiť na flashovanie obrazu Raspbian, ale toto je moja osobná preferencia.)

Tmel:

Krok 1: Flash Raspbian na kartu SD

Pred otvorením programu Win32 Disk Imager vložte kartu SD do čítačky kariet v počítači. Potom vyberte svoj obrázok Raspbian a písmeno jednotky SD a kliknite na „Napísať“.

UPOZORNENIE: Čokoľvek na karte SD bude odstránené a prepísané. Ak sú na karte SD dôležité údaje, najskôr ich zálohujte. Uistite sa tiež, že ste pre kartu SD vybrali správne písmeno jednotky. V opačnom prípade by ste mohli nechtiac vymazať/prepísať nesprávny disk

Po dokončení budete mať na karte SD dve samostatné jednotky. Akonáhle sa nazýva boot a ten, ktorý Windows nemôže čítať. V systéme Windows sa pravdepodobne zobrazí vyskakovacie okno so žiadosťou o naformátovanie karty. Stačí kliknúť na Zrušiť. Ak ho naformátujete, budete musieť znova použiť Raspbian.

Krok 2: Vytvorte textový súbor s názvom „wpa_supplicant.conf“na zavádzacej jednotke

Na zavádzacej jednotke karty SD vytvorte textový súbor s názvom wpa_supplicant.conf a vložte nižšie uvedený kód. Nahraďte „názov siete Wi -Fi“a „heslo“skutočným menom a heslom pre sieť Wi -Fi, úvodzovky však ponechajte okolo nich. Uložte súbor.

To umožní vášmu Pi pripojiť sa k vašej wifi. Ak na pripojenie zariadenia Pi k sieti používate ethernetový kábel, môžete tento krok pravdepodobne preskočiť.

Uistite sa, že je prípona súboru správna. Mal by to byť súbor wpa_supplicant.conf, nie wpa_supplicant.conf.txt

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

sieť = {

scan_ssid = 1 ssid = "názov wifi" psk = "heslo"}

Krok 3: Vytvorte prázdny súbor s názvom „ssh“na zavádzacej jednotke

Na zavádzacej jednotke karty SD vytvorte prázdny súbor s názvom ssh

Nepotrebuje mať v sebe nič, stačí ho len správne pomenovať.

To umožní ssh na vašom Pi, čo vám umožní pripojiť sa k nemu pomocou Putty.

Zaistite, aby bol súbor pomenovaný jednoducho ssh bez prípony. Nie ssh.txt atď

Krok 4: Vysuňte kartu SD z počítača, vložte ju do počítača Pi a zapnite počítač Pi

Vysuňte kartu SD z počítača, vložte ju do počítača Pi a zapnite počítač Pi.

Ak všetko fungovalo, vaše Pi sa spustí a pripojí sa k vášmu wifi.

Počkajte pár minút, kým prejde počiatočným nastavením.

Krok 5: Pripojte sa k svojmu Pi pomocou tmelu

Otvorte Putty a do poľa Host Name napíšte raspberrypi a uistite sa, že typ pripojenia je SSH a port je 22. Ak sa pripojí, dostanete sa na čiernu obrazovku s textom, známym ako terminál. Požiada vás o zadanie používateľského mena a hesla. Predvolené používateľské meno je "pi" a predvolené heslo je "malina". Dôrazne sa odporúča zmeniť heslo, najmä ak plánujete zverejniť svoje Pi na internete. Ak to chcete urobiť, zadajte po prihlásení „passwd“a postupujte podľa pokynov. Nezabudnite si vybrať heslo, ktoré si zapamätáte.

Ak sa nepripojí, možno budete musieť nájsť IP adresu, ktorú používa váš Pi. Existuje niekoľko spôsobov, ako to urobiť, ale osobne sa prihlásim do svojho smerovača a skontrolujem zoznam pripojených zariadení. Akonáhle nájdete adresu IP vášho typu Pi, ktorú zadáte do poľa Názov hostiteľa v aplikácii Putty, namiesto raspberrypi, a skúste sa znova pripojiť.

Ak sa stále nemôžete pripojiť, je možné, že ste súbor ssh nevytvorili správne. Prečítajte si predchádzajúce kroky a všetko dôkladne skontrolujte.

Krok 6: Voliteľné: Zmeňte názov hostiteľa svojho Pi

Nie je to potrebné, ale dávam prednosť tomu, aby názov hostiteľa môjho Pi bol niečím relevantným pre to, na čo sa používa, a nie iba všeobecnými „raspberrypi“. V tomto prípade som to nazval „xyzzypi“, ale môžete to nazvať, ako chcete.

Ak chcete zmeniť typ názvu hostiteľa:

sudo raspi-config

Vyberte položku Možnosti siete

Vyberte položku Názov hostiteľa

Zadajte ľubovoľný názov hostiteľa, ktorý chcete

Vyberte položku Dokončiť

Zobrazí sa otázka, či by ste teraz chceli reštartovať Pi. Nové meno hostiteľa nezačne platiť, kým nereštartujete. Ak tak urobíte, relácia Putty sa odpojí. Akonáhle je reštartovanie dokončené, budete musieť použiť nové meno hostiteľa, ktoré ste nastavili na opätovné pripojenie k Putty. Ak ste sa pripájali pomocou adresy IP namiesto názvu hostiteľa, malo by to byť stále rovnaké.

Existuje mnoho ďalších možností, ktoré môžete nastaviť pomocou nástroja raspi-config, ale o tom je už online veľa návodov, takže sa tu o nich nebudem zaoberať.

Krok 7: Aktualizujte svoje balíky aplikácií

Aktualizujte svoje balíky aplikácií pomocou nasledujúceho príkazu:

sudo apt-get aktualizácia

Nechajte bežať, kým nebude hotový.

Poznámka: Technicky už nemusíte písať „apt-get“, stačí napísať „apt“. Som však taký zvyknutý písať „apt-get“, že je to pre mňa v tejto chvíli len svalová pamäť.

Krok 8: Nainštalujte Git

Akonáhle sú balíky aplikácií aktualizované, nainštalujte Git pomocou nasledujúceho príkazu:

sudo apt -get -y install git

Nechajte bežať, kým sa neskončí.

Krok 9: Nainštalujte Maven

Nainštalujte Maven pomocou nasledujúceho príkazu:

sudo apt -get -y install maven

Nechajte bežať, kým sa neskončí

Krok 10: Stiahnite si predstierané súbory servera Xyzzy

Stiahnite si súbory servera Predstierajte, že ste Xyzzy, pomocou nasledujúceho príkazu:

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

Na vašom počítači Pi sa vytvorí adresár s názvom PretendYoureXyzzy a stiahne sa doň súbory.

Nechajte bežať, kým sa neskončí.

Krok 11: Prejdite do adresára PretendYoureXyzzy

Prejdite do adresára PretendYoureXyzzy pomocou nasledujúceho príkazu:

cd PretendYoureXyzzy

Poznámka: Príkazy Linux rozlišujú veľké a malé písmena, takže cd PretendYoureXyzzy bude fungovať, ale cd pretendyourexyzzy nebude.

Krok 12: Otvorte a upravte súbor „build.properties.example“a uložte ho ako „build.properties“

Otvorte súbor build.properties.example v nano textovom editore pomocou nasledujúceho príkazu:

sudo nano build.properties.example

Používanie textového editora založeného na termináloch sa môže zdať trochu zastrašujúce pre tých, ktorí na to nie sú zvyknutí, ale to, čo robíme, je veľmi jednoduché.

Pomocou klávesu so šípkou nadol sa posuňte nadol, kým nenájdete sekcie, ktoré hovoria „hibernate.username“a „hibernate.password“.

Pomocou klávesu so šípkou doprava sa presuňte na koniec týchto riadkov a zmeňte používateľské meno a heslo na niečo iné. Úprimne povedané, neviem, či je to skutočne nevyhnutné, ale nie je mi príjemné nechať ich na predvolenom používateľskom mene a hesle, ktoré s nimi prišli.

Keď ich zmeníte, stlačením klávesov ctrl+o vyvoláte dialógové okno na uloženie.

Backspace na odstránenie „.example“z konca názvu súboru, takže vám zostane iba „build.properties“

Zobrazí sa otázka, či chcete súbor uložiť pod iným názvom. Áno, stlačte y.

Stlačením klávesov ctrl+x zatvorte nano textový editor.

Krok 13: Otvorte a upravte súbor „pom.xml“(TAKTO SA SPÚŠŤA NA PI)

Otvorte súbor pom.xml v nano textovom editore pomocou nasledujúceho príkazu:

sudo nano pom.xml

Prejdite nadol, ako ste urobili predtým. Tentoraz je riadok, ktorý hľadáte, sqlite-jdbc

Hneď pod týmto riadkom je riadok s číslom verzie. Toto číslo musíte zmeniť na 3,28,0, aby vyzeralo takto:

3.28.0

Keď ste upravili číslo verzie, stlačením klávesov ctrl+o zobrazte dialógové okno na uloženie.

Ponechajte názov súboru ako "pom.xml" a uložte ho.

Akonáhle je uložený, stlačením ctrl+x zatvorte nano textový editor.

Toto je úprava, kvôli ktorej server Predstierajte, že ste Xyzzy, beží na Pi. Verzia sqlite-jdbc, ktorá sa dodáva, nebude správne fungovať na počítači Pi. Verzia 3.28.0 v mojich testoch zatiaľ funguje skvele

Krok 14: Spustite predstieraný server Xyzzy a uistite sa, že funguje

Teraz, keď ste vykonali potrebné úpravy na spustenie servera Predstierajte, že ste Xyzzy na vašom Pi, spustime ho a uvidíme, či všetko funguje. Spustite server pomocou nasledujúceho príkazu:

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

Stiahne niektoré ďalšie súbory, skompiluje ich a spustí server. Bude to pravdepodobne trvať niekoľko minút.

Poznámka: V súčasnej dobe je to jediný spôsob, ako viem, aby bol server spustený, takže sa bude kompilovať pri každom spustení.

Budete vedieť, že je to hotové, keď sa vám zobrazí správa „Opätovné načítanie konzoly je ZAPNUTÉ. Kontext reštartujete stlačením klávesu ENTER na konzole.“

V tomto mieste môžete otvoriť prehliadač a na konci napísať názov hostiteľa (alebo IP adresu) portu 8080 na pridanie Pi. Takže názov hostiteľa: 8080 alebo IP: 8080

Ak by ste ako názov hostiteľa použili xyzzypi, bolo by to xyzzypi: 8080 alebo v mojom prípade pomocou IP by to bolo 192.168.1.189:8080

Ak všetko fungovalo, dostanete sa na hlavnú stránku Predstierajte, že ste Xyzzy.

Gratulujem Dokázali ste to

Práve teraz sa však spustí, iba ak sa prihlásite do svojho Pi pomocou Putty a spustíte príkaz vyššie na spustenie servera. Akonáhle zatvoríte Putty, server sa zastaví. To môže byť pre niektorých ľudí v poriadku, ale možno budete chcieť, aby sa server Predstierať, že ste Xyzzy, spustil automaticky vždy, keď sa Pi spustí alebo reštartuje bez toho, aby ste sa museli prihlasovať. Nasledujúce kroky sa zamerajú na to, aby to fungovalo.

Krok 15: Vytvorte skript, aby ste predstierali, že ste server Xyzzy

Ak chceme, aby sa server Predstierať, že ste Xyzzy, automaticky spustil pri štarte alebo reštarte Pi, prvá vec, ktorú musíme urobiť, je vytvoriť skript.

Server zastavíte stlačením klávesov ctrl+c.

Akonáhle sa zastaví, zadajte nasledujúci príkaz:

sudo nano xyzzy.sh

Poznámka: Svoj skript som pomenoval xyzzy.sh, ale môžete ho pomenovať, ako chcete. Len sa uistite, že má príponu.sh.

Pomocou nano textového editora zadajte alebo prilepte do súboru nasledujúce položky:

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

Stlačením ctrl+o vyvoláte dialógové okno na uloženie

Uložte súbor a stlačením klávesov ctrl+x zatvorte nano

Krok 16: Vytvorte spustiteľný skript

Skript musíme urobiť spustiteľným pomocou nasledujúceho príkazu:

sudo chmod 755 xyzzy.sh

Poznámka: Ak ste v predchádzajúcom kroku skript pomenovali inak, použite namiesto neho tento názov súboru.

Krok 17: Vytvorte záznam Crontab na automatické spustenie skriptu pri zavádzaní

Existuje niekoľko spôsobov, ako spustiť skript pri spustení. Tu používam crontab.

Tabuľky crontab upravte pomocou nasledujúceho príkazu:

crontab -e

Opýta sa vás, ktorý editor chcete použiť. Ak chcete použiť nano, napíšte 1 a stlačte kláves Enter.

Akonáhle sa otvorí, posuňte sa úplne nadol a pridajte nasledujúci riadok:

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

Poznámka: Ak ste pre svoj typ skriptu použili iný názov súboru, znova.

Dialógové okno pre uloženie zobrazíte stlačením klávesov ctrl+o.

Uložte a stlačením klávesov ctrl+x zatvorte nano.

Krok 18: Reštartujte počítač Pi a zistite, či sa môžete pripojiť, aby ste predstierali, že ste Xyzzy

Teraz, keď máte server Predstieraný, že ste Xyzzy nastavený na spustenie pri štarte, môžete reštartovať Pi a uistiť sa, že všetko funguje.

Reštartujte počítač pomocou nasledujúceho príkazu:

sudo reštart

Akonáhle sa Pi spustí, bude trvať niekoľko minút, kým sa všetko znova prekomplikuje na server. Nechajte tomu čas a potom sa skúste znova pripojiť v prehliadači buď pomocou názvu hostiteľa, alebo IP portu 8080 na konci pridávania.

xyzzypi: 8080 alebo IPadresa: 8080

Ak všetko fungovalo, dostanete sa na stránku Predstierajte, že ste Xyzzy.

Gratulujem Teraz máte server Predstierajte, že ste Xyzzy, ktorý beží automaticky na Raspberry Pi

Krok 19: Voliteľné: Preposielajte porty, aby ste mali prístup k svojmu predstieranému serveru Xyzzy cez internet

Takže teraz máte fungujúci server Predstierajte, že ste Xyzzy, ale v súčasnosti je prístupný iba vo vašej lokálnej sieti. To funguje dobre, ak máte doma skupinu priateľov, ale ľudia mimo vašej lokálnej siete sa nebudú môcť pripojiť.

Ak ešte neviete ako, budete si musieť vyhľadať pokyny na presmerovanie portov pre konkrétny smerovač. Predstierajte, že ste Xyzzy, používa port 8080, takže to je port, ktorý chcete poslať ďalej. Akonáhle to budete mať nastavené, budete môcť svojim priateľom poskytnúť externú IP adresu a port a budú sa môcť pripojiť k vášmu serveru cez internet.

Ak by ste chceli, mohli by ste tiež nastaviť dynamický DNS, aby ste mali svoju vlastnú URL (niečo ako JoesPYXserver.noip.com), ktorú rozdávate priateľom na pripojenie k vášmu serveru. Existuje už veľa návodov na takéto veci.