Installer LGSL v6.2.1 sur VestaCP

ssh -p {{PORT_SSH_NOUVEAU}} {{USER_VESTA}}@{{IP_NOUVEAU}}

php -m | grep -E "sockets|pdo|mysqli|mbstring"

# Debian / Ubuntu
apt-get install php-sockets

# CentOS / RHEL (remplacer X par votre version de PHP)
yum install php-X-sockets

# Puis recharger Apache
service apache2 reload   # ou : service httpd reload

ssh -p {{PORT_SSH_NOUVEAU}} {{USER_VESTA}}@{{IP_NOUVEAU}}

mkdir -p /home/{{USER_VESTA}}/web/{{DOMAINE_GAMING}}/public_html/lgsl

cd /tmp

# Telecharger l'archive depuis GitHub
wget -O lgsl-6.2.1.zip \
  https://github.com/tltneon/lgsl/archive/refs/tags/v6.2.1.zip

# Extraire
unzip lgsl-6.2.1.zip

# Le dossier extrait s'appelle lgsl-6.2.1
# Copier tout son contenu dans le sous-dossier lgsl du site
cp -r lgsl-6.2.1/. /home/{{USER_VESTA}}/web/{{DOMAINE_GAMING}}/public_html/lgsl/

# Nettoyer
rm -rf /tmp/lgsl-6.2.1 /tmp/lgsl-6.2.1.zip

# Le proprietaire doit etre l'utilisateur web (admin sous VestaCP)
chown -R {{USER_VESTA}}:{{USER_VESTA}} /home/{{USER_VESTA}}/web/{{DOMAINE_GAMING}}/public_html/lgsl/

# Permissions standards
find /home/{{USER_VESTA}}/web/{{DOMAINE_GAMING}}/public_html/lgsl/ -type d -exec chmod 755 {} \;
find /home/{{USER_VESTA}}/web/{{DOMAINE_GAMING}}/public_html/lgsl/ -type f -exec chmod 644 {} \;

ls /home/{{USER_VESTA}}/web/{{DOMAINE_GAMING}}/public_html/lgsl/

http://{{DOMAINE_GAMING}}/lgsl/install.php

cat /home/{{USER_VESTA}}/web/{{DOMAINE_GAMING}}/public_html/lgsl/lgsl_config.php

rm /home/{{USER_VESTA}}/web/{{DOMAINE_GAMING}}/public_html/lgsl/install.php

ls /home/{{USER_VESTA}}/web/{{DOMAINE_GAMING}}/public_html/lgsl/install.php
# Doit retourner : No such file or directory

http://{{DOMAINE_GAMING}}/lgsl/admin.php

cp /home/{{USER_VESTA}}/web/{{DOMAINE_GAMING}}/public_html/lgsl_files/lgsl_protocol.php \
   /home/{{USER_VESTA}}/web/{{DOMAINE_GAMING}}/public_html/lgsl_files/lgsl_protocol.php.bak

');
if ($pos !== false) {
    $code = substr($code, 0, $pos) . $function . "\n?>";
} else {
    $code .= $function;
}

file_put_contents($file, $code);
echo "Patch Kaillera applique avec succes !\n";

mkdir -p /home/{{USER_VESTA}}/web/{{DOMAINE_GAMING}}/public_html/lgsl_files/icons/kaillera

      Pour les noms de joueurs et le nombre en temps reel, voir la section 8.7 ci-dessous.
    

8.7 Nombre de joueurs en temps reel (protocole v086)

Le beacon HELLO0.83 ne retourne aucune donnee sur les joueurs.
Pour obtenir les noms, ping et statut des joueurs en temps reel,
un script Python (kaillera_poll.py) implemente le protocole binaire Kaillera v086 complet :

1. Envoie HELLO0.83 → recoit le port prive
2. Se connecte au port prive et envoie un UserInformation (type 0x03)
3. Echange des paquets ACK (types 0x05/0x06) pour mesurer le ping
4. Recoit le paquet ServerStatus (type 0x04) contenant la liste complete des joueurs et parties
5. Envoie un Quit (type 0x01) propre et se deconnecte

Le script ecrit le resultat dans lgsl_kaillera_status.json que lgsl_query_49 lit directement.

8.7.1 Architecture

[LGSL requete web] → lgsl_query_49()
    ├── Beacon HELLO (detection online)
    ├── JSON perime (> 30s) ou absent ?
    │   ├── OUI → declenche kaillera_poll.py via shell_exec()
    │   │           ├── Protocole v086 complet → users + games
    │   │           ├── Filtre le bot "lgsl_poll" de la liste
    │   │           └── Ecrit lgsl_kaillera_status.json (ecriture atomique)
    │   └── NON → lecture directe du JSON existant
    ├── Lecture lgsl_kaillera_status.json
    │   ├── Frais (< 60s) → noms + ping + statut
    │   └── Perime → fallback master server kaillera.com
    └── Affichage dans LGSL

8.7.2 Deploiement du script

Le script kaillera_poll.py est inclus dans le fork GitHub
(smkerz/lgsl-kaillera)
dans le dossier lgsl_files/.

Copier le script dans le dossier LGSL du serveur :

cp kaillera_poll.py /home/{{USER_VESTA}}/web/{{DOMAINE_GAMING}}/public_html/lgsl_files/
chmod +x /home/{{USER_VESTA}}/web/{{DOMAINE_GAMING}}/public_html/lgsl_files/kaillera_poll.py

Test manuel :

python3 /home/{{USER_VESTA}}/web/{{DOMAINE_GAMING}}/public_html/lgsl_files/kaillera_poll.py \
  --ip 127.0.0.1 --port 27888

# Verifier le JSON produit
cat /home/{{USER_VESTA}}/web/{{DOMAINE_GAMING}}/public_html/lgsl_files/lgsl_kaillera_status.json

Le JSON contient pour chaque joueur : nom, ping, statut (0=Idle, 1=Playing, 2=Away), ID et type de connexion.

8.7.3 Verification

1. Connectez-vous au serveur Kaillera avec un client (ex: Kaillera P2P ou SupraclientC)
2. Rechargez la page LGSL — la requete declenche kaillera_poll.py automatiquement si le JSON est absent ou perime (> 30s). Verifiez ensuite le JSON :

   cat /home/{{USER_VESTA}}/web/{{DOMAINE_GAMING}}/public_html/lgsl_files/lgsl_kaillera_status.json

   Votre nom doit apparaitre dans la liste users.

3. Le compteur doit afficher 1/100 et votre nom dans la liste des joueurs.
4. Deconnectez-vous du serveur Kaillera, rechargez la page LGSL, verifiez que le compteur revient a 0/100.

8.7.4 Depannage

9. Personnalisation

9.1 Changer la langue en francais

Editez le fichier lgsl_config.php et cherchez la ligne de configuration de la langue :

nano /home/{{USER_VESTA}}/web/{{DOMAINE_GAMING}}/public_html/lgsl/lgsl_config.php

Modifiez ou ajoutez :

define('LGSL_LANGUAGE', 'fr');

Verifiez que le fichier de langue francais existe :

ls /home/{{USER_VESTA}}/web/{{DOMAINE_GAMING}}/public_html/lgsl/lgsl/languages/

9.2 Changer le theme

Les themes sont dans le dossier themes/. Pour appliquer un theme, editez lgsl_config.php :

define('LGSL_THEME', 'default'); // Remplacez 'default' par le nom du dossier du theme

9.3 CSS personnalise

Pour personnaliser l’apparence sans modifier les fichiers du theme (afin de faciliter les mises a jour), creez un fichier CSS personnalise dans le dossier du theme actif :

nano /home/{{USER_VESTA}}/web/{{DOMAINE_GAMING}}/public_html/lgsl/themes/default/custom.css

Puis incluez-le dans le template du theme (themes/default/header.php ou equivalent) :

9.4 Intervalle de rafraichissement

Dans lgsl_config.php, l’intervalle de cache (en secondes) entre deux interrogations des serveurs :

define('LGSL_CACHE_TIME', 60); // 60 secondes par defaut

10. Probleme courant : port ServerQuery TS3 (10011)

Contexte du probleme

Si votre TeamSpeak 3 tourne dans un conteneur Docker, le fichier docker-compose.yml lie probablement le port ServerQuery 10011 uniquement a l’interface locale du conteneur ou a 127.0.0.1 de l’hote :

# Exemple de configuration docker-compose.yml restrictive
ports:
  - "127.0.0.1:10011:10011"  # Query TCP - lie a localhost uniquement
  - "0.0.0.0:9987:9987/udp"  # Vocal UDP - accessible publiquement

Pourquoi LGSL peut quand meme fonctionner

Dans votre configuration, Apache et PHP s’executent directement sur l’hote (pas dans un conteneur). Le PHP de LGSL peut donc atteindre 127.0.0.1:10011 car ce port est expose sur l’interface loopback de l’hote, et PHP tourne sur ce meme hote.

Si LGSL etait lui aussi dans Docker

Si LGSL tournait dans son propre conteneur Docker, il ne pourrait PAS atteindre 127.0.0.1:10011 de l’hote via cette adresse. Il faudrait alors :

• Soit lier le port TS3 a 0.0.0.0:10011 dans le docker-compose (expose publiquement)
• Soit placer les deux conteneurs sur le meme reseau Docker et utiliser le nom du service TS3 comme hostname
• Soit utiliser l’IP interne du reseau Docker bridge (172.17.0.1 par defaut)

Verifier que le port 10011 est accessible depuis PHP

# Depuis l'hote, tester la connexion TCP au port ServerQuery
nc -zv 127.0.0.1 10011
# Reponse attendue : Connection to 127.0.0.1 10011 port [tcp/*] succeeded!

Ou via PHP en ligne de commande :

php -r "
\$fp = fsockopen('127.0.0.1', 10011, \$errno, \$errstr, 5);
if (\$fp) {
    echo 'Port 10011 accessible' . PHP_EOL;
    fclose(\$fp);
} else {
    echo 'ERREUR : ' . \$errstr . PHP_EOL;
}
"

Si le port 10011 n’est pas accessible

Modifiez votre docker-compose.yml pour exposer le port sur toutes les interfaces :

ports:
  - "10011:10011"   # Accessible depuis l'hote sur toutes les interfaces
  - "9987:9987/udp"

Puis relancez le conteneur :

cd /chemin/vers/votre/teamspeak/
docker-compose down && docker-compose up -d

Configurer les permissions ServerQuery pour LGSL

Meme si le port 10011 est accessible, LGSL peut afficher les serveurs TS3 en rouge / hors ligne si les permissions ServerQuery ne sont pas correctement configurees.

Le probleme

LGSL se connecte au ServerQuery sans authentification. Il est donc affecte au groupe Guest Server Query. Par defaut, ce groupe n’a pas la permission d’executer la commande serverinfo, ce qui provoque l’erreur :

error id=2568 msg=insufficient\sclient\spermissions failed_permid=25

Piege : identifier le bon groupe

Les groupes ServerQuery (type=2) dans TeamSpeak ont des ID parfois contre-intuitifs :

Permissions requises

LGSL a besoin de 3 permissions pour interroger un serveur virtuel TeamSpeak 3 :

Appliquer les permissions

Les permissions doivent etre accordees sur chaque serveur virtuel (sid). Utilisez ce script PHP depuis le serveur :

php -r '
$fp = @fsockopen("tcp://{{IP_NOUVEAU}}", 10011, $errno, $errstr, 2);
stream_set_timeout($fp, 2);
fread($fp, 4096); fread($fp, 4096);
fwrite($fp, "login serveradmin MOT_DE_PASSE\n");
fread($fp, 4096);

// Pour chaque serveur virtuel (sid=1, sid=2, etc.)
foreach ([1, 2] as $sid) {
    fwrite($fp, "use sid=$sid\n");
    fread($fp, 4096);
    fwrite($fp, "servergroupaddperm sgid=1 permsid=b_virtualserver_info_view permvalue=1 permnegated=0 permskip=0\n");
    echo "sid=$sid info_view: " . trim(fread($fp, 4096)) . "\n";
    fwrite($fp, "servergroupaddperm sgid=1 permsid=b_virtualserver_select permvalue=1 permnegated=0 permskip=0\n");
    echo "sid=$sid select: " . trim(fread($fp, 4096)) . "\n";
    fwrite($fp, "servergroupaddperm sgid=1 permsid=b_virtualserver_client_list permvalue=1 permnegated=0 permskip=0\n");
    echo "sid=$sid client_list: " . trim(fread($fp, 4096)) . "\n";
}
fclose($fp);
'

Verifier que LGSL peut interroger TS3

Testez en simulant exactement le comportement de LGSL (connexion non authentifiee, timeout 0.5s) :

php -r '
$fp = @fsockopen("tcp://{{IP_NOUVEAU}}", 10011, $errno, $errstr, 2);
stream_set_timeout($fp, 0, 500000);
stream_set_blocking($fp, TRUE);
$b = fread($fp, 4096);
echo "Banner: " . (strpos($b, "TS") !== FALSE ? "OK" : "FAIL") . "\n";
fread($fp, 4096);
fwrite($fp, "use port=9987\n");
$r = fread($fp, 4096);
echo "Use: " . trim($r) . "\n";
fwrite($fp, "serverinfo\n");
$r = fread($fp, 4096);
echo "Serverinfo: " . substr(trim($r), 0, 120) . "\n";
fclose($fp);
'

Resultat attendu : la ligne Serverinfo: doit afficher les informations du serveur (nom, joueurs, etc.) et non une erreur de permission.

Diagnostic : lister les groupes ServerQuery

En cas de doute sur les ID de groupes, connectez-vous en serveradmin et listez les groupes :

# Apres login + use sid=1 :
servergrouplist
# Les groupes de type=2 sont les groupes ServerQuery
# sgid=1 type=2 → Guest Server Query (connexions non authentifiees)
# sgid=2 type=2 → Admin Server Query (apres login serveradmin)

11. Verification du fonctionnement

11.1 Verifier l’affichage de la liste

Ouvrez dans un navigateur :

http://{{DOMAINE_GAMING}}/lgsl/

Vous devriez voir la liste des serveurs avec leur statut. Les serveurs allumes affichent le nombre de joueurs et la carte.

11.2 Tester l’interrogation d’un serveur CS 1.6 manuellement

# Tester la joignabilite UDP du port 27015
nc -uzv {{IP_NOUVEAU}} 27015

# Ou avec nmap
nmap -sU -p 27015 {{IP_NOUVEAU}}

11.3 Verifier les logs PHP / Apache

# Logs Apache pour le domaine
tail -50 /home/{{USER_VESTA}}/web/{{DOMAINE_GAMING}}/log/error.log

# Logs Apache access
tail -50 /home/{{USER_VESTA}}/web/{{DOMAINE_GAMING}}/log/access.log

11.4 Tester depuis PHP

Creez un script de test temporaire /home/{{USER_VESTA}}/web/{{DOMAINE_GAMING}}/public_html/lgsl/test_query.php :