Lokasi & Pengurusan Fail Konfigurasi ServBay
ServBay ialah persekitaran pembangunan web tempatan yang cukup berkuasa, menawarkan fleksibiliti dalam mengkonfigurasi pelbagai pakej seperti pelayan web, pangkalan data dan persekitaran bahasa pengaturcaraan. Demi kemudahan pengurusan dan kestabilan sistem, ServBay mengumpulkan semua fail konfigurasi mengikut struktur direktori yang jelas. Artikel ini menerangkan dengan terperinci lokasi fail konfigurasi ServBay dan cara pembangun mencari serta melihat fail penting ini.
DANGER
Peringatan Penting: Jangan ubah fail konfigurasi secara manual
Fail konfigurasi ServBay dihasilkan secara automatik oleh aplikasi berdasarkan tetapan anda (melalui antaramuka UI). Jangan sesekali mengedit fail konfigurasi secara manual di direktori konfigurasi ServBay.
- macOS:
/Applications/ServBay/etc
- Windows:
C:\ServBay\etc
Jika fail diubah manual, perubahan tersebut mungkin akan hilang atau menyebabkan error tidak dijangka apabila ServBay dikemas kini, servis diulang mula, atau konfigurasi diubah melalui UI.
Lakukan semua perubahan konfigurasi hanya melalui antaramuka grafik ServBay (UI) atau alat baris perintah rasmi untuk memastikan perubahan kekal dan kestabilan sistem terjamin. Maklumat laluan fail di sini bertujuan sebagai rujukan untuk pemahaman struktur dalaman atau penjejakkan masalah sahaja.
Ringkasan Struktur Direktori
Fail konfigurasi ServBay tertumpu pada beberapa direktori teras utama, dikategorikan mengikut nama dan versi pakej.
Direktori konfigurasi utama:
- macOS:
/Applications/ServBay/etc
- Windows:
C:\ServBay\etc
Ini ialah lokasi utama untuk fail konfigurasi kebanyakan pelayan web (Nginx, Caddy, Apache), persekitaran bahasa (seperti php.ini
untuk PHP), pangkalan data (MySQL, MariaDB) serta servis lain (Redis, Memcached).
Direktori pangkalan data:
- macOS:
/Applications/ServBay/db
- Windows:
C:\ServBay\db
Direktori ini menempatkan fail data pangkalan data serta beberapa fail konfigurasi spesifik contohnya fail kawalan akses PostgreSQL.
Direktori pakej umum:
- macOS:
/Applications/ServBay/package/common
- Windows:
C:\ServBay\package\common
Di sini tersimpan pakej umum seperti OpenSSL beserta fail konfigurasi berkaitan.
Lokasi Fail Konfigurasi Pakej
Berikut adalah contoh lokasi fail konfigurasi beberapa pakej utama ServBay:
Pelayan Web (Web Servers)
Fail konfigurasi pelayan web biasanya berada di direktori utama konfigurasi ServBay, dengan subdirektori mengikut nama pakej dan versi masing-masing.
Nginx: Direktori konfigurasi utama:
- macOS:
/Applications/ServBay/etc/nginx
- Windows:
C:\ServBay\etc\nginx
Contoh laluan fail konfigurasi untuk Nginx versi 1.25:
- macOS:
/Applications/ServBay/etc/nginx/1.25/nginx.conf
- Windows:
C:\ServBay\etc\nginx\1.25\nginx.conf
Fail berkaitan (config laman web, SSL) juga disusun di dalam atau bawah direktori ini.
- macOS:
Caddy: Direktori konfigurasi utama:
- macOS:
/Applications/ServBay/etc/caddy
- Windows:
C:\ServBay\etc\caddy
Fail konfigurasi utama Caddy:
- macOS:
/Applications/ServBay/etc/caddy/Caddyfile
- Windows:
C:\ServBay\etc\caddy\Caddyfile
- macOS:
Apache: Direktori konfigurasi utama:
- macOS:
/Applications/ServBay/etc/apache
- Windows:
C:\ServBay\etc\apache
Contoh laluan konfigurasi untuk Apache versi 2.4:
- macOS:
/Applications/ServBay/etc/apache/2.4/httpd.conf
- Windows:
C:\ServBay\etc\apache\2.4\httpd.conf
Konfigurasi virtual host, dsb. biasanya dalam subdirektori
extra
.- macOS:
Persekitaran Bahasa (Language Runtimes)
Konfigurasi untuk pelbagai bahasa seperti PHP, Python, Node.js, Go dan Java juga berada di direktori utama, dikategorikan nama bahasa dan versi.
PHP: Direktori konfigurasi utama:
- macOS:
/Applications/ServBay/etc/php
- Windows:
C:\ServBay\etc\php
Contoh laluan untuk PHP versi 8.2:
- macOS:
/Applications/ServBay/etc/php/8.2/php.ini
- Windows:
C:\ServBay\etc\php\8.2\php.ini
Fail konfigurasi PHP-FPM juga diletakkan dalam direktori versi tersebut.
- macOS:
Python: Konfigurasi Python biasanya dikendalikan melalui pembolehubah persekitaran atau fail dalam projek. Python yang disediakan oleh ServBay boleh dijumpai di:
- macOS:
/Applications/ServBay/package/python/{version}/bin
- Windows:
C:\ServBay\package\python\{version}\bin
Konfigurasi global jarang melalui direktori utama ServBay.
- macOS:
Node.js, Go, Java, Ruby, Rust, .NET: Seperti Python, bahasa ini lebih bergantung kepada fail projek atau pembolehubah persekitaran. ServBay menyediakan runtime/SDK; fail konfigurasi global tidak dikumpulkan di direktori utama.
Pangkalan Data (Databases)
Fail konfigurasi pangkalan data bertaburan di direktori utama dan direktori data ServBay.
MySQL / MariaDB: Direktori konfigurasi utama:
- macOS:
/Applications/ServBay/etc/mysql
(atau/Applications/ServBay/etc/mariadb
) - Windows:
C:\ServBay\etc\mysql
(atauC:\ServBay\etc\mariadb
)
Contoh laluan untuk fail konfigurasi MySQL versi 8.0:
- macOS:
/Applications/ServBay/etc/mysql/8.0/my.cnf
- Windows:
C:\ServBay\etc\mysql\8.0\my.cnf
Fail ini merangkumi parameter utama konfigurasi pangkalan data.
- macOS:
PostgreSQL: Fail konfigurasi utama mengikut versi berada di:
- macOS:
/Applications/ServBay/etc/postgresql
- Windows:
C:\ServBay\etc\postgresql
Contoh untuk PostgreSQL versi 16:
- macOS:
/Applications/ServBay/etc/postgresql/16/postgresql.conf
- Windows:
C:\ServBay\etc\postgresql\16\postgresql.conf
Fail konfigurasi autentikasi pelanggan seperti
pg_hba.conf
danpg_ident.conf
berada di direktori pangkalan data, juga mengikut versi:- 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: Konfigurasi pangkalan data ini biasanya dalam direktori utama mengikut nama dan versi:
- macOS:
/Applications/ServBay/etc
- Windows:
C:\ServBay\etc
Contoh laluan konfigurasi untuk Redis:
- macOS:
/Applications/ServBay/etc/redis/redis.conf
- Windows:
C:\ServBay\etc\redis\redis.conf
- macOS:
Servis Lain & Pakej Umum
OpenSSL: Fail konfigurasi berada di direktori pakej umum, mengikut versi:
- macOS:
/Applications/ServBay/package/common/openssl
- Windows:
C:\ServBay\package\common\openssl
Contoh untuk OpenSSL versi 3.2:
- macOS:
/Applications/ServBay/package/common/openssl/3.2/openssl.cnf
- Windows:
C:\ServBay\package\common\openssl\3.2\openssl.cnf
- macOS:
ACME (untuk permohonan automatik SSL): Konfigurasi dan simpanan sijil ACME biasanya terdapat di:
- macOS:
/Applications/ServBay/etc/acme
atau/Applications/ServBay/db/acme
- Windows:
C:\ServBay\etc\acme
atauC:\ServBay\db\acme
- macOS:
Cara Mencari & Melihat Kandungan Fail Konfigurasi
Walaupun pengeditan manual tidak digalakkan, pembangun kadang-kadang perlu melihat konfigurasi untuk diagnosis atau pemahaman tetapan semasa. Berikut ialah langkah untuk mencari dan melihat fail tersebut:
Navigasi ke direktori fail konfigurasi: Gunakan baris perintah untuk mengakses direktori yang diingini.
macOS (gunakan
Terminal
,iTerm2
dsb):bash# Lihat direktori konfigurasi Nginx cd /Applications/ServBay/etc/nginx/ # Lihat direktori pg_hba.conf PostgreSQL 16 cd /Applications/ServBay/db/postgresql/16
1
2
3
4
5Windows (gunakan
PowerShell
atauCommand Prompt
):powershell# Lihat direktori konfigurasi Nginx cd C:\ServBay\etc\nginx\ # Lihat direktori pg_hba.conf PostgreSQL 16 cd C:\ServBay\db\postgresql\16
1
2
3
4
5Senaraikan fail: Lihat senarai kandungan direktori.
macOS:
bashls
1Windows:
powershell# PowerShell Get-ChildItem # atau ringkas ls # Command Prompt dir
1
2
3
4
5
6
7Lihat kandungan fail: Guna penampil teks atau editor (sekadar untuk melihat, jangan simpan-ubah).
macOS:
bash# Lihat fail nginx.conf Nginx cat nginx.conf # atau lihat secara berhalaman less nginx.conf # Lihat fail php.ini PHP 8.2 less /Applications/ServBay/etc/php/8.2/php.ini
1
2
3
4
5
6
7Windows:
powershell# PowerShell - lihat fail nginx.conf Nginx Get-Content nginx.conf # atau paparan berhalaman more nginx.conf # Lihat fail php.ini PHP 8.2 Get-Content C:\ServBay\etc\php\8.2\php.ini | more # Command Prompt type nginx.conf more nginx.conf
1
2
3
4
5
6
7
8
9
10
11Ulang mula servis (Jika telah lakukan perubahan melalui UI ServBay): Selepas mengubah konfigurasi menggunakan UI ServBay, anda biasanya perlu ulang mula servis untuk kemaskini tetapan. Guna antaramuka ServBay atau
servbayctl
untuk tujuan ini.macOS:
bash# Ulang mula servis Nginx servbayctl restart nginx -all # Ulang mula servis PHP 8.2 servbayctl restart php 8.2 # Ulang mula semua servis servbayctl restart all
1
2
3
4
5
6
7
8Windows:
powershell# Ulang mula servis Nginx servbayctl.exe restart nginx -all # Ulang mula servis PHP 8.2 servbayctl.exe restart php 8.2 # Ulang mula semua servis servbayctl.exe restart all
1
2
3
4
5
6
7
8
Soalan Lazim (FAQ)
Soalan: Bolehkah saya ubah fail konfigurasi secara manual untuk ujian advanced?
Jawapan: Sangat tidak digalakkan! ServBay UI menawarkan hampir semua tetapan lazim. Untuk keperluan lanjutan yang tiada di UI, rujuk dokumentasi konfigurasi lanjutan atau komuniti ServBay. Fail yang diubah manual mudah ditulis semula oleh sistem.
Soalan: Bagaimana ServBay urus fail konfigurasi banyak versi?
Jawapan: Seperti diterangkan, ServBay mewujudkan subdirektori berasingan untuk setiap versi pakej dalam direktori konfigurasi (
/Applications/ServBay/etc
atau/Applications/ServBay/db
bagi macOS;C:\ServBay\etc
atauC:\ServBay\db
bagi Windows), memastikan setiap versi terasing dari segi konfigurasi.Soalan: Apa yang harus saya lakukan jika fail konfigurasi terpadam atau rosak?
Jawapan: ServBay menjana semula fail dari template mengikut tetapan anda. Biasanya, anda cuma perlu buat perubahan kecil konfigurasi melalui UI, dan fail akan digenerate semula. Untuk kes kritikal, cuba reset konfigurasi atau hubungi sokongan ServBay.
Rumusan
ServBay menggunakan pengurusan fail konfigurasi yang berpusat dan berstruktur, di mana:
- macOS: Utama di
/Applications/ServBay/etc
; tambahan di/Applications/ServBay/db
&/Applications/ServBay/package/common
- Windows: Utama di
C:\ServBay\etc
; tambahan diC:\ServBay\db
&C:\ServBay\package\common
Reka bentuk struktur ini membolehkan ServBay mengurus konfigurasi secara automatik pada platform berbeza dan memudahkan pembangun menjejak serta menyelesaikan masalah.
Memahami lokasi fail ini sangat penting untuk mendalami cara kerja ServBay dan membuat penyelesaian masalah. Sekali lagi ditekankan, lakukan semua perubahan konfigurasi hanya melalui antaramuka rasmi atau alat ServBay – jangan ubah fail secara manual – demi kestabilan dan kebolehpercayaan persekitaran ServBay anda.