$ USD
So erstellen Sie einen alt:V-Server (2025-Kurzanleitung)
Möchten Sie Ihre eigene GTA V Multiplayer-Welt hosten mit alt:V? Diese Anleitung zeigt Ihnen zwei zuverlässige Setup-Pfade (Windows & Linux), gibt Ihnen eine saubere server.toml, eine erste funktionierende JavaScript-Ressource, Firewall/Ports und ein optionaler systemd-Dienst, sodass Sie schnell von Null auf einen öffentlichen, in der Masterliste aufgeführten Server wechseln können.
Was du brauchst
- Eine legitime Kopie von GTA V (Spieler benötigen dies, der Server nicht).
- Windows 10/11 oder Ubuntu 22.04+ (oder jedes aktuelle x64-Linux).
- Grundlegende Terminal-/PowerShell-Kenntnisse.
alt:V-Server sind eigenständig; Sie installieren GTA nicht auf dem Server.
Ordnerlayout (wir erstellen das)
altv-server/ ├─ altv-server.exe (Windows) oder altv-server (Linux) ├─ libnode.dll / libnode.so ├─ server.toml ├─ package.json ← legt ESM (Typ: Modul) für JS-Ressourcen fest └─ resources/ └─ example/ ├─ resource.toml ├─ server.mjs └─ client/ └─ client.mjs
Option A – Schnellstart (Windows & Linux) mit altv-pkg
Dadurch werden die neuesten offiziellen Binärdateien für Sie abgerufen.
- Erstellen Sie ein Arbeitsverzeichnis
mkdir altv-server && cd altv-server
- Knoten initialisieren (nur für Werkzeuge)
npm init -y npm i --save-dev altv-pkg
- Server-Binärdateien herunterladen
NPX Altv-Paket-Version
Wiederholung
NPX Altv-Paket-Versionjederzeit, wenn Sie aktualisieren möchten.
Option B – Manuelle Installation
- Laden Sie die Server Build von der offiziellen alt:V-Downloadseite (wählen Sie Windows oder Linux).
- Extrahieren in
altv-server/.
Erstellen Paket.json (oberste Ebene)
Dies ermöglicht ESM Syntax (importieren ...) für Ihre JS-Ressourcen.
{ "Name": "altv-server", "privat": wahr, "Typ": "Modul" }
Minimal server.toml
Erstellen server.toml im Serverstamm:
# Angezeigter Name im alt:V-Clientname = „Mein alt:V-Server“ # An alle Schnittstellen binden Host = „0.0.0.0“ # Standard-Spielport (TCP & UDP) Port = 7788 # Spielerplätze Spieler = 128 # Auf Masterliste anzeigen? (für öffentlich auf „true“ setzen) Announce = „true“ # Token vom alt:V-Dashboard abrufen und hier einfügen, wenn öffentlich gemacht # Token = „IHR_MASTERLIST_TOKEN“ # JS-Modul und unser Beispiel laden Ressourcenmodule = [„js-Modul“] Ressourcen = [„Beispiel“] # Hilfreich bei der Entwicklung Debug = „true“ LogStreams = [„Konsole“, „Datei“]
Tipp: Anschlüsse bei Verwendung extern Die Voice-Ports sind typischerweise 7798 (Server) und 7799 (Client). Öffnen Sie diese Ports nur, wenn Sie den Voice-Server separat betreiben. Die grundlegende In-Process-Voice benötigt nur Ihren Game-Port.
Ihre erste Ressource (JavaScript)
Erstellen Ressourcen/Beispiel/Ressource.toml:
# Serverseitige Sprache für diesen Ressourcentyp = "js" # Clientseitige Sprache für diese Ressource Clienttyp = "js" # Eintragsdateien main = "server.mjs" Client-main = "client/client.mjs" # Dateien, die der Client herunterladen kann Clientdateien = [ "client/*", ]
Ressourcen/Beispiel/Server.mjs
importiere * als Alt von „Alt-Server“; alt.on(„playerConnect“, (Player) => { alt.log(`+ ${player.name} verbunden`); player.emit(„welcome:notify“, „Willkommen bei ${alt.getServerConfig().name}!“`); }); alt.on(„playerDisconnect“, (Player, Grund) => { alt.log(`- ${player?.name ?? „unbekannt“} übrig (${Grund})`); });
Ressourcen/Beispiel/Client/Client.mjs
importiere * als alt von 'alt-client'; alt.onServer('welcome:notify', (msg) => { alt.log(`Server sagt: ${msg}`); // Einfacher Hilfetext auf dem Bildschirm alt.everyTick(() => { alt.drawText2d(msg, 0.5, 0.9, 0.5, 255, 255, 255, 255, 0, true, true, 0); }); // Nach ~8 Sekunden entfernen alt.setTimeout(() => alt.clearEveryTick(), 8000); });
Das ist eine vollständige Ressource. Wenn ein Spieler eine Verbindung herstellt, erhält er einen Willkommenstext.
Starten Sie den Server
Windows (PowerShell)
cd C:\Pfad\zum\altv-server ./altv-server.exe
Linux
cd /opt/altv-server # oder Ihr Pfad chmod +x altv-server ./altv-server
Wenn der Start sauber ist, werden Protokolle angezeigt und der Server ist erreichbar unter Ihre IP:7788. Beitritt über den alt:V-Client (Direct Connect) oder über die Masterliste (falls ankündigen = wahr und eine gültige Zeichen ist eingestellt).
Öffnen Sie die Firewall
Windows (PowerShell, als Administrator ausführen)
New-NetFirewallRule -DisplayName "altV 7788 TCP" -Direction Inbound -Protocol TCP -LocalPort 7788 -Action Allow New-NetFirewallRule -DisplayName "altV 7788 UDP" -Direction Inbound -Protocol UDP -LocalPort 7788 -Action Allow
Linux (UFW)
Sudo ufw erlauben 7788/tcp Sudo ufw erlauben 7788/udp
Bei Verwendung eines extern Sprachserver, auch erlauben
7798/udpUnd7799/udp.
(Optional) Führen Sie alt:V als Dienst unter Linux aus
Erstellen /etc/systemd/system/altv.service:
[Einheit] Beschreibung=alt:V Server After=network.target [Dienst] Benutzer=altv WorkingDirectory=/opt/altv-server ExecStart=/opt/altv-server/altv-server --port 7788 Neustart=bei Fehler [Installieren] WantedBy=multi-user.target
Aktivieren und starten:
sudo systemctl daemon-reload sudo systemctl enable --now altv journalctl -u altv -f
Lebensqualität für Entwicklung
- Debug-Modus: halten
debug = wahrwährend des Erstellens; für die Produktion ausschalten. - Knoteninspektor (Server-JS): füge dies hinzu zu
Ressourcen/Beispiel/Ressource.tomlwenn Sie serverseitiges Debuggen benötigen:[js-Modul] Inspektor = wahrFügen Sie dann Chrome DevTools → Knotenziel hinzu. - Typoskript: fügen Sie ein
tsconfig.json, kompilieren zuEntfernung/und Punkthauptsächlich/Client-Hauptzu kompilierten Dateien. Installationstypen:npm i -D @altv/types-server @altv/types-client.
Aktualisierung und Sicherung
- Binärdateien aktualisieren: Wiederholung
NPX Altv-Paket-Version(Option A) oder laden Sie die ZIP-Datei erneut herunter (Option B). - Backups: Reißverschluss
Ressourcen/,server.tomlund alle Datenbank-/externen Konfigurationen. Automatisieren Sie mit einem Cron oder einer geplanten Aufgabe.
Checkliste zur Produktionshärtung
- Setzen Sie eine starke
ZeichenUndankündigen = wahrfür die Masterliste. - Halten
debug = falschin der Produktion. - Verwenden
logStreams = ["Datei"]in der Produktion und rotieren Sie Protokolle bei Bedarf extern. - Geben Sie nur die benötigten Ports frei (7788; 7798/7799 bei externer Sprache).
- In Betracht ziehen
useCdn = wahrfür große Downloads; generieren Sie Pakete mit--justpackund über HTTPS bereitgestellt. - Überwachen mit einem Watchdog (systemd
Neustart=bei Fehler) und richten Sie Benachrichtigungen ein.
Fehlerbehebung (schnelle Lösungen)
- Server kann nicht in der Liste angezeigt werden: sicherstellen
ankündigen = wahr, gültigZeichen, öffnen Sie 7788 TCP/UDP auf dem Host Und Router/NAT; warten Sie einige Minuten auf die Ausbreitung. - Clients bleiben beim Download hängen: Wenn Sie große Vermögenswerte hinzugefügt haben, bedenken Sie
useCdn = wahrund Verpackung (--justpack). - Bereits verwendete Ports: wählen Sie eine andere
HafenInserver.tomloder beenden Sie den in Konflikt stehenden Dienst. - Beim Verbinden passiert nichts: Bestätigen Sie, dass die Ressourcennamen übereinstimmen
Ressourcen = ["Beispiel"]und Ihr Ordner befindet sich unterRessourcen/Beispiel.
FAQ – alt:V-Server
Muss GTA V auf dem Servercomputer installiert sein?
Nein. Nur Spieler benötigen eine gültige GTA V-Kopie. Der Server selbst läuft ohne installiertes Spiel.
Welche Betriebssysteme werden für das Hosting von alt:V unterstützt?
Windows 10/11 und moderne Linux-Distributionen (Ubuntu 22.04+ oder jedes aktuelle x64-Linux) werden unterstützt.
Welche Ports müssen geöffnet sein, damit alt:V funktioniert?
Standardmäßig ist der TCP/UDP-Port 7788 muss geöffnet sein. Wenn Sie einen externen Sprachserver betreiben, öffnen Sie auch 7798/UDP Und 7799/UDP.
Warum wird mein Server nicht in der Masterliste angezeigt?
Stellen Sie sicher, dass Sie ankündigen = wahr, fügte eine gültige Masterlisten-Token, und 7788 TCP/UDP durch Ihre Firewall und Ihren Router zugelassen. Es kann einige Minuten dauern, bis die Auflistung verbreitet wird.
Wie aktualisiere ich die Server-Binärdateien?
Wenn Sie die Installation über altv-pkg, führen Sie einfach Folgendes aus:
NPX Altv-Paket-Version
Wenn Sie die Installation manuell durchgeführt haben, laden Sie den neuesten Build von der offizielle alt:V-Downloadseite.
Kann ich den Server als Hintergrunddienst ausführen?
Ja. Unter Linux können Sie eine systemd Service (altv.service), um automatisch zu starten und bei einem Fehler neu zu starten.
Wie mache ich meinen Server für die Produktion sicherer?
- Deaktivieren
debuggenModus. - Satz
logStreams = ["Datei"]. - Verwenden Sie ein starkes Masterlist-Token.
- Nur erforderliche Ports freigeben.
- Automatisieren Sie Backups für Ressourcen und Konfigurationen.
Wo finde ich weitere Ressourcen für meinen Server?
Der offizielle alt:V Hub und die GitHub-Community-Repositories enthalten viele Beispielressourcen. Sie können auch Anleitungen auf FiveMX zur Optimierung und zum Serverwachstum.
Wohin als nächstes?
- Fügen Sie weitere Ressourcen aus dem Community Hub und Beispiel-Repositories hinzu.
- Richten Sie ein Sprachserver extern für große Bevölkerungsgruppen.
- Automatisieren Sie CI/CD, um Updates auf Ihre Box zu übertragen.
Empfohlene Lektüre (auf FiveMX)
- Frameworks vergleichen: FiveM vs. RAGE:MP vs. alt:V – Welches sollten Sie wählen?
- Erweitern Sie Ihre Community: So machen Sie Werbung für Ihren Server (funktioniert für jedes GTA V MP)
- Bauen Sie Ihre Heimatbasis: So erstellen Sie eine Website für Ihren Gaming-Server
- Tuning-Tipps: Leistung und Optimierung
Snippets kopieren und einfügen (Kurzreferenz)
Windows-Start:
./altv-server.exe
Linux-Start:
./altv-server
Offene Ports (Windows):
New-NetFirewallRule -DisplayName "altV 7788 TCP" -Direction Inbound -Protocol TCP -LocalPort 7788 -Action Allow New-NetFirewallRule -DisplayName "altV 7788 UDP" -Direction Inbound -Protocol UDP -LocalPort 7788 -Action Allow
Offene Ports (Linux):
sudo ufw erlauben 7788/tcp && sudo ufw erlauben 7788/udp
Sie sind bereit. Starten Sie es, stellen Sie eine Verbindung vom alt:V-Client her und beginnen Sie mit dem Aufbau von Ressourcen!
