Instalace a co je HLstatsX:CE

🧠 Co je HLstatsX:CE

HLstatsX (přesněji HLstatsX: Community Edition) je webový statistický systém pro Source hry — jako CS:GO, CS:S, TF2, L4D2 apod.
📊 Funguje tak, že sbírá data ze hry (kills, deaths, mapy, zbraně, skóre, chat) a ukládá je do databáze, ze které generuje krásné webové statistiky.

---

🎮 Co všechno HLstatsX umí

---

💡 Proč to chtít

✅ Hráči milují soutěžení – žebříčky, body, TOP hráči.
✅ Můžeš sledovat aktivitu, chování a výkon hráčů.
✅ Pomůže s laděním serveru (např. které mapy se hrají nejvíc).
✅ Profesionální vzhled – každý CS server “s respektem” ho má.
✅ Webová správa a přehledná historie bez nutnosti být ve hře.

---

⚙️ Jak to funguje (zjednodušeně)

1️⃣ CS:GO server posílá logy (UDP pakety) na HLstatsX backend
2️⃣ HLstatsX daemon (běžící v Dockeru) je zpracovává
3️⃣ Data se ukládají do MySQL databáze
4️⃣ Webová aplikace (Apache + PHP) z nich zobrazuje statistiky

---

🧩 Architektura u tebe

Bude to fungovat takto:

[CS:GO Server (Portainer)]
        ↓
 (UDP logy, port 27500)
        ↓
[HLstatsX Daemon (Docker)]
        ↔
[HLstatsX Web (Docker + MySQL)]
        ↑
      https://csgo.zelina.eu/stats

🔧 INSTALACE (u tebe do /opt/hlstatsx)

Všechno pěkně pod /opt/hlstatsx/
HLstatsX poběží ve třech kontejnerech:

• hlx_web → web rozhraní

• hlx_db → databáze

• hlx_daemon → sbírá data z CS:GO serveru

---

📂 1️⃣ PŘÍPRAVA ADRESÁŘŮ

sudo mkdir -p /opt/hlstatsx/{db,web,daemon,logs}
cd /opt/hlstatsx

📜 2️⃣ VYTVOR /opt/hlstatsx/docker-compose.yml

version: "3.8"

services:
  hlx_db:
    image: mariadb:11
    container_name: hlx_db
    environment:
      - MYSQL_ROOT_PASSWORD=hlxrootpass
      - MYSQL_DATABASE=hlstatsx
      - MYSQL_USER=hlxuser
      - MYSQL_PASSWORD=hlxpass
    volumes:
      - /opt/hlstatsx/db:/var/lib/mysql
    restart: unless-stopped

  hlx_web:
    image: ghcr.io/linuxserver/hlstatsx
    container_name: hlx_web
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Europe/Prague
      - HLX_DB_HOST=hlx_db
      - HLX_DB_USER=hlxuser
      - HLX_DB_PASS=hlxpass
      - HLX_DB_NAME=hlstatsx
    ports:
      - "8080:80"
    depends_on:
      - hlx_db
    volumes:
      - /opt/hlstatsx/web:/config
    restart: unless-stopped

  hlx_daemon:
    image: ghcr.io/linuxserver/hlstatsx-daemon
    container_name: hlx_daemon
    environment:
      - TZ=Europe/Prague
      - HLX_DB_HOST=hlx_db
      - HLX_DB_USER=hlxuser
      - HLX_DB_PASS=hlxpass
      - HLX_DB_NAME=hlstatsx
    volumes:
      - /opt/hlstatsx/daemon:/config
      - /opt/hlstatsx/logs:/logs
    restart: unless-stopped
    ports:
      - "27500:27500/udp"

🚀 3️⃣ SPUŠTĚNÍ STACKU

cd /opt/hlstatsx
sudo docker compose up -d

Po chvíli:

• Web poběží na http://IP_ADRESA:8080

• Databáze se inicializuje

• Daemon čeká na logy ze hry

---

🔗 4️⃣ PROPOJENÍ S CS:GO SERVEREM

Uprav CS:GO konfiguraci:
/opt/csgo/cfg/server.cfg

Přidej tyto řádky:

logaddress_add 192.168.1.50:27500
sv_logecho 1
sv_logfile 1
sv_log_onefile 0

 

IP adresa je IP tvého miniPC (kde běží Docker HLstatsX).

Poté restartuj kontejner:

sudo docker restart csgo

📊 5️⃣ KONTROLA FUNKCE

Po připojení hráče na server se začne v /opt/hlstatsx/logs/ objevovat záznam.
Na webu (port 8080) uvidíš první data o hráčích.

---

🌍 6️⃣ PŘESUN NA DOMÉNU (např. csgo.zelina.eu/stats)

Pokud máš Nginx reverse proxy (např. v Portaineru nebo Traefiku), přesměruj:
csgo.zelina.eu/stats → 127.0.0.1:8080

---

💾 7️⃣ ZÁLOHOVÁNÍ

Zálohuj složky:

• /opt/hlstatsx/db

• /opt/hlstatsx/web

• /opt/hlstatsx/daemon

---

🧠 Shrnutí: proč to celé chceš mít

✅ Profesionální statistiky pro tebe i hráče
✅ Automatický systém hodnocení hráčů
✅ Webová prezentace serveru (můžeš propojit s Homarr / hlavní dashboard)
✅ Možnost expanze — více CS:GO serverů = jeden HLstatsX systém