Generator Apache VirtualHost

Generator Apache VirtualHost — domena, PHP-FPM i HTTPS w jednym pliku

Generator Apache VirtualHost składa gotowy blok <VirtualHost>, w którym domena dostaje własny DocumentRoot, sekcję <Directory>, przekazanie PHP do PHP-FPM oraz osobne logi. Po włączeniu SSL powstaje blok na porcie 443 z certyfikatem i drugi na porcie 80, który przekierowuje ruch na HTTPS.

Co dokładnie robi to narzędzie

Podajesz domenę, DocumentRoot, adres administratora, port oraz gniazdo PHP-FPM i dostajesz kompletny plik konfiguracyjny. Pierwsza linia to <VirtualHost *:80> albo <VirtualHost *:443>, zależnie od SSL. Dalej trafiają ServerName i ServerAlias www., więc witryna odpowiada z prefiksem i bez niego. Domenę sprawdzamy pod kątem poprawnej nazwy DNS, a DocumentRoot musi być ścieżką bezwzględną — te wartości trafiają wprost do konfiguracji serwera.

VirtualHost to warstwa wyżej niż plik .htaccess. Regułę katalogową czy przekierowanie ułożysz w generatorze pliku .htaccess, a dostęp hasłem dołożysz wpisem z generatora .htpasswd.

Sekcja Directory i błąd 403

Najczęstsza przyczyna błędu 403 Forbidden na świeżo wystawionej stronie to brak Require all granted w bloku <Directory>. Apache od 2.4 domyślnie odmawia dostępu do katalogów, o które nie poprosisz jawnie. Dlatego narzędzie wstawia trzy dyrektywy: Options -Indexes +FollowSymLinks wyłącza listowanie katalogu, AllowOverride All pozwala odczytać reguły z .htaccess, a Require all granted otwiera zasób dla klientów. Bez tej ostatniej linii serwer odpowie 403.

Kluczowe dyrektywy w wygenerowanym pliku

SSL, port 443 i przekierowanie z HTTP

Certyfikat SSL działa tylko w bloku nasłuchującym na porcie 443, nie na 80. Dlatego po zaznaczeniu SSL narzędzie kieruje główny blok na *:443, wstawia SSLEngine on oraz ścieżki SSLCertificateFile i SSLCertificateKeyFile do katalogu Let's Encrypt /etc/letsencrypt/live/. Powstaje też krótki blok <VirtualHost *:80>, który przez RewriteRule przekierowuje ruch HTTP na HTTPS z kodem 301. Ważność certyfikatu potwierdzisz w weryfikatorze certyfikatu SSL, a nagłówki bezpieczeństwa złożysz w generatorze nagłówka CSP.

PHP-FPM zamiast mod_php

Nowoczesny Apache nie wykonuje PHP wewnątrz procesu serwera, tylko przekazuje je do usługi PHP-FPM przez gniazdo, np. unix:/run/php/php8.3-fpm.sock. Narzędzie zapisuje to w bloku <FilesMatch \.php$> z dyrektywą SetHandler "proxy:...|fcgi://localhost". Taki układ jest szybszy, oddziela uprawnienia PHP od Apache i pozwala trzymać różne wersje PHP dla różnych domen. Wymaga modułów proxy_fcgi i setenvif. Puste pole pomija ten blok — vhost obsłuży wtedy tylko pliki statyczne.

Gdzie zapisać plik i jak go włączyć

1. Zapisz konfigurację w /etc/apache2/sites-available/, np. jako example.com.conf.
2. Włącz witrynę poleceniem a2ensite example.com.conf — symlink pojawi się w sites-enabled/.
3. Przy SSL i przekierowaniu włącz moduły: a2enmod ssl rewrite proxy_fcgi setenvif.
4. Sprawdź składnię przez apache2ctl configtest (powinno zwrócić Syntax OK).
5. Przeładuj serwer przez systemctl reload apache2.

Ten sam serwer, wiele domen

Na tym polega sens VirtualHostów: jeden Apache obsługuje wiele witryn, bo dla każdego żądania dopasowuje nagłówek Host do właściwego ServerName. Każda domena dostaje własny plik w sites-available i osobne logi. Jeśli część reguł chcesz przenieść na Nginx w roli proxy, wyjątki dla pojedynczych ścieżek ułożysz w konfiguratorze bloków location Nginx.

Najczęściej zadawane pytania