Migrer un site CyberPanel vers /var/www pour l’exploiter via SSH avec un agent IA (Claude, Codex)

Migrer un site CyberPanel vers /var/www pour l’exploiter via SSH avec un agent IA (Claude, Codex)

Déplacer un site créé avec CyberPanel vers /var/www n’est pas seulement une question d’organisation serveur. C’est souvent une étape stratégique pour pouvoir piloter son projet proprement en SSH, automatiser des tâches, utiliser un agent IA comme Claude ou Codex, ou intégrer le site dans un workflow DevOps plus avancé.

Ce guide explique comment migrer correctement un site vers /var/www/guidelondres.fr/public_html sans provoquer d’erreur 403, sans casser OpenLiteSpeed, et sans impacter le SEO.

Pourquoi déplacer un site CyberPanel vers /var/www ?

Par défaut, CyberPanel crée les sites dans :

/home/nomdusite/public_html

Ce fonctionnement est simple, mais moins pratique lorsque :

  • On veut gérer plusieurs projets via SSH
  • On veut brancher un agent IA sur l’arborescence serveur
  • On veut centraliser tous les projets web dans /var/www
  • On travaille avec des scripts d’automatisation
  • On utilise Git, CI/CD ou des outils DevOps

Déplacer le site vers /var/www permet une structure plus standardisée et plus compatible avec des environnements automatisés.

Étape 1 : Copier proprement le projet avec rsync

On évite un simple mv. On utilise rsync pour conserver les permissions, les liens et la structure.

mkdir -p /var/www/guidelondres.fr/public_html
rsync -aHAX --info=progress2 /home/guidelondres.fr/public_html/ /var/www/guidelondres.fr/public_html/

Pourquoi rsync est important :

  • Préserve les droits Linux
  • Évite les corruptions
  • Permet de relancer la copie en cas d’interruption
  • Garde une structure exploitable par un agent IA

Étape 2 : Conserver l’utilisateur système LSAPI

Dans ce cas précis, le site utilise l’utilisateur :

guide8629

Il faut impérativement conserver cet utilisateur dans la configuration OpenLiteSpeed.

On corrige l’ownership :

chown -R guide8629:guide8629 /var/www/guidelondres.fr

Si l’utilisateur ne correspond pas à celui défini dans le scripthandler et l’extprocessor, le serveur renverra une erreur 403.

Étape 3 : Modifier le docRoot dans le vhost OpenLiteSpeed

Ouvrir le fichier :

/usr/local/lsws/conf/vhosts/guidelondres.fr/vhconf.conf

Modifier la ligne :

docRoot /home/guidelondres.fr/public_html

En :

docRoot /var/www/guidelondres.fr/public_html

Puis redémarrer OpenLiteSpeed :

/usr/local/lsws/bin/lswsctrl restart

Étape 4 : Corriger les permissions Linux pour éviter l’erreur 403

Une erreur 403 vient presque toujours d’un problème de permissions sur un dossier parent.

Commandes validées :

chmod 755 /var/www
chmod 755 /var/www/guidelondres.fr
chmod 755 /var/www/guidelondres.fr/public_html
find /var/www/guidelondres.fr/public_html -type d -exec chmod 755 {} \;
find /var/www/guidelondres.fr/public_html -type f -exec chmod 644 {} \;

Explication :

  • 755 pour les dossiers permet la traversée
  • 644 pour les fichiers permet la lecture sans exécution inutile
  • Les dossiers parents doivent aussi être exécutables

Pour diagnostiquer un problème :

namei -l /var/www/guidelondres.fr/public_html/test.php

Cette commande affiche les permissions dossier par dossier.

Structure finale optimisée pour SSH et agents IA

Arborescence propre :

/var/www/guidelondres.fr/public_html

Utilisateur système :

guide8629

Permissions :

  • Dossiers : 755
  • Fichiers : 644

DocRoot correctement mis à jour dans OpenLiteSpeed.

Pourquoi cette structure est idéale pour un agent IA comme Claude ou Codex

Lorsque tu connectes un agent IA en SSH :

  • Il doit pouvoir parcourir l’arborescence sans restriction
  • Les permissions doivent être cohérentes
  • Le projet doit être organisé de façon standard
  • Les chemins doivent être explicites et stables

Une structure claire dans /var/www facilite :

  • L’analyse automatique du code
  • La génération de scripts
  • La modification de fichiers
  • L’audit sécurité
  • L’optimisation SEO automatisée
  • La maintenance continue

Un agent IA fonctionne beaucoup mieux avec une architecture propre qu’avec une structure éclatée dans /home.

Bonnes pratiques à retenir

  • Toujours utiliser rsync pour déplacer un projet
  • Toujours conserver l’utilisateur LSAPI défini dans le vhost
  • Toujours corriger les permissions des dossiers parents
  • Toujours redémarrer OpenLiteSpeed après modification du docRoot
  • Toujours vérifier les logs en cas d’erreur

Conclusion

Migrer un site CyberPanel vers /var/www permet d’avoir une structure plus professionnelle, compatible avec SSH, DevOps et agents IA comme Claude ou Codex.

L’erreur 403 n’est jamais mystérieuse. Elle provient presque toujours :

  • d’un mauvais docRoot
  • d’un ownership incorrect
  • d’une permission Linux bloquante

Avec cette méthode, tu obtiens :

  • Un site stable
  • Une structure propre
  • Un environnement exploitable par une IA
  • Une base solide pour automatiser et scaler tes projets

Permissions — commandes à retenir

# Voir qui possède quoi
ls -la /var/www/guidelondres.fr/public_html/wp-content/themes/wp-theme-guidelondres/

# Rendre les fichiers éditables par ubuntu (à relancer si un nouveau fichier arrive)
sudo chown ubuntu:ubuntu /var/www/guidelondres.fr/public_html/wp-content/themes/wp-theme-guidelondres/*.php
sudo chown ubuntu:ubuntu /var/www/guidelondres.fr/public_html/wp-content/themes/wp-theme-guidelondres/images/

# Vérifier les groupes d'un user
id ubuntu
id guide8629