VPBoost Agent · v1.7.38

Installation / Aktualisierung & Dokumentation

Fuehren Sie dies auf Ihrem VPS als root aus und ersetzen Sie den Token durch Ihren eigenen Token aus dem Panel:

Getting Started

Installation / Aktualisierung

SELBST GEHOSTET

Ich habe bereits einen VPS

KVM 1

$6.99/mo

1 vCPU Core
4 GB RAM
50 GB NVMe
4 TB Bandwidth

Save $150 on 1 year plan

−20% $83.88 $67.11 billed yearly

Erforderliche Ports

Die folgenden Ports muessen in der Firewall Ihres VPS geoeffnet sein (Alle erlauben / Eingehend + Ausgehend), damit VPBoost funktioniert:

Aktion	Protokoll	Port-Bereich	Zweck
Erlauben	TCP/UDP	`27000 – 29000`	Game server ports, master server heartbeats & challenges, player traffic.
Erlauben	TCP	`8069`	VPBoost Agent API.
Erlauben	TCP	`443`	HTTPS API calls to `counter-strike-boost.com`.

Wichtig: Der Installer oeffnet nur TCP 8069. Sie muessen den Spiel-Port-Bereich selbst oeffnen.

Configuration

Agent Env-Datei

Speicherort der Haupt-Env-Datei:

/etc/agent/vpboost/vpboost-agent.env

Alle Werte aus dieser Datei werden von systemd in den Agent-Prozess geladen. Die Redirects-Binary erbt sie, wenn der Agent sie startet.

Variable	Standard	Verwendet von	Zweck
`VPBOOST_REDIRECT_TICKET_MODE`	`true`	Agent	Adds `-ticket` arg when launching redirects.
`VPBOOST_TICKET_DEBUG`	`0`	Redirects	Verbose ticket/auth debug logs.
`VPBOOST_A2S_DEBUG`	`0`	Redirects	Verbose A2S player/debug logs.
`VPBOOST_QUIET`	`1`	Redirects	Reduces console noise.
`VPBOOST_SCREEN_LOGS`	`0`	Agent	Enables screen session log files.

Env mit einem Befehl setzen

Beispielprofil fuer Debug-Modus + persistente Bildschirm-Logs:

cat <<'EOF' > /etc/agent/vpboost/vpboost-agent.env
VPBOOST_REDIRECT_TICKET_MODE=true
VPBOOST_TICKET_DEBUG=1
VPBOOST_A2S_DEBUG=1
VPBOOST_QUIET=0
VPBOOST_SCREEN_LOGS=1
EOF
systemctl daemon-reload
systemctl restart vpboost-agent

Reference

Live-Logs / Fehleranalyse

Nuetzlichste Befehle:

# service logs
journalctl -u vpboost-agent -f

# redirect screen logs (chunk mode)
tail -f /root/vpboost/screen_red-all-1.log

# list active screen sessions
screen -ls

Wenn screen_red-all-1.log nicht erscheint, setzen Sie VPBOOST_SCREEN_LOGS=1 und starten Sie den Dienst neu.

Konfigurationsquellen-Fluss

install.sh creates initial files and systemd service.

vpboost-agent.env is loaded by systemd on service start.

Agent reads env defaults from config.go if var missing.

Agent starts Redirects; Redirects inherits env and reads getenv().

Redirects fetches runtime data from API endpoints (/api/getredirectconfig, /api/getports).

Wichtige Pfade

/root/vpboost/vpboost Agent binary

/root/vpboost/screen_red-all-1.log Screen logs

/etc/agent/vpboost/vpboost-agent Agent wrapper

/etc/agent/vpboost/vpboost-agent.env Environment config

/etc/systemd/system/vpboost-agent.service Systemd unit