Lokalizacja plików konfiguracyjnych i zarządzanie w ServBay

ServBay to rozbudowane lokalne środowisko programistyczne web, którego siłą jest elastyczna konfiguracja różnych pakietów (serwery WWW, bazy danych, środowiska uruchomieniowe języków itd.). Dla łatwego zarządzania i stabilności, ServBay przechowuje wszystkie pliki konfiguracyjne w scentralizowanej strukturze katalogów. W tym dokumencie znajdziesz szczegółowe informacje o lokalizacji plików konfiguracyjnych ServBay oraz wskazówki, jak je odnaleźć i przeglądać.

Ważna uwaga: Nigdy nie edytuj plików konfiguracyjnych ręcznie

Pliki konfiguracyjne ServBay są automatycznie generowane przez aplikację zgodnie z Twoimi ustawieniami w interfejsie UI. Nie należy edytować żadnych plików bezpośrednio w katalogu konfiguracyjnym ServBay.

• macOS: /Applications/ServBay/etc
• Windows: C:\ServBay\etc

Ręczna modyfikacja tych plików może zostać nadpisana przy aktualizacji ServBay, ponownym uruchamianiu usług lub przy kolejnych zmianach w UI, co może prowadzić do utraty zmian lub nieprzewidywanych błędów.

Wszystkie zmiany konfiguracji należy wprowadzać za pośrednictwem graficznego interfejsu użytkownika (UI) lub poprzez oficjalne narzędzia CLI ServBay, co gwarantuje trwałość i stabilność systemu. Informacje zawarte w tym dokumencie służą poznaniu struktury wewnętrznej ServBay lub są pomocne podczas diagnostyki.

Przegląd struktury katalogów

Pliki konfiguracyjne ServBay są posegregowane w kilku głównych katalogach w podziale według nazwy i wersji pakietu:

Główny katalog konfiguracji:

• macOS: /Applications/ServBay/etc
• Windows: C:\ServBay\etc

To podstawowy katalog z plikami konfiguracyjnymi: serwery WWW (Nginx, Caddy, Apache), środowiska języków (np. PHP — php.ini), bazy danych (MySQL, MariaDB) oraz dodatkowe usługi (Redis, Memcached).

Katalog bazy danych:

• macOS: /Applications/ServBay/db
• Windows: C:\ServBay\db

Gromadzi pliki danych bazodanowych, a w niektórych przypadkach także specyficzne pliki konfiguracyjne jak np. pliki dostępu PostgreSQL.

Katalog pakietów wspólnych:

• macOS: /Applications/ServBay/package/common
• Windows: C:\ServBay\package\common

Przechowuje pliki konfiguracji dla wspólnych pakietów, takich jak OpenSSL.

Lokalizacje plików konfiguracyjnych — wybrane pakiety

Wybrane przykłady lokalizacji plików konfiguracyjnych najważniejszych pakietów ServBay:

Serwery WWW

Pliki konfiguracyjne serwerów WWW przechowywane są w głównym katalogu konfiguracji, w podkatalogach z nazwą i wersją serwera.

• Nginx: Katalog główny konfiguracji:

  • macOS: /Applications/ServBay/etc/nginx
  • Windows: C:\ServBay\etc\nginx

  Przykład dla Nginx w wersji 1.25:

  • macOS: /Applications/ServBay/etc/nginx/1.25/nginx.conf
  • Windows: C:\ServBay\etc\nginx\1.25\nginx.conf

  Pozostałe pliki (np. konfiguracja stron, SSL) znajdują się w tym katalogu lub jego podkatalogach.

• Caddy: Katalog główny konfiguracji:

  • macOS: /Applications/ServBay/etc/caddy
  • Windows: C:\ServBay\etc\caddy

  Główny plik konfiguracji Caddy:

  • macOS: /Applications/ServBay/etc/caddy/Caddyfile
  • Windows: C:\ServBay\etc\caddy\Caddyfile

• Apache: Katalog główny konfiguracji:

  • macOS: /Applications/ServBay/etc/apache
  • Windows: C:\ServBay\etc\apache

  Przykład dla Apache w wersji 2.4:

  • macOS: /Applications/ServBay/etc/apache/2.4/httpd.conf
  • Windows: C:\ServBay\etc\apache\2.4\httpd.conf

  Konfiguracje dla wirtualnych hostów znajdują się zwykle w podkatalogu extra.

Środowiska uruchomieniowe języków

Pliki konfiguracyjne takich środowisk jak PHP, Python, Node.js, Go, Java itd. są również zorganizowane według nazwy i wersji w głównym katalogu konfiguracji.

• PHP: Katalog główny konfiguracji:

  • macOS: /Applications/ServBay/etc/php
  • Windows: C:\ServBay\etc\php

  Przykład dla PHP 8.2 (php.ini):

  • macOS: /Applications/ServBay/etc/php/8.2/php.ini
  • Windows: C:\ServBay\etc\php\8.2\php.ini

  Konfiguracja PHP-FPM jest również w tym katalogu.

• Python: Python zarządza konfiguracją głównie przez zmienne środowiskowe lub pliki projektowe. Główne pliki wykonywalne środowiska Python ServBay:

  • macOS: /Applications/ServBay/package/python/{version}/bin
  • Windows: C:\ServBay\package\python\{version}\bin

  Konfiguracje globalne Python nie są zarządzane w głównym katalogu ServBay.

• Node.js, Go, Java, Ruby, Rust, .NET: Podobnie jak Python, ich konfiguracje opierają się na plikach projektowych lub ustawieniach środowiskowych. ServBay udostępnia runtime/SDK; konfiguracje globalne nie są scentralizowane.

Bazy danych

Pliki konfiguracyjne baz danych są podzielone pomiędzy główny katalog konfiguracji i katalog z danymi.

• MySQL / MariaDB: Katalog główny konfiguracji:

  • macOS: /Applications/ServBay/etc/mysql (lub /Applications/ServBay/etc/mariadb)
  • Windows: C:\ServBay\etc\mysql (lub C:\ServBay\etc\mariadb)

  Przykład dla MySQL 8.0:

  • macOS: /Applications/ServBay/etc/mysql/8.0/my.cnf
  • Windows: C:\ServBay\etc\mysql\8.0\my.cnf

  Ten plik zawiera główne parametry konfiguracyjne bazy.

• PostgreSQL: Główne pliki konfiguracyjne PostgreSQL według wersji:

  • macOS: /Applications/ServBay/etc/postgresql
  • Windows: C:\ServBay\etc\postgresql

  Przykład dla PostgreSQL 16:

  • macOS: /Applications/ServBay/etc/postgresql/16/postgresql.conf
  • Windows: C:\ServBay\etc\postgresql\16\postgresql.conf

  Pliki związane z uwierzytelnianiem (pg_hba.conf, pg_ident.conf) znajdują się w katalogu bazy danych, również z podziałem na wersje:

  • macOS: /Applications/ServBay/db/postgresql/16/pg_hba.conf
  • macOS: /Applications/ServBay/db/postgresql/16/pg_ident.conf
  • Windows: C:\ServBay\db\postgresql\16\pg_hba.conf
  • Windows: C:\ServBay\db\postgresql\16\pg_ident.conf

• MongoDB, Redis: Pliki konfiguracyjne tych baz (i podobnych) znajdziesz w głównym katalogu w odpowiednich podkatalogach:

  • macOS: /Applications/ServBay/etc
  • Windows: C:\ServBay\etc

  Przykład dla Redis:

  • macOS: /Applications/ServBay/etc/redis/redis.conf
  • Windows: C:\ServBay\etc\redis\redis.conf

Inne usługi i pakiety wspólne

• OpenSSL: Pliki konfiguracyjne OpenSSL znajdują się w katalogu pakietów wspólnych, z podziałem na wersje:

  • macOS: /Applications/ServBay/package/common/openssl
  • Windows: C:\ServBay\package\common\openssl

  Przykład dla OpenSSL 3.2:

  • macOS: /Applications/ServBay/package/common/openssl/3.2/openssl.cnf
  • Windows: C:\ServBay\package\common\openssl\3.2\openssl.cnf

• ACME (automatyczne pobieranie certyfikatów SSL): Konfiguracja i magazyn certyfikatów ACME:

  • macOS: /Applications/ServBay/etc/acme lub /Applications/ServBay/db/acme
  • Windows: C:\ServBay\etc\acme lub C:\ServBay\db\acme

Wyszukiwanie i przeglądanie plików konfiguracyjnych

Ręczna edycja nie jest zalecana, jednak warto wiedzieć, jak znaleźć i podejrzeć zawartość plików:

1. Przejdź do folderu z plikami konfiguracyjnymi:
   Użyj terminala, aby nawigować do odpowiedniego katalogu.

   macOS (np. Terminal, iTerm2):

   # Przeglądanie katalogu konfiguracji Nginx
   cd /Applications/ServBay/etc/nginx/
   
   # Przeglądanie katalogu dla pg_hba.conf PostgreSQL 16
   cd /Applications/ServBay/db/postgresql/16

   Windows (PowerShell lub Wiersz polecenia):

   # Przeglądanie katalogu konfiguracji Nginx
   cd C:\ServBay\etc\nginx\
   
   # Przeglądanie katalogu dla pg_hba.conf PostgreSQL 16
   cd C:\ServBay\db\postgresql\16

2. Wyświetl listę plików:

   macOS:

   ls

   Windows:

   # PowerShell
   Get-ChildItem
   # Lub skrótowo
   ls
   
   # Wiersz polecenia
   dir

3. Podgląd zawartości plików: Użyj narzędzi tekstowych lub edytora (wyłącznie do podglądu! Nie zapisuj zmian).

   macOS:

   # Podgląd nginx.conf
   cat nginx.conf
   # Lub przeglądanie stronami
   less nginx.conf
   
   # Podgląd php.ini dla PHP 8.2
   less /Applications/ServBay/etc/php/8.2/php.ini

   Windows:

   # PowerShell — podgląd nginx.conf
   Get-Content nginx.conf
   # Lub przeglądanie stronami
   more nginx.conf
   
   # Podgląd php.ini dla PHP 8.2
   Get-Content C:\ServBay\etc\php\8.2\php.ini | more
   
   # Wiersz polecenia
   type nginx.conf
   more nginx.conf

4. Restart usług po zmianach z poziomu UI: Po zmianach dokonanych w UI, zwykle trzeba zrestartować daną usługę przez panel ServBay lub narzędzie servbayctl.

   macOS:

   # Restart Nginx
   servbayctl restart nginx -all
   
   # Restart PHP 8.2
   servbayctl restart php 8.2
   
   # Restart wszystkich usług
   servbayctl restart all

   Windows:

   # Restart Nginx
   servbayctl.exe restart nginx -all
   
   # Restart PHP 8.2
   servbayctl.exe restart php 8.2
   
   # Restart wszystkich usług
   servbayctl.exe restart all

Najczęściej zadawane pytania (FAQ)

• P: Czy mogę ręcznie modyfikować pliki konfiguracyjne, by testować zaawansowane ustawienia?

  O: Stanowczo odradza się takie działania. ServBay UI daje dostęp do najczęściej używanych opcji konfiguracji. Jeżeli wymagane są niestandardowe zmiany, nieobsługiwane przez UI, zapoznaj się z dokumentacją zaawansowanej konfiguracji lub skontaktuj ze społecznością ServBay. Zmiany ręczne są podatne na nadpisanie.

• P: Jak ServBay zarządza plikami konfiguracyjnymi dla różnych wersji pakietów?

  O: ServBay tworzy osobne podkatalogi dla każdej wersji i pakietu w głównych katalogach (/Applications/ServBay/etc lub /Applications/ServBay/db dla macOS, C:\ServBay\etc lub C:\ServBay\db dla Windows), dzięki czemu konfiguracje wersji nie wpływają na siebie wzajemnie.

• P: Co zrobić w przypadku przypadkowego usunięcia lub uszkodzenia plików konfiguracyjnych?

  O: ServBay automatycznie generuje pliki konfiguracyjne zgodnie z wbudowanymi szablonami i ustawieniami. Zwykle wystarczy dokonać dowolnej zmiany przez UI (może być drobna), by wymusić wygenerowanie pliku od nowa. W trudniejszych przypadkach można spróbować zresetować konfigurację lub skontaktować się z pomocą ServBay.

Podsumowanie

ServBay wykorzystuje scentralizowaną i uporządkowaną strukturę do zarządzania plikami konfiguracyjnymi:

• macOS: głównie /Applications/ServBay/etc, uzupełnione o /Applications/ServBay/db i /Applications/ServBay/package/common
• Windows: głównie C:\ServBay\etc, uzupełnione o C:\ServBay\db i C:\ServBay\package\common

Taka uniwersalna struktura pozwala ServBay łatwo zarządzać konfiguracją na każdej platformie oraz usprawnia wyszukiwanie i diagnostykę przez programistów.

Znajomość lokalizacji plików ułatwia zrozumienie działania ServBay i pomaga w rozwiązywaniu problemów. Jeszcze raz podkreślamy: wszelkie zmiany konfiguracji należy wprowadzać wyłącznie przez oficjalny UI lub narzędzia ServBay. Bezpośrednia edycja plików konfiguracyjnych może naruszyć stabilność środowiska.