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

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

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

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

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

Вручну внесені зміни можуть бути перезаписані під час оновлення ServBay, перезапуску сервісів або зміни конфігу через UI, що призведе до втрати ваших правок або непередбачених помилок.

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

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

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

Головна директорія конфігурації:

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

Це основна директорія з більшістю конфігураційних файлів веб-серверів (Nginx, Caddy, Apache), середовищ виконання (наприклад, php.ini для PHP), баз даних (фрагменти налаштувань MySQL, MariaDB), та інших сервісів (Redis, Memcached тощо).

Директорія баз даних:

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

Тут зберігаються основні дані баз даних, а також специфічні конфігураційні файли, наприклад, файли контролю доступу PostgreSQL.

Директорія загальних пакетів:

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

Тут розміщено спільні пакети, наприклад, OpenSSL, і відповідні конфігураційні файли.

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

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

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

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

• Nginx: Головна директорія конфігурації:

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

  Наприклад, для Nginx версії 1.25:

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

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

• Caddy: Головна директорія конфігурації:

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

  Основний файл Caddy:

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

• Apache: Головна директорія конфігурації:

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

  Для Apache 2.4:

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

  Налаштування віртуальних хостів тощо зазвичай у піддиректорії extra.

Середовища виконання (Language Runtimes)

Налаштування мовних середовищ (PHP, Python, Node.js, Go, Java тощо) організовані за назвою пакету і версією у головній директорії конфігурацій.

• PHP: Головна директорія конфігурації:

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

  Наприклад, для PHP 8.2 — файл php.ini:

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

  Налаштування PHP-FPM, як правило, теж у піддиректорії відповідної версії.

• Python: Налаштування Python здебільшого здійснюються за допомогою змінних середовища чи файлів у проекті. Головний виконуваний файл Python ServBay:

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

  Глобальні налаштування рідко зберігаються у головній директорії конфігурації ServBay.

• Node.js, Go, Java, Ruby, Rust, .NET: Як і у Python, конфігурації цих мов зазвичай залежать від проекту, змінних середовища чи інструментів відповідної екосистеми. ServBay надає лише середовище виконання або SDK; глобальні конфігурації не централізовані у ServBay.

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

Конфігураційні файли баз даних розміщено у головній директорії та окремих директоріях даних.

• MySQL / MariaDB: Головна директорія конфігурації:

  • macOS: /Applications/ServBay/etc/mysql (або /Applications/ServBay/etc/mariadb)
  • Windows: C:\ServBay\etc\mysql (або C:\ServBay\etc\mariadb)

  Для MySQL 8.0:

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

  Файл містить основні параметри бази даних.

• PostgreSQL: Основний конфіг знаходиться тут (по версіях):

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

  Для PostgreSQL 16:

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

  А специфічні файли доступу клієнтів pg_hba.conf та pg_ident.conf — в директорії даних (за версією):

  • 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: Для цих баз даних файли конфігурації — у головній директорії (по імені пакету і версії):

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

  Наприклад, Redis:

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

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

• OpenSSL: Файли конфігурації тут (за версією):

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

  Для OpenSSL 3.2:

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

• ACME (автоматичне отримання SSL-сертифікатів): Файли налаштувань та збереження сертифікатів ACME:

  • macOS: /Applications/ServBay/etc/acme або /Applications/ServBay/db/acme
  • Windows: C:\ServBay\etc\acme або C:\ServBay\db\acme

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

Іноді розробник має переглянути файл налаштувань для аналізу чи пошуку проблем. Слід дотримуватись наступної процедури (будьте обережні, не змінюйте файли вручну):

1. Перейдіть у директорію конфігурацій: Відкрийте командний інтерфейс і перейдіть у потрібну директорію.

   macOS (Terminal, iTerm2 тощо):

   # Переглянути директорію конфігурації Nginx
   cd /Applications/ServBay/etc/nginx/
   
   # Перейти до директорії pg_hba.conf PostgreSQL 16
   cd /Applications/ServBay/db/postgresql/16

   Windows (PowerShell або Командний рядок):

   # Переглянути директорію конфігурації Nginx
   cd C:\ServBay\etc\nginx\
   
   # Перейти до директорії pg_hba.conf PostgreSQL 16
   cd C:\ServBay\db\postgresql\16

2. Вивести список файлів: Виведіть доступні файли у директорії:

   macOS:

   ls

   Windows:

   # PowerShell
   Get-ChildItem
   # або коротко
   ls
   
   # Командний рядок
   dir

3. Переглянути вміст файлу: Відкрийте файл у текстовому переглядачі або редакторі (лише для перегляду, не зберігайте зміни!).

   macOS:

   # Переглянути nginx.conf Nginx
   cat nginx.conf
   # або з пагінацією
   less nginx.conf
   
   # Переглянути php.ini для PHP 8.2
   less /Applications/ServBay/etc/php/8.2/php.ini

   Windows:

   # PowerShell - переглянути nginx.conf Nginx
   Get-Content nginx.conf
   # з пагінацією
   more nginx.conf
   
   # Переглянути php.ini для PHP 8.2
   Get-Content C:\ServBay\etc\php\8.2\php.ini | more
   
   # Командний рядок
   type nginx.conf
   more nginx.conf

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

   macOS:

   # Перезапустити Nginx
   servbayctl restart nginx -all
   
   # Перезапустити PHP 8.2
   servbayctl restart php 8.2
   
   # Перезапустити всі сервіси
   servbayctl restart all

   Windows:

   # Перезапустити Nginx
   servbayctl.exe restart nginx -all
   
   # Перезапустити PHP 8.2
   servbayctl.exe restart php 8.2
   
   # Перезапустити всі сервіси
   servbayctl.exe restart all

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

• Питання: Чи можу я вручну змінити конфігураційний файл для тестування нестандартних налаштувань?

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

• Питання: Як ServBay управляє конфігураціями багатьох версій пакетів?

  Відповідь: Як зазначено у документі, ServBay для кожної версії пакету створює окрему піддиректорію у конфігураційному (/Applications/ServBay/etc або /Applications/ServBay/db на macOS; C:\ServBay\etc чи C:\ServBay\db на Windows), що дозволяє уникати конфліктів між версіями.

• Питання: Що робити, якщо я випадково видалив або зіпсував конфіг-файл?

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

Висновки

ServBay централізовано та структуровано управляє конфігураційними файлами, дотримуючись універсальної структури на всіх платформах:

• macOS: /Applications/ServBay/etc — основна директорія, додаткові — /Applications/ServBay/db, /Applications/ServBay/package/common
• Windows: C:\ServBay\etc — основна директорія, додаткові — C:\ServBay\db, C:\ServBay\package\common

Єдина структура спрощує автоматизацію керування конфігураціями на різних платформах, а також полегшує розробникам пошук та аналіз конфіг-файлів.

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