From e4bc911e49c6b004cc9bf3f510890c44fc0aef21 Mon Sep 17 00:00:00 2001 From: bedaka Date: Sat, 2 Oct 2021 14:55:02 +0200 Subject: [PATCH] =?UTF-8?q?Setup=20Guide=20hinzugef=C3=BCgt?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 65 ++++++++++++++++++++++++++++++++++++++- utils/wpa_supplicant.conf | 13 ++++++++ 2 files changed, 77 insertions(+), 1 deletion(-) create mode 100644 utils/wpa_supplicant.conf diff --git a/README.md b/README.md index c6c33d7..2fc888b 100644 --- a/README.md +++ b/README.md @@ -5,7 +5,7 @@ Sammlung der Inhalte und Präsentation für das Thema PiHole auf der KEW 2021 ## ToDo -* [ ] Talk bei KEW anmelden +* [x] Talk bei KEW anmelden - [ ] Veranstaltungstext ausformulieren - [ ] Sollen wir den Vortrags-Teil hybrid machen oder nur für Anwesende? @@ -43,3 +43,66 @@ Sammlung der Inhalte und Präsentation für das Thema PiHole auf der KEW 2021 * Pros / Features (Vergleich Ladezeiten von Websites?) * Downsides / Was sollte beachtet werden? 5. Praktischer Teil + + +Part 1: Ein Betriebssystem auf dem Pi installieren und eine Verbindung aufbauen. + +1. Das Image mit dem Betriebssystem herunterladen (wir verwenden Raspberry OS light). +2. Image auf SD karte schreiben (Zum Beispiel mit edger oder rpi-imager). Von dieser + SD Karte wird dann der Raspberry Pi gestartet. +3. Bevor wir die SD Karte in den Pi Stecken und booten konfigurieren wir noch den + Zugang zum WLAN, damit wir uns direkt von unserem Computer mit Pi verbinden können + Hierfür die folgenden Schritte auf der SD Karte durchführen: + 3.1. Unter /boot/ eine Datei mit dem Namen "wpa_supplicant.conf" anlegen. Den + Inhalt findest du hier: `link`. + 3.2. Ebenfalls unter /boot/ eine leere Datei mit dem namen "ssh" erstellen (Keine + Dateiendung wie .txt). hierfür könnt ihr auf unix systemen mit einfach `touch ssh` + ausführen. +4. Die SD Karte in den Pi stecken und an den Strom anschließen. Der Pi booted jetzt. +5. In diesem Schritt verbindest du dich von deinem Computer per SSH (secure shell) + mit dem Pi. Hierfür muss sich dein Computer im gleichen WLan befinden. SSH ermöglicht + dir aus dem Terminal heraus befehle auf deinem PI auszuführen und so Dienste zu starten + oder Dateien zu lesen/verändern. + + 5.1. Um uns per SSH mit dem Pi zu verbinden benötigen wir zuerst dessen IP, also die Adresse + im lokalen Netzwerk. Auf Unix hilft hier das Tool nmap. In einem Terminal + `sudo nmap -sn 192.168.0.1/24` ausführen (-sn steht für scan network) gibt eine Liste aller + hosts im Netzwerk zurück. Alternativ könnt ihr euch auch mit eurem Router verbinden und + eine Liste aller verbundenen Geräte anzeigen lassen. + Ouput könnte zum Beispiel so aussehen: + > Nmap scan report for pi.hole (192.168.0.11)
+ > Host is up (0.10s latency).
+ > MAC Address: A1:22:CC:44:D5:6E (Raspberry Pi Foundation) + + Uns interessiert hier die IP *192.168.0.11* + + 5.2. Zeit uns mit dem PI zu verbinden! In einem Terminal auf eurem PC gibst du: + `ssh pi@` ein, um die SSH verbindung aufzubauen. + Bei der frage ob der Fingerprint hinzugefügt werden soll antworten. + wenn jetzt eine Warnung kommt "known host" **Das noch ausführen** + + 5.3. `raspberry` als password eingeben + +**Herzlichen Glückwunsch** du hast jetzt ein Betriebsystem auf deinem Pi eingerichtet +und kannst diesen von deinem Computer aus steuern + -> gib `pwd` ein, um dir den Pfad ausgeben zu lassen auf dem du dich mit dem Terminal + jetzt auf dem Pi befindest. + + +Part 2: Das System updaten und PiHole installieren +1. Als erstes solltest du dein System updaten. Wie bei allen Linux Distributionen die auf + Debian basieren (Ubuntu etc.), updatest du die Packetquellen mit `sudo apt update` und + installierst die anschließen die neusten Versionen mit `sudo apt upgrade`. +2. Als nächstes laden wir die Pi-Hole Software herunter und installieren diese. + **Leider bietet PiHole derzeit keine Installation über die offiziellen Packetquellen an. Bei unbekannten Quellen sollte das pipen von curl nach bash immer vermieden werden.** + `curl -sSL https://install.pi-hole.net | sudo bash` +3. `sudo apt install ` + +abhängig davon ob ihr den pi im wlan oder am kabel habt wählt ihr eth oder wlan als interface + +select upstream dns provider: hier könnt ihr den DNS eurer wahl auswählen. wir nehmen erstmal quad9. Später erklären wir außerdem wie ihr euren eigenen rkursiven DNS einrichten könnt. + +/etc/dhcpcd.conf +hier kann die example static ip configuration verwendet werden. einfach die entsprechenden zeilen auskommentieren ("#" entfernen) und durch die IP adresse des pis ersetzen. diese kann mit dem command `ifconfig` ermittelt werden. + +-mukgKkr \ No newline at end of file diff --git a/utils/wpa_supplicant.conf b/utils/wpa_supplicant.conf new file mode 100644 index 0000000..62cd0cb --- /dev/null +++ b/utils/wpa_supplicant.conf @@ -0,0 +1,13 @@ +ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev +update_config=1 +country=DE + +network={ + scan_ssid=1 + ssid="" + psk="" + proto=RSN + key_mgmt=WPA-PSK + pairwise=CCMP + auth_alg=OPEN +} \ No newline at end of file