Dokumentation
Fügen Sie "Hosts"-Eintrag auf Ihrem lokalen PC hinzu
Kontext & Überblick
Beachten Sie, dass diese Anweisungen für jedes mit dem Netzwerk verbundene Gerät mit einer gültigen IP relevant sind - nicht nur für TurnKey-Server.
Einige TurnKey Linux-Server erfordern die Einrichtung einer Domain. WordPress, Mediawiki, etc. erwarten, dass die Domain auf die IP-Adresse Ihres Servers aufgelöst wird. DNS-Datensatz.
Das Hinzufügen eines Hosts-Dateieintrags ist eine Möglichkeit, über einen Domainnamen auf einen Server zuzugreifen, ohne DNS-Einträge konfigurieren zu müssen. Wenn Ihr PC versucht, eine Verbindung zu einer Domäne herzustellen, liest er zuerst die Hosts-Datei. Wenn die gewünschte Domäne in der Hosts-Datei gefunden wird, wird die angegebene IP verwendet.
Beschränkungen
Es gibt eine Reihe von Einschränkungen, wenn Sie einen Hosteintrag verwenden, um nach Domäne auf Ihren Server zuzugreifen:
- Jeder PC, von dem aus Sie auf Ihren TurnKey-Server zugreifen können möchten, muss einen Hosteintrag hinzugefügt haben.
- Der Administratorzugriff auf Ihren lokalen PC ist erforderlich, um die Hosts-Datei zu bearbeiten.
- Server statische IP ist sehr wünschenswert - ohne statische IP muss die Hosts-Datei jedes Mal aktualisiert werden, wenn sich Ihre Server-IP ändert.
Es ist auch erwähnenswert, wenn eine Domain mit einem Host-Eintrag übereinstimmt, wird keine DNS-Anfrage gestellt. Wenn Sie also eine Domain nicht explizit blockieren/überschreiben möchten, verwenden Sie nur Site-spezifische Domains - nicht "echte". Andernfalls, wenn Sie vergessen, dass Sie einen Host-Eintrag gemacht haben, kann die Fehlersuche bei einem Verbindungsproblem auf der Strecke eine ganze Welt des Schmerzes sein! Eine gute Site-spezifische Domain könnte "mediawiki.home.lan" sein; eine schlechte Domain wäre "mediawiki.turnkeylinux.org" (sie existiert nicht, aber vielleicht könnte sie in Zukunft).
Statische IP für Server einstellen
Die Verwendung einer statischen IP für Ihren Server ist nicht erforderlich, aber wie oben erwähnt, ist es sehr wünschenswert. Wenn Sie noch nicht eingerichtet haben und möchten, hängt dies von der Plattform ab, auf der Sie TurnKey ausführen:
Cloud AWS Server - gestartet von der TurnKey Hub oder AWS Marketplace
Fügen Sie Ihrem Server eine "elastische IP" über die AWS-Konsole hinzu. Nicht eine statische IP innerhalb des Servers selbst einstellen - AWS-Server sollten immer Holen Sie sich ihre IP von AWS DHCP!
LXC Container - z.B. auf Proxmox
Es wird empfohlen, die statische Server-IP auf dem Proxmox-Host zu setzen - nicht innerhalb des Servers selbst.
VM & Bare Metal
Confconsole (>> Fortgeschrittene >>> Vernetzung), Webmin (https auf Port 12321) oder manuell über CLI.
Standort der Hosts-Datei
Windows
C:\Windows\System32\drivers\etc\hosts
Linux und MacOSX
/etc/hosts
Open Hosts File zum Bearbeiten
Öffnen Sie zunächst die Hosts-Datei in Ihrem bevorzugten Texteditor. muss Ein Editor, der Text formatiert - z.B. ein Textverarbeitungsprogramm - wird Ihre Hosts-Datei zerstören!
Windows
Windows Notepad ist eine gängige und vernünftige Option zum Bearbeiten von Klartextdateien.
Klicken Sie mit der rechten Maustaste auf Ihre Texteditor-Anwendung (z.B.) Notepad) und "Als Administrator ausführen" auswählen. Dann kopieren/einfügen Sie entweder "C:\Windows\System32\drivers\etc\hosts" in der Adressleiste - oder durchsuchen Sie diesen Standort über die Texteditoren Dialogfeld "Öffnen".
Linux und MacOSX
Auf nix Systemen (Linux, OSX, etc.) ist es oft am einfachsten, den bevorzugten CLI Texteditor innerhalb eines Terminals zu verwenden.
Starten Sie Ihren Texteditor in einem Terminal als sudo-Benutzer (oder als root), z.B. mit Nano:
sudo nano /etc/hosts
Neue Zeile zur Hosts-Datei hinzufügen
Sobald Sie die Hosts-Datei zum Bearbeiten geöffnet haben, fügen Sie eine neue Zeile mit einem Format wie diesem hinzu:
<IP_ADDRESS> <DOMAIN_NAME>
Z.B. um 'mediawiki.home.lan' auf die IP-Adresse '192.168.1.100' zu verweisen - fügen Sie eine neue Zeile hinzu:
192.168.1.100 mediawiki.home.lan
Speichern Sie schließlich Ihre aktualisierte Hosts-Datei und verlassen Sie den Texteditor.
Testen Sie Ihre Domain
Nach dem Hinzufügen des Hosts-Eintrags sollte die Auflösung Ihrer Domain zur angegebenen IP "einfach funktionieren". Aber um sicher zu gehen, lohnt es sich, dies über ein Terminal zu überprüfen. cmd.exe unter Windows) und Ping verwenden, z. B.:
ping mediawiki.home.lan
Wenn Sie Ergebnisse erhalten, die die Domain und die IP-Adresse Ihres Servers angeben, dann sind Sie gut dran. Wenn es eine Fehlermeldung gibt, dann überprüfen Sie, ob Sie eine Verbindung zur IP herstellen können, indem Sie sie anpingen. z.B.:
ping 192.168.1.100
Wenn das nicht funktioniert, dann überprüfen Sie, ob Sie die IP des Servers korrekt haben. Eine andere Sache, die Sie überprüfen sollten, ist, dass die Vernetzung (Ihres PCs und / oder Ihres Servers) korrekt konfiguriert ist.
Schlusswort
Wenn Sie mit Ihrer Domain zufrieden sind, sie zu Ihrer Host-Datei hinzugefügt haben und sich mit Ihrem Server verbinden können, dann ist das so ziemlich alles.
Domain auf dem TurnKey Server aktualisieren
Wenn Sie die Domain bereits auf Ihrem TurnKey-Server eingestellt haben, bevor Sie dies gelesen haben, und diese ändern möchten, können Sie dies tun, indem Sie den Server neu initialisieren. Offensichtlich muss die Domain in Ihrer Hosts-Datei mit der neuen Domain übereinstimmen.
Wenn Sie bereits mit dem Hinzufügen von Inhalten/Daten zu Ihrem Server begonnen haben, bevor Sie die Neuinitialisierung durchführen, führen Sie zunächst ein Backup durch (z.B. TKLBAMWir versuchen sicherzustellen, dass unsere Initialisierungsskripte idempotent sind (d.h. sicher wiederholt werden können), aber es kann einen Edge-Fall geben, den wir nicht berücksichtigt haben. Bitte melden Sie alle Bugs oder unerwartetes Verhalten über unsere Foren oder unsere konsolidierte Issue Tracker.
Reinitialisierung
Sie können den Befehl 'turnkey-init' verwenden, um eine vollständige Reinitialisierung durchzuführen, die das Zurücksetzen der Domäne sowie aller anderen Server-Konfigurationen beinhaltet. Sie müssen alle initialisierungsfragen erneut beantworten, obwohl es in ordnung ist, dasselbe zu verwenden, wie sie es beim ersten mal getan haben (erwarten sie natürlich domain).
turnkey-init
Wenn Sie die Hauptanwendung zum Aktualisieren der Domäne einfach nur neu initialisieren möchten, können Sie das anwendungsspezifische Initialisierungsskript direkt ausführen. Die einzelnen Skripte werden in Python mit einer .py-Dateierweiterung geschrieben und befinden sich in /usr/lib/inithooks/bin. Als allgemeine Regel gilt, dass der Name des anwendungsspezifischen Init-Skripts mit der Anwendung übereinstimmt, so dass er normalerweise erraten werden kann. Wenn Sie den Namen ausdrücklich prüfen möchten, listen Sie alle Dateien im entsprechenden Verzeichnis auf:
ls -l /usr/lib/inithooks/bin/*.py
Führen Sie das Skript mit dem vollständigen Pfad aus.
/usr/lib/inithooks/bin/wordpress.py