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.
- macOS:
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
- macOS:
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
.- macOS:
Ś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.
- macOS:
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.
- macOS:
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
(lubC:\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.
- macOS:
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
- macOS:
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
- macOS:
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
- macOS:
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
lubC:\ServBay\db\acme
- macOS:
Wyszukiwanie i przeglądanie plików konfiguracyjnych
Ręczna edycja nie jest zalecana, jednak warto wiedzieć, jak znaleźć i podejrzeć zawartość plików:
Przejdź do folderu z plikami konfiguracyjnymi:
Użyj terminala, aby nawigować do odpowiedniego katalogu.macOS (np.
Terminal
,iTerm2
):bash# 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
1
2
3
4
5Windows (
PowerShell
lubWiersz polecenia
):powershell# 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
1
2
3
4
5Wyświetl listę plików:
macOS:
bashls
1Windows:
powershell# PowerShell Get-ChildItem # Lub skrótowo ls # Wiersz polecenia dir
1
2
3
4
5
6
7Podgląd zawartości plików: Użyj narzędzi tekstowych lub edytora (wyłącznie do podglądu! Nie zapisuj zmian).
macOS:
bash# 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
1
2
3
4
5
6
7Windows:
powershell# 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
1
2
3
4
5
6
7
8
9
10
11Restart 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:
bash# Restart Nginx servbayctl restart nginx -all # Restart PHP 8.2 servbayctl restart php 8.2 # Restart wszystkich usług servbayctl restart all
1
2
3
4
5
6
7
8Windows:
powershell# 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
1
2
3
4
5
6
7
8
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
lubC:\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 oC:\ServBay\db
iC:\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.