Dodaj swoją pierwszą stronę internetową

W ServBay dodanie nowej strony internetowej i rozpoczęcie projektu lokalnego to proces prosty i intuicyjny. Ten przewodnik szczegółowo opisuje, jak dodać swoją pierwszą stronę w ServBay: od kroków operacyjnych, przez istotne opcje konfiguracyjne, aż po praktyczne wskazówki.

Niezależnie od tego, czy tworzysz projekt w PHP, Node.js, budujesz stronę statyczną, czy potrzebujesz skonfigurować reverse proxy lub przekierowania, ServBay zapewnia elastyczność i wszechstronne wsparcie.

Przegląd

ServBay został zaprojektowany jako potężne i łatwe w zarządzaniu lokalne środowisko dla web deweloperów. Intuicyjny, graficzny interfejs użytkownika (GUI) umożliwia szybkie dodawanie, konfigurowanie i zarządzanie wieloma lokalnymi stronami. Postępując według poniższych wskazówek, stworzysz swoją pierwszą lokalną stronę internetową w ServBay i zoptymalizujesz jej ustawienia zgodnie z wymaganiami projektu.

Wymagania wstępne

Przed rozpoczęciem upewnij się, że:

• ServBay został prawidłowo zainstalowany i uruchomiony na Twoim systemie macOS.

Kroki dodawania strony

Poniżej znajdziesz szczegółowy opis procesu dodawania nowej strony przez GUI ServBay:

Krok 1: Uruchom aplikację ServBay

Najpierw znajdź ikonę ServBay w folderze Aplikacje na macOS i kliknij dwukrotnie, aby uruchomić program.

Krok 2: Przejdź do panelu zarządzania stronami

Po uruchomieniu ServBay zobaczysz główny interfejs. W menu po lewej stronie kliknij opcję oznaczoną jako Strony. Przeniesie Cię to do panelu zarządzania stronami internetowymi.

Krok 3: Rozpocznij dodawanie nowej strony

Na stronie zarządzania znajdź i kliknij przycisk + w lewym dolnym rogu. Po kliknięciu po prawej stronie pojawi się nowy formularz, w którym możesz wprowadzić szczegóły nowej strony.

Krok 4: Skonfiguruj ustawienia strony

W nowym formularzu konfiguracyjnym należy uzupełnić/wskazać poniższe kluczowe informacje:

1. Nazwa: Wpisz łatwo rozpoznawalną nazwę strony lokalnej. Służy wyłącznie do zarządzania stronami w ServBay.
2. Domena: Podaj adres, pod jakim chcesz lokalnie odwiedzać stronę. Aby uniknąć konfliktów z prawdziwymi domenami, zdecydowanie zaleca się użycie TLD .demo lub innych lokalnych domen skonfigurowanych w ServBay, np. servbay.demo lub myproject.servbay.demo. ServBay automatycznie obsłuży lokalne rozwiązywanie DNS — wystarczy wpisać domenę w przeglądarce, aby otworzyć stronę.
3. Protokół: Wybierz obsługiwany protokół. Domyślnie poleca się HTTP/HTTPS — ServBay automatycznie skonfiguruje lokalny HTTPS.
4. Sposób uzyskania certyfikatu SSL: Skonfiguruj SSL/TLS dla lokalnej strony.
   • ServBay CA: Zalecane do lokalnego developmentu. ServBay automatycznie wygeneruje i zarządza certyfikatem SSL podpisanym przez własny, lokalny CA. Wystarczy zaufać wystawionemu przez ServBay certyfikatowi (ServBay User CA lub ServBay Public CA) w systemie, aby korzystać z HTTPS bez ostrzeżeń w przeglądarce.
   • ACME: Jeśli chcesz symulować środowisko produkcyjne, możesz skorzystać z protokołu ACME (np. Let's Encrypt, ZeroSSL, Google Trust Services) do uzyskania prawdziwego publicznego certyfikatu — pod warunkiem, że Twoja domena wskazuje na lokalną instancję ServBay i jest publicznie dostępna. ServBay wspiera automatyczne wystawianie i odnawianie certyfikatów ACME.
5. Typ strony: Wybierz odpowiedni typ zgodnie ze stackiem technologicznym projektu:
   • PHP: Dla projektów opartych o PHP, jak WordPress, Laravel, Symfony itd. ServBay skonfiguruje serwer WWW (Nginx lub Apache) z PHP-FPM.
   • Node.js: Dla aplikacji Node.js. ServBay zwykle tworzy reverse proxy, przekazując ruch do portu, na którym działa Twój serwer Node.js.
   • Statyczna: Dla stron składających się z plików HTML, CSS, JS. Serwer WWW bezpośrednio udostępnia pliki.
   • Reverse Proxy: Umożliwia przekierowanie żądań z tej domeny lub ścieżki do innego lokalnego/zdalnego adresu i portu — przydatne np. przy pośrednictwie ruchu do innych usług.
   • Przekierowanie: Wszystkie żądania skierowane na tę domenę są przekierowywane do innego URL.
6. Wersja PHP: Jeśli wybrano Typ strony = PHP, wybierz z listy zainstalowaną wersję PHP używaną do obsługi skryptów. Upewnij się, że potrzebna wersja PHP jest już zainstalowana w menedżerze pakietów ServBay.
7. Reguły przepisywania URL (rewrite/rewrites/URL rewrite rules): Większość nowoczesnych frameworków i CMS (np. Laravel, WordPress, Discuz! itp.) do estetycznych linków (np. /about zamiast /index.php?page=about) wymaga reguł przepisywania URL. ServBay oferuje gotowe profile do popularnych aplikacji, które możesz zastosować. Jeśli korzystasz z mniej znanego frameworka lub masz własne reguły, być może będziesz musiał ręcznie edytować konfigurację Nginx/Apache.
8. Katalog główny: Określ fizyczną ścieżkę do plików strony. To folder, z którego serwer WWW serwuje pliki. Zalecane jest przechowywanie projektu w domyślnym katalogu www ServBay, np. /Applications/ServBay/www/servbay-demo. Upewnij się, że folder istnieje i ServBay ma do niego prawa odczytu.

WARNING

Jeśli pracujesz z frameworkiem (np. Laravel), pamiętaj, by jako katalog główny wskazać folder public (z plikiem index.php), a nie katalog główny całego projektu.

Krok 5: Zapisz i aktywuj stronę

Po wprowadzeniu i sprawdzeniu wszystkich ustawień kliknij przycisk Dodaj na dole formularza. ServBay automatycznie wygeneruje konfigurację dla wybranego serwera WWW (np. Nginx lub Apache) i zaktualizuje lokalny DNS.

Po zapisaniu konfiguracja nowej strony pojawi się na liście stron. Aby szybko otworzyć stronę, kliknij ikonę przeglądarki w prawym górnym rogu.

Krok 6: Zarządzaj stroną przez szybkie opcje

ServBay oferuje zestaw wygodnych szybkich przycisków dla każdej strony na liście, co ułatwia zarządzanie środowiskiem programistycznym:

1. Otwórz w IDE: Szybkie otwieranie katalogu głównego strony w domyślnym edytorze kodu/IDE.
2. Otwórz w przeglądarce: Otwiera stronę w domyślnej przeglądarce WWW.
3. Zobacz logi strony: Łatwy dostęp do logów serwera WWW powiązanych z daną stroną, co przydaje się przy debugowaniu.
4. Wstrzymaj/uruchom stronę: Tymczasowo wyłącz lub ponownie włącz ruch na stronie.
5. Usuń stronę: Usuń konfigurację strony z ServBay (nie usuwa plików projektu!).

Przykład: Utwórz prostą statyczną stronę HTML

Aby sprawdzić, czy konfiguracja strony przebiegła pomyślnie, wykonaj prosty test:

1. Dodaj stronę według powyższych kroków, np. z domeną servbay.demo, typem Statyczna i katalogiem głównym /Applications/ServBay/www/servbay-demo-static.

2. Utwórz wskazany katalog główny /Applications/ServBay/www/servbay-demo-static w systemie plików.

3. W tym folderze utwórz plik index.html.

4. Otwórz index.html w edytorze tekstowym i dodaj poniższy kod HTML:

   <!DOCTYPE html>
   <html>
   <head>
       <title>ServBay Static Test</title>
   </head>
   <body>
       <h1>Gratulacje! Twoja pierwsza strona ServBay działa poprawnie!</h1>
       <p>Jeśli widzisz tę stronę, oznacza to, że ServBay został poprawnie skonfigurowany i serwuje Twój statyczny projekt.</p>
   </body>
   </html>

5. Zapisz plik index.html.

6. Wróć do panelu ServBay, znajdź stronę servbay.demo i kliknij ikonę przeglądarki.

7. Przeglądarka powinna otworzyć http://servbay.demo (lub https://servbay.demo, zależnie od ustawień SSL) i wyświetlić zawartość utworzonego index.html.

Wskazówki i uwagi

• Konflikt domeny: Unikaj używania domen, które mogą kolidować z lokalną siecią lub VPN. Bezpiecznym wyborem jest .demo.
• Uprawnienia do katalogu głównego: Upewnij się, że użytkownik uruchamiający ServBay (najczęściej Ty) ma prawo odczytu do katalogu głównego strony i jej podfolderów.
• Zajęte porty: ServBay korzysta z domyślnych portów (HTTP 80, HTTPS 443). Jeśli są zajęte przez inne procesy, serwer WWW w ServBay może nie działać lub strona być niedostępna. Zwolnij porty, jeśli to konieczne.
• Zaufanie do CA ServBay: Jeśli korzystasz z ServBay CA i chcesz uniknąć ostrzeżeń HTTPS, musisz zaufać odpowiedniemu certyfikatowi w systemie macOS. Szczegółowe instrukcje znajdują się w oficjalnej dokumentacji ServBay.

FAQ – Najczęściej zadawane pytania

• Q: Po otwarciu strony pojawia się komunikat HTTP Error 403 - Forbidden lub HTTP Error 404 - File not found?
  • A: To najczęstsze błędy wśród deweloperów.
  • Najpierw sprawdź, czy katalog główny strony jest prawidłowo ustawiony. W większości współczesnych frameworków (Laravel, Symfony, CakePHP itd.), ze względów bezpieczeństwa oraz organizacji projektu, główny katalog projektu (z plikami typu vendor, composer.json, package.json itd.) NIE jest katalogiem publicznym (root strony/entry point).
  • Dlatego musisz ustawić katalog główny strony tak, by wskazywał folder zawierający plik startowy: index.php, index.htm, index.html.
  • Typowe foldery wejściowe: public, web, www, htdocs, wwwroot, webroot itd.
• Q: Dodałem stronę, ale w przeglądarce mam komunikat „Nie można uzyskać dostępu do tej witryny” lub „Połączenie odrzucone”?
  • A: Najpierw upewnij się, że ServBay działa oraz że serwer WWW (Caddy/Nginx/Apache) jest aktywny (widoczne w głównym panelu ServBay).
  • Upewnij się, że domena wpisana w przeglądarce jest identyczna z tą skonfigurowaną w ServBay.
  • Sprawdź czy strona na liście ServBay ma status „uruchomiona”, nie „wstrzymana”.
  • Upewnij się, że ścieżka katalogu głównego jest poprawna i zawiera plik wejściowy (index.html, index.php).
  • Sprawdź czy żadna inna aplikacja nie wykorzystuje portów 80 lub 443.
• Q: Moja strona w PHP nie działa prawidłowo — pokazuje pustą stronę lub pobiera pliki zamiast je wyświetlać?
  • A: Sprawdź, czy wybrana została poprawna wersja PHP w konfiguracji strony i czy wersja ta jest zainstalowana oraz uruchomiona przez pakiet ServBay.
  • Skontroluj prawa dostępu do plików w katalogu głównym projektu.
  • Przejrzyj logi strony (poprzez szybkie opcje), czy są tam błędy PHP.
  • Sprawdź czy projekt zawiera index.php lub inny plik startowy zdefiniowany jako domyślny w ServBay.
• Q: Skonfigurowałem HTTPS, ale przeglądarka zgłasza ostrzeżenie dotyczące certyfikatu?
  • A: Jeśli korzystasz z ServBay CA, musisz zaufać root certyfikatowi ServBay w systemie lub przeglądarce. Skorzystaj z instrukcji w oficjalnej dokumentacji ServBay.
  • Jeśli używasz ACME, upewnij się, że domena wskazuje na instancję ServBay oraz że certyfikat został prawidłowo wystawiony i zainstalowany. Szczegóły procesu znajdziesz w logach ServBay.
• Q: Reguły przepisywania URL nie działają – strona nie otwiera się poprawnie?
  • A: Upewnij się, że w konfiguracji strony wybrałeś odpowiedni zestaw reguł przepisywania URL dla Twojego frameworka.
  • Jeśli używasz Apache, sprawdź czy plik .htaccess znajduje się w katalogu strony lub podkatalogach i czy konfiguracja ServBay umożliwia korzystanie z .htaccess.
  • Przy korzystaniu z Nginx lub Caddy reguły rewrite są ustawiane w automatycznie generowanych plikach konfiguracyjnych — sprawdź, czy są poprawnie załadowane.

Podsumowanie

Po wykonaniu powyższych kroków powinieneś bez problemu dodać i uruchomić swoją pierwszą stronę internetową w środowisku lokalnym ServBay. Zaawansowane zarządzanie stronami internetowymi, elastyczne ustawienia (SSL, typ strony, wersja PHP, rewrite URL) oraz wygodne opcje szybkiego dostępu w ServBay znacząco usprawnią Twój proces tworzenia stron. Kontynuuj eksperymenty z funkcjami takimi jak zarządzanie pakietami czy bazami danych, by stworzyć w pełni funkcjonalny lokalny workflow programistyczny.