Розташування та керування конфігураційними файлами ServBay

ServBay — це потужне локальне середовище для веб-розробки, основною перевагою якого є гнучка конфігурація різноманітних пакетів (наприклад, веб-сервери, бази даних, інтерпретатори мов тощо). Для зручності керування та стабільної роботи середовище ServBay централізовано зберігає всі конфігураційні файли згідно зрозумілої ієрархії директорій. У цій статті докладно роз’яснюється, де розташовані конфігураційні файли ServBay, а також як розробнику знайти й переглянути ці важливі файли.

Важлива примітка: не редагуйте конфігураційні файли вручну

Конфігураційні файли ServBay генеруються програмою автоматично — відповідно до ваших змін у графічному інтерфейсі (UI). Будь ласка, не редагуйте напряму файли у /Applications/ServBay/etc чи інших каталогах ServBay.

Ручні зміни майже напевне буде перезаписано під час оновлень, перезапуску сервісу або нових змін через UI, що призведе до втрати ваших налаштувань і потенційних помилок.

Всі зміни слід здійснювати лише через офіційний графічний інтерфейс ServBay або за допомогою рекомендованих командних інструментів. Даний матеріал містить інформацію про розташування файлів для ознайомлення зі структурою ServBay або за потреби діагностування.

Огляд структури директорій

Конфігураційні файли ServBay згруповані у таких основних каталогах, структуровано за типами пакетів і версіями:

• /Applications/ServBay/etc: Головний каталог конфігурацій ServBay. Тут містяться налаштування більшості веб-серверів (Nginx, Caddy, Apache), мовних інтерпретаторів (наприклад, PHP — php.ini), баз даних (фрагменти конфігу MySQL, MariaDB), а також інших сервісів (Redis, Memcached тощо).
• /Applications/ServBay/db: Каталог призначений передусім для файлів даних баз даних, але тут можуть зберігатися й окремі специфічні конфіги (наприклад, файли доступу PostgreSQL).
• /Applications/ServBay/package/common: Тут знаходяться спільні пакети на кшталт OpenSSL, а також їхні конфігураційні файли.

Детальні шляхи до конфігураційних файлів пакетів

Нижче наведено приклади розташування конфігурацій для найбільш використовуваних пакетів у ServBay.

Веб-сервери (Web Servers)

Конфігурації веб-серверів розташовані в /Applications/ServBay/etc із піддиректоріями за відповідними назвами. ServBay підтримує співіснування кількох версій — конфіги рознесено по версіях:

• Nginx:
  Головний каталог конфігів: /Applications/ServBay/etc/nginx
  Наприклад, для Nginx версії 1.25 шлях:

  /Applications/ServBay/etc/nginx/1.25/nginx.conf

  Додаткові файли (сайтів, SSL тощо) також знаходяться у цій теці або її підкаталогах.

• Caddy:
  Головний каталог: /Applications/ServBay/etc/caddy
  Основний конфіг:

  /Applications/ServBay/etc/caddy/Caddyfile

• Apache:
  Головний каталог: /Applications/ServBay/etc/apache
  Для Apache 2.4 шлях до конфігу виглядає так:

  /Applications/ServBay/etc/apache/2.4/httpd.conf

  Конфігурації віртуальних хостів зазвичай зберігаються у підкаталозі extra.

Інтерпретатори мов (Language Runtimes)

Конфіги більшості інтерпретаторів (PHP, Python, Node.js, Go, Java тощо) також зберігаються у /Applications/ServBay/etc з поділом за назвою та версією.

• PHP:
  Головна тека: /Applications/ServBay/etc/php
  Наприклад, для PHP 8.2, шлях до php.ini:

  /Applications/ServBay/etc/php/8.2/php.ini

  Конфігурації PHP-FPM — в тому ж каталозі версії.

• Python:
  Зазвичай Python конфігурується через змінні середовища або локальні файли проекту. Інтерпретатор Python у ServBay розташовано у /Applications/ServBay/package/python/{version}/bin, глобальні налаштування через /etc відсутні.

• Node.js, Go, Java, Ruby, Rust, .NET:
  Аналогічно до Python — налаштування виконуються у межах проектів, через змінні середовища чи сторонні засоби. Глобальні конфіги не зберігаються у /Applications/ServBay/etc.

Бази даних (Databases)

Конфігурації БД розташовано у /Applications/ServBay/etc та /Applications/ServBay/db:

• MySQL / MariaDB:
  Головний каталог: /Applications/ServBay/etc/mysql (або /Applications/ServBay/etc/mariadb)
  Для MySQL 8.0 шлях:

  /Applications/ServBay/etc/mysql/8.0/my.cnf

  У цьому файлі — основні параметри БД.

• PostgreSQL:
  Головний конфіг у /Applications/ServBay/etc/postgresql з поділом по версіях.
  Для PostgreSQL 16:

  /Applications/ServBay/etc/postgresql/16/postgresql.conf

  А файли клієнтської автентифікації pg_hba.conf і pg_ident.conf розташовані у:

  /Applications/ServBay/db/postgresql/16/pg_hba.conf
  /Applications/ServBay/db/postgresql/16/pg_ident.conf

• MongoDB, Redis:
  Їхні конфіги також знайдете у /Applications/ServBay/etc, розподіл за іменами й версіями.
  Наприклад, для Redis:

  /Applications/ServBay/etc/redis/redis.conf

Інші сервіси та спільні пакети

• OpenSSL:
  Конфіг знаходиться у /Applications/ServBay/package/common/openssl із поділом за версіями.
  Для OpenSSL 3.2:

  /Applications/ServBay/package/common/openssl/3.2/openssl.cnf

• ACME (автоматизована заявка SSL-сертифікатів):
  Конфіги і сховище сертифікатів — у /Applications/ServBay/etc/acme або /Applications/ServBay/db/acme.

Як знаходити та переглядати конфігураційні файли

Хоча ручне редагування не рекомендується, іноді виникає потреба оглянути поточні налаштування або діагностувати проблему. Дотримуйтеся таких кроків:

1. Перейдіть у потрібний каталог:
   За допомогою терміналу (Terminal, iTerm2 тощо) зайдіть у відповідну директорію. Наприклад, щоб побачити конфіги Nginx:

   cd /Applications/ServBay/etc/nginx/

   Для перегляду директорії pg_hba.conf для PostgreSQL 16:

   cd /Applications/ServBay/db/postgresql/16

2. Перегляньте список файлів:
   Використовуйте команду ls:

   ls

3. Огляд змісту файлів:
   Скористайтеся текстовим переглядачем (cat, less, more) або редактором (vim, nano — тільки для перегляду, не зберігайте зміни!), наприклад, щоб переглянути nginx.conf:

   cat nginx.conf
   # або через less - для стрічкового перегляду
   less nginx.conf

   Для перегляду php.ini версії 8.2:

   less /Applications/ServBay/etc/php/8.2/php.ini

4. Перезапуск сервісу (після змін через ServBay UI):
   Після змін через UI зазвичай потрібно перезапустити потрібний сервіс через інтерфейс ServBay або утиліту servbayctl. Наприклад, для перезапуску Nginx:

   servbayctl restart nginx -all

   Перезапуск PHP 8.2:

   servbayctl restart php 8.2

   Перезапуск усіх сервісів:

   servbayctl restart all

Часті запитання (FAQ)

• Чи можна вручну змінювати конфіги для експериментів з розширеними налаштуваннями?

  Відповідь: Наполегливо не рекомендується. У графічному інтерфейсі ServBay доступна більшість базових налаштувань. Для значної гнучкості зверніться до документації щодо розширених налаштувань або до спільноти користувачів. Ручні зміни можуть бути швидко знищені.

• Яким чином ServBay керує конфігами для різних версій пакетів?

  Відповідь: Як і описано у цьому документі — для кожної версії пакета створюється своя піддиректорія всередині /Applications/ServBay/etc або /Applications/ServBay/db, тож різні версії не конфліктують між собою.

• Що робити, якщо я випадково видалив або пошкодив конфіг?

  Відповідь: Оскільки ServBay генерує файли автоматично, зазвичай достатньо внести навіть мінімальні зміни для відповідного пакета в UI — і конфіги буде пересоздано. У крайніх випадках можна спробувати скинути конфігурацію або звернутися у підтримку ServBay.

Підсумок

ServBay використовує централізовану і структуровану систему зберігання конфігурацій, основна частина якої розташована у /Applications/ServBay/etc, а також у /Applications/ServBay/db і /Applications/ServBay/package/common. Така організація спрощує автоматичне керування налаштуваннями і полегшує пошук файлів.

Розуміння цієї структури допоможе вам орієнтуватися у роботі ServBay і ефективно усувати проблеми. Знову наголошуємо: всі зміни потрібно вносити лише через офіційний інтерфейс чи інструменти ServBay, не редагуйте файли напряму — це гарантуватиме стабільність і надійність вашого оточення!