Fejlesztőknek
Hibakeresés – Gyakori problémák
HestiaCP leggyakoribb hibák diagnosztikája: naplófájlok, 500/502 hibák, SSL problémák, email és MySQL hibák.
Naplófájlok helye
| Szolgáltatás | Naplófájl helye | Mire jó? |
|---|---|---|
| HestiaCP rendszer | /var/log/hestia/system.log | Panel műveletek, CLI parancsok eredménye |
| HestiaCP auth | /var/log/hestia/auth.log | Panel bejelentkezési kísérletek |
| Nginx error | /var/log/nginx/error.log | 502 Bad Gateway, 404, Nginx hibák |
| Nginx access | /var/log/nginx/access.log | Összes HTTP kérés naplója |
| Apache error | /var/log/apache2/error.log | PHP/Apache hibák (ha Apache is fut) |
| Domain-specifikus log | /var/log/apache2/domains/domain.hu.error.log | Egy adott weboldal PHP hibái |
| PHP-FPM | /var/log/php8.3-fpm.log | PHP-FPM worker hibák |
| Exim (SMTP) | /var/log/exim4/mainlog | Email küldés/fogadás naplója |
| Dovecot | /var/log/dovecot.log | IMAP/POP3 bejelentkezések, hibák |
| Fail2Ban | /var/log/fail2ban.log | Blokkolt IP-k, jail állapotok |
| MySQL / MariaDB | /var/log/mysql/error.log | Adatbázis hibák, kapcsolódási problémák |
Log fájlok valós idejű figyelése
bash
# HestiaCP rendszer napló
tail -f /var/log/hestia/system.log
# Nginx hibák
tail -f /var/log/nginx/error.log
# Egy domain Apache/PHP hibái
tail -f /var/log/apache2/domains/domain.hu.error.log
# Exim email napló
tail -f /var/log/exim4/mainlog
# Fail2Ban
tail -f /var/log/fail2ban.logLeggyakoribb hibák és megoldásaik
500 Internal Server Error
PHP hiba az alkalmazásban. Ellenőrizd a domain-specifikus error log fájlt:
tail -50 /var/log/apache2/domains/domain.hu.error.log. Leggyakoribb okok: hibás .htaccess, PHP szintaxis hiba, hiányzó fájl jogosultság, vagy nem megfelelő PHP verzió.502 Bad Gateway
A PHP-FPM worker nem fut, vagy nem elérhető. Megoldás:
systemctl restart php8.3-fpm. Ha ismétlődik, ellenőrizd a PHP-FPM naplót: tail -50 /var/log/php8.3-fpm.log. Okozhatja memória-túllépés is – növeld a pm.max_children értéket a pool konfigban.Let's Encrypt hiba – Domain validation failed
A domain A rekordja nem a szerverre mutat, vagy a Cloudflare proxy mögött van (HTTP-01 kihívás nem ér el a szerverig). Ellenőrizd:
dig A domain.hu – a visszaadott IP a szerver IP-je kell legyen. Cloudflare esetén ideiglenesen kapcsold ki a proxyt a Let's Encrypt kiállítása idejére.Email küldési hiba – Connection refused / Timeout
A 25-ös (SMTP) port valószínűleg blokkolva van. A legtöbb VPS/cloud provider alapból blokkolja a kimenő 25-ös portot spam-megelőzés céljából. Ellenőrizd:
telnet smtp.gmail.com 25. Megoldás: kérj port 25 feloldást a hosztingtól, vagy használj külső SMTP relay-t (pl. SendGrid, Mailgun).HestiaCP panel bejelentkezés sikertelen – Access Denied
A Fail2Ban blokkolhatta az IP-det a túl sok sikertelen kísérlet miatt. SSH-n oldj fel:
fail2ban-client set hestia-iptables unbanip SAJAT-IP. Ha a Fail2Ban nem blokkol, ellenőrizd a jelszót és a 2FA kódot. Jelszó-visszaállítás SSH-n: v-change-user-password admin UjJelszoMySQL – Access denied for user 'user'@'localhost'
HestiaCP-n az adatbázis-felhasználónevek automatikusan a HestiaCP felhasználónév előtagját kapják (pl.
ugyfel_dbuser, nem csak dbuser). Ellenőrizd a kapcsolati stringet az alkalmazásban – használd a teljes előtagos felhasználónevet. A pontos nevet: v-list-databases felhasznalonevNginx – 413 Request Entity Too Large
A feltölteni kívánt fájl mérete meghaladja az Nginx és/vagy PHP korlátát. Növeld a
client_max_body_size értéket az Nginx konfigban, és a upload_max_filesize / post_max_size értékeket a PHP.ini-ben, majd indítsd újra mindkét szolgáltatást.Diagnosztikai parancsok
bash
# Futó releváns szolgáltatások
systemctl list-units --type=service --state=running | grep -E "nginx|apache|mysql|php|exim|dovecot"
# Lemezhasználat ellenőrzése
df -h
# Memóriahasználat
free -h
# HestiaCP verzió és konfiguráció
cat /usr/local/hestia/conf/hestia.conf | grep -E "VERSION|WEBSERVER|MAIL|DB"
# Portok figyelése (mi hallgat melyik porton?)
ss -tlnp | grep -E ":80|:443|:8083|:25|:587|:993"
# Legutóbbi HestiaCP műveletek naplója
tail -30 /var/log/hestia/system.log