Sites
Allez sur Sites → Nouveau Site et entrez votre domaine (sans www) pour créer un nouveau site. La configuration des certificats Nginx et SSL est automatique.
Création d'un site
Ouvrez Sites → Nouveau site et saisissez votre nom de domaine sans www. Herne effectue les opérations suivantes automatiquement :
- Créez un bloc serveur Nginx pour votre domaine
- Créer le conteneur du site à
/var/www/{domain}et la racine du projet à/var/www/{domain}/web_root - Utiliser
/var/www/{domain}/web_root/publiccomme racine du document initial - Obtention automatique d'un certificat SSL via Let's Encrypt (Certbot)
- Rechargez Nginx afin que le site soit immédiatement accessible sur HTTPS
Documenter les options de base
Ouvrez Sites → Paramètres → Général pour choisir le dossier de haut niveau à l'intérieur de web_root que doit servir Nginx.
- La valeur par défaut est
/publicpour les applications de style Laravel - Vous pouvez passer à
/,/docs,/distou à tout autre dossier de premier niveau trouvé à l'intérieur deweb_root - Utilisez Actualiser les dossiers après le téléchargement d'une construction statique afin que la case sélectionnée relise le système de fichiers
Réglage déroulant
La navigation des paramètres du site est divisée en pages ciblées : Général, SSL / HTTPS, Limites PHP, Paramètres Redis par défaut, Domaines supplémentaires / Alias et Zone de danger.
Utilisez la documentation de paramètres dédiée pour les limites d'exécution, SSL re-sync, Redis par défaut et les actions destructrices.
Facultatif www Alias
Si votre site utilise un domaine apex comme example.com, vous pouvez activer l'alias optionnel www lors de la création ou plus tard depuis Sites → Paramètres → Général.
- Ajouter un enregistrement DNS pour
wwwavant de l'activer - Herne maintient le domaine apex canonique et redirige à la fois HTTP et HTTPS
wwwtrafic retour à l'hôte apex - Lorsque SSL est activé, Herne demande des certificats pour les deux noms d'hôte
Domaines supplémentaires / Alias
Utilisez Sites → Paramètres → Domaines supplémentaires / Aliases lorsque le même site Herne doit répondre pour d'autres noms d'hôte.
- Les Aliases utilisent le répertoire existant du site et la racine du document; Herne ne renomme pas ou ne déplace pas la racine du site.
- Des alias de service actifs sont ajoutés à la liste Nginx
server_namegénérée. - Les Aliases marquées Rediriger vers le domaine principal reçoivent des blocs de redirection canoniques au lieu de servir l'application directement.
- Les alias marqués Inclure dans SSL sont inclus lorsque SSL est activé ou re-synchronisé.
- La création d'alias ne nécessite pas de zone DNS gérée par Herne; DNS externe est supporté.
La page des alias utilise des flux d'ajout, de modification et de suppression destructifs basés sur le mode. La case à cocher www gère uniquement le propre hôte www du domaine primaire. Utilisez la migration canonique de domaine lorsque le domaine primaire lui-même doit changer.
SSL Gestion
Sites → Paramètres → SSL / HTTPS vous permet d'examiner et de contrôler l'état du certificat en direct.
- Activer SSL demande un certificat pour les noms d'hôte actuels
- Désactiver SSL supprime HTTPS de la configuration du site
- Resynchroniser le SSL re-vérifie les fichiers de certificat en direct sur le disque et met à jour l'état du panneau stocké
- Les Aliases marquées Inclure dans SSL font partie des flux SSL activés et ré-synchrones
Assistant de configuration — Après la création, vous êtes redirigé vers l'assistant de configuration. Utilisez-le pour configurer votre dépôt Git, votre fichier .env et votre base de données en un flux guidé avant le premier déploiement.
Hébergement d'un site statique
Vous pouvez également utiliser Herne pour héberger des sites statiques tels que des pages de marketing exportées, une sortie frontale préconstruite ou des sites de documentation.
- Créez le site normalement. La racine du document initial commence à
/web_root/public. - Téléchargez vos fichiers statiques de compilation ou une archive ZIP depuis Sites → Fichiers.
- Si votre build vit dans un autre dossier de haut niveau comme
distoubuild, allez à Sites → Paramètres → Général. - Utilisez Actualiser les dossiers pour recharger les répertoires disponibles à partir du disque, puis choisissez le dossier que vous voulez que Nginx serve de racine de document.
Cela fonctionne bien pour les exportations statiques qui contiennent des fichiers tels que index.html, CSS, JavaScript paquets, images et autres actifs front-end.
Modification de la version PHP
Allez dans Sites → Paramètres → Général et choisissez une version PHP dans le menu déroulant. Herne met à jour le chemin de prise Nginx FastCGI (php8.x-fpm.sock) et recharge automatiquement Nginx.
Le service PHP-FPM correspondant doit déjà être installé sur le serveur (php8.x-fpm). S'il n'est pas installé, le site retournera une erreur de 502.
Limites de PHP et Config temps d'exécution
Utilisez Sites → Paramètres → Limites PHP pour la taille de téléchargement, la taille de POST, la mémoire, le délai d'exécution et le comportement de client_max_body_size. Herne met en place des changements de configuration d'exécution, valide la configuration active de Nginx et retourne en cas de défaillance de la vérification.
État du site
Un site peut être Actif ou Inactif. Le statut est actuellement informatif — il ne désactive pas la configuration Nginx.
Suppression d'un site
Suppression permanente d'un site de Sites → Paramètres → Zone de danger :
- Supprime le bloc serveur Nginx.
- Révoque le certificat SSL avec certbot delete.
- Supprime le répertoire racine web (
/var/www/{domain}).
Cette action est irréversible. Assurez-vous d'avoir une sauvegarde avant de supprimer.
Limites du plan
Le nombre de sites que vous pouvez créer est déterminé par votre plan (max_sites). Si vous touchez la limite, le bouton Nouveau site affichera une erreur. Mettez à jour votre plan à partir de Facturation → Planification & Facturation.