Hướng dẫn chi tiết cài đặt và sử dụng ServBay

Bạn là một lập trình viên đang đau đầu với việc quản lý nhiều phiên bản PHP, Node.js, Python trên cùng một máy? Bạn mất hàng giờ đồng hồ để cấu hình database, web server, SSL certificate cho từng dự án? Bạn mệt mỏi với việc các project khác nhau yêu cầu môi trường khác nhau, và Docker lại quá nặng nề cho nhu cầu phát triển local?

ServBay xuất hiện như một giải pháp toàn diện cho tất cả những vấn đề trên—một môi trường phát triển web tích hợp hoàn chỉnh, được thiết kế đặc biệt cho developer, giúp bạn cài đặt và quản lý hàng chục công nghệ chỉ với vài cú click chuột.

ServBay là gì?

ServBay là một công cụ quản lý môi trường phát triển web đa chức năng, tích hợp đầy đủ các dịch vụ cần thiết cho developer—từ web server, database, đến nhiều ngôn ngữ lập trình—tất cả trong một ứng dụng duy nhất trên macOS và Windows.

Khác với các giải pháp như MAMP, XAMPP, hay Laragon, ServBay không chỉ đơn thuần là một “stack” cố định. Nó là một nền tảng quản lý môi trường toàn diện cho phép bạn:

• Cài đặt và chạy nhiều phiên bản của cùng một công nghệ đồng thời
• Cấu hình môi trường riêng biệt cho từng project
• Quản lý tất cả thông qua giao diện đồ họa đẹp mắt và trực quan
• Tạo domain tùy chỉnh với SSL certificate tự động miễn phí
• Tích hợp AI development với Ollama

Tính năng nổi bật của ServBay

1. Hỗ trợ đa ngôn ngữ lập trình

ServBay hỗ trợ một loạt các ngôn ngữ lập trình phổ biến với nhiều phiên bản:

• PHP: Từ PHP 5.6 cũ đến PHP 8.5 mới nhất
• Node.js: Từ Node.js 12 đến Node.js 23
• Python: Từ Python 2.7 (legacy) đến Python 3.14
• Go: Go 1.11 đến Go 1.24
• Java: OpenJDK 7 đến OpenJDK 24 (với Maven tích hợp)
• Ruby: Ruby 2.4 đến Ruby 3.4
• Rust, .NET (2.0-10.0), Mono: Hỗ trợ đầy đủ

2. Database toàn diện

Tất cả các database phổ biến đều có sẵn với nhiều phiên bản:

• MySQL: 5.1 đến 9.1
• MariaDB: 10.4 đến 11.5
• PostgreSQL: 10 đến 16
• MongoDB: 5.0 đến 8.0
• Redis: Cache và message broker
• Memcached: High-performance caching
• SQLite: Lightweight database

Đi kèm với phpMyAdmin và Adminer để quản lý database dễ dàng.

3. Web Server mạnh mẽ

ServBay tích hợp ba web server hiện đại nhất:

• Caddy: Hiện đại, tự động HTTPS, HTTP/3
• NGINX: Hiệu suất cao, popular nhất
• Apache: Classic và đáng tin cậy

Tất cả đều hỗ trợ HTTP/3, CORS, và cấu hình SSL tự động.

4. Tính năng độc đáo

• SSL Certificate Tự Động: ServBay tích hợp hệ thống PKI, tự động tạo và cấu hình SSL certificate cho tất cả domain local, không cần đăng ký hay cấu hình phức tạp.
• Custom Domain Dễ Dàng: Sử dụng domain như myproject.local hoặc app.dev thay vì localhost:8080/myproject.
• Email Testing với Mailpit: Capture tất cả email từ ứng dụng của bạn, xem và debug trong giao diện web đẹp mắt mà không lo email test rò rỉ ra ngoài.
• AI Development với Ollama: Chạy các Large Language Model (LLM) như Llama 3, Mistral, DeepSeek ngay trên máy local với quyền riêng tư tuyệt đối.​
• Search Engine: Tích hợp Typesense và Meilisearch để thêm chức năng tìm kiếm mạnh mẽ vào project.
• Object Storage với MinIO: Quản lý unstructured data với S3-compatible storage service.
• Backup & Restore: Sao lưu toàn bộ cấu hình, database, và file với một cú click.

Lợi ích so với các giải pháp khác

ServBay vs Docker

ServBay vs MAMP/XAMPP/Laragon

Điểm mạnh của ServBay:

• Multi-version: Chạy PHP 7.4 và PHP 8.2 cùng lúc
• Custom domains: Không giới hạn số domain, tự động SSL
• Phiên bản linh hoạt: Từ legacy đến latest version
• Cross-platform: macOS + Windows
• AI Integration: Ollama tích hợp sẵn
• Modern stack: HTTP/3, PKI system, DNS service

Yêu cầu hệ thống

macOS

• Hệ điều hành: macOS 10.15 (Catalina) trở lên
• RAM: Tối thiểu 4GB (khuyến nghị 8GB+)
• Ổ đĩa: 2GB cho installer + không gian cho packages

Windows

• Hệ điều hành: Windows 10/11 (64-bit)
• Framework: .NET 9 (tự động cài đặt nếu chưa có)
• RAM: Tối thiểu 4GB (khuyến nghị 8GB+)
• Ổ đĩa: 2GB cho installer + không gian cho packages

Lưu ý trước khi cài đặt

Kiểm tra port conflicts: ServBay cần các port sau không bị chiếm dụng:

• Port 80 (HTTP), 443 (HTTPS): Web servers
• Port 3306: MySQL/MariaDB
• Port 5432: PostgreSQL
• Port 27017: MongoDB
• Port 6379: Redis
• Port 53: DNS service

Kiểm tra port đang sử dụng:

# macOS/Linux
lsof -i :80

# Windows
netstat -ano | findstr :80

Nếu port đang được sử dụng, dừng service đó trước khi cài ServBay.

Hướng dẫn cài đặt ServBay

Bước 1: Tải ServBay

Truy cập trang download chính thức: https://www.servbay.com/download

Chọn phiên bản phù hợp với hệ điều hành của bạn:

• macOS: Tải file .dmg (ví dụ: ServBayInstaller-v1.17.0.dmg)
• Windows: Tải file .exe (ví dụ: ServBayInstaller-v1.17.0.exe)

File installer chỉ khoảng 20MB, download rất nhanh.

Bước 2: Cài đặt ServBay

Trên macOS

1. Mở file DMG: Double-click file .dmg vừa tải về
2. Kéo vào Applications: Trong cửa sổ hiện ra, kéo icon ServBay.app vào thư mục Applications
3. Khởi động: Mở thư mục Applications, tìm và double-click ServBay

Trên Windows

1. Chạy Installer: Double-click file .exe vừa tải về
2. Chọn đường dẫn cài đặt: Khuyến nghị cài vào C:\ServBay để hiệu suất tốt nhất
3. Hoàn tất cài đặt: Làm theo hướng dẫn trên màn hình
4. Khởi động: Mở ServBay từ Start Menu hoặc desktop shortcut

Đặc biệt: Phiên bản Windows không cần initialization, đã cài sẵn Nginx và PHP, bạn có thể dùng ngay!

Bước 3: Khởi tạo ServBay (macOS)

Khi mở ServBay lần đầu trên macOS, bạn sẽ thấy màn hình khởi tạo:

1. Chọn vai trò của bạn:
   • Web Developer
   • Full Stack Developer
   • PHP Developer
   • Python Developer
   • Node.js Developer
   • v.v.
2. Xem packages mặc định: Bên phải sẽ hiển thị các package được đề xuất cho vai trò bạn chọn
3. Click “Start Installation”: Bắt đầu quá trình cài đặt
4. Cấp quyền Administrator:
   • macOS sẽ yêu cầu password của bạn để cài đặt ServBay Helper
   • Điều này cần thiết để quản lý services và port binding
5. Chờ cài đặt: Quá trình tải về và cấu hình packages mất vài phút tùy thuộc vào kết nối internet
6. Hoàn tất: Sau khi xong, bạn sẽ được đưa đến dashboard chính

Chúc mừng! ServBay đã sẵn sàng để sử dụng.

Hướng dẫn sử dụng ServBay

1. Cài Đặt Package Mới

Sau khi khởi tạo, bạn có thể cài thêm các package khác:

Bước 1: Mở Packages Manager

• Trong ServBay, click vào Packages ở menu bên trái
• Bạn sẽ thấy danh sách tất cả packages có sẵn

Bước 2: Chọn Package cần cài

Ví dụ: Cài đặt PHP 7.1

1. Tìm PHP 7.1 trong danh sách
2. Current Version hiển thị - (chưa cài)
3. Latest Version hiển thị phiên bản mới nhất (ví dụ: 7.1.33)

Bước 3: Click Install

• Bên phải package, click nút Install (icon download màu xanh)
• ServBay sẽ tự động download và cài đặt
• Theo dõi tiến trình cài đặt trên màn hình

Bước 4: Hoàn tất

• Sau khi cài xong, package tự động start (nếu là service)
• Status chuyển thành Running
• Current Version cập nhật thành 7.1.33

2. Tạo Website/Project đầu tiên

Bước 1: Vào Hosts Manager

• Click Hosts trong menu bên trái
• Đây là nơi quản lý tất cả websites/projects của bạn

Bước 2: Tạo New Host

• Click nút Add Host hoặc +
• Điền thông tin project:

Name: my-laravel-app
Domain: myapp.local
Document Root: /Users/vnrom/Projects/my-laravel-app/public
PHP Version: PHP 8.2
Web Server: Nginx

Bước 3: Cấu hình SSL (Tùy chọn)

• Bật Enable HTTPS
• ServBay tự động tạo SSL certificate
• Không cần cấu hình gì thêm!

Bước 4: Lưu và khởi động

• Click Save
• Website của bạn ngay lập tức có thể truy cập tại:
  • http://myapp.local
  • https://myapp.local (nếu bật SSL)

Không cần chỉnh sửa file hosts, ServBay tự động xử lý DNS!

3. Chuyển đổi phiên bản PHP cho Project

Một trong những tính năng mạnh nhất của ServBay là per-project version management:

Bước 1: Mở cấu hình Project

• Vào Hosts → Chọn project cần thay đổi
• Click Edit

Bước 2: Chọn PHP version mới

• Trong dropdown PHP Version, chọn phiên bản khác (ví dụ: PHP 7.4)
• Click Save

Bước 3: Reload

• ServBay tự động reload web server
• Project ngay lập tức chạy với PHP 7.4

Các project khác vẫn chạy với PHP version riêng của chúng, không bị ảnh hưởng!

4. Quản lý database

Tạo database mới

Cách 1: Qua GUI

1. Vào Services → MySQL (hoặc PostgreSQL, MariaDB)
2. Click Open phpMyAdmin (hoặc Adminer)
3. Tạo database mới trong phpMyAdmin/Adminer

Cách 2: Qua Command Line

# Kết nối đến MySQL
mysql -u root -h 127.0.0.1

# Tạo database
CREATE DATABASE my_new_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

# Tạo user
CREATE USER 'myuser'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON my_new_db.* TO 'myuser'@'localhost';
FLUSH PRIVILEGES;

Thông tin kết nối

ServBay sử dụng cấu hình mặc định sau:

MySQL/MariaDB:

Host: 127.0.0.1
Port: 3306
User: root
Password: (không có password mặc định)

PostgreSQL:

Host: 127.0.0.1
Port: 5432
User: postgres
Password: (không có password mặc định)

MongoDB:

Host: 127.0.0.1
Port: 27017

5. Email Testing với Mailpit

ServBay tích hợp Mailpit để capture và debug email:

Bước 1: Bật Mailpit Service

• Vào Services → Tìm Mailpit
• Click Start nếu chưa chạy

Bước 2: Cấu Hình Ứng Dụng

Trong ứng dụng của bạn (Laravel, WordPress, v.v.), cấu hình SMTP:

SMTP Host: 127.0.0.1
SMTP Port: 1025
SMTP Username: (để trống)
SMTP Password: (để trống)
SMTP Encryption: None

Ví dụ Laravel (.env):

MAIL_MAILER=smtp
MAIL_HOST=127.0.0.1
MAIL_PORT=1025
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null

Bước 3: Xem Email

• Mở browser và truy cập http://localhost:8025
• Tất cả email từ ứng dụng sẽ xuất hiện ở đây
• Xem HTML source, attachments, headers, v.v.

6. Sử dụng Node.js

ServBay hỗ trợ Node.js từ version 12 đến 23:

Cài đặt Node.js Version

1. Vào Packages → Tìm Node.js
2. Chọn version cần dùng (ví dụ: Node.js 20)
3. Click Install

Chạy Node.js Application

Cách 1: Reverse Proxy

ServBay có thể reverse proxy ứng dụng Node.js của bạn:

1. Chạy ứng dụng Node.js trên port local (ví dụ: 3000)

cd /path/to/your/nodejs-app
node app.js

2. Trong ServBay Hosts, tạo host mới:

Domain: nodeapp.local
Type: Reverse Proxy
Target: http://127.0.0.1:3000

3. Truy cập http://nodeapp.local để xem ứng dụng

Cách 2: Chạy trực tiếp

# Node.js và npm đã có sẵn trong PATH
node -v
npm -v

# Chạy project
npm install
npm start

7. AI Development với Ollama

ServBay v1.12+ tích hợp Ollama để chạy LLM local:

Bước 1: Cài Ollama

• Vào Packages → Tìm Ollama
• Click Install

Bước 2: Download Model

# Trong terminal
ollama pull llama3.3
ollama pull deepseek-r1
ollama pull mistral

Bước 3: Sử dụng trong code

REST API:

curl http://localhost:11434/api/generate -d '{
  "model": "llama3.3",
  "prompt": "Why is the sky blue?"
}'

Python Example:

import requests
import json

response = requests.post('http://localhost:11434/api/generate',
    json={
        'model': 'llama3.3',
        'prompt': 'Explain quantum computing in simple terms'
    })

print(response.json())

Node.js Example:

const axios = require('axios');

axios.post('http://localhost:11434/api/generate', {
    model: 'llama3.3',
    prompt: 'Write a haiku about coding'
})
.then(response => {
    console.log(response.data);
});

Mẹo và thủ thuật

1. Backup và restore

Backup:

• Vào Settings → Backup
• Click Create Backup
• ServBay sẽ backup:
  • Tất cả cấu hình services
  • Databases
  • Site configurations
  • (Tùy chọn) Site files

Restore:

• Settings → Backup → Chọn backup cần restore
• Click Restore

2. Monitoring Resource Usage

• Vào Dashboard để xem real-time:
  • CPU usage của từng service
  • Memory consumption
  • Disk usage
  • Network activity

3. Xử lý Port Conflicts

Nếu gặp lỗi “Port already in use”:

# Tìm process đang dùng port
lsof -i :80  # macOS/Linux
netstat -ano | findstr :80  # Windows

# Kill process (thay PID)
kill -9 <PID>  # macOS/Linux
taskkill /PID <PID> /F  # Windows

4. Custom DNS

ServBay có built-in DNS service, bạn có thể:

• Sử dụng TLD không tồn tại (.test, .dev, .local)
• Không cần chỉnh sửa file /etc/hosts
• Tự động resolve tất cả subdomain

Các lỗi thường gặp

Lỗi 1: “Permission Denied” Khi Start Service

Nguyên nhân: Chưa cấp quyền Administrator.

Giải pháp:

• Thoát ServBay
• Mở lại và cấp quyền khi được yêu cầu
• Restart service

Lỗi 2: Website không truy cập được

Kiểm tra:

1. Service đã start chưa? (Check trong Services)
2. Domain đã cấu hình đúng chưa? (Check trong Hosts)
3. Document root path có đúng không?
4. PHP version có được cài đặt không?

Lỗi 3: SSL Certificate Warning

Nếu browser vẫn cảnh báo SSL:

• Vào Settings → PKI
• Download Root CA Certificate
• Import vào Keychain (macOS) hoặc Certificate Store (Windows)
• Trust certificate

ServBay là một công cụ mạnh mẽ và toàn diện cho developer muốn có một môi trường phát triển local linh hoạt, dễ quản lý, và hiệu suất cao. Với khả năng:

• Hỗ trợ đa ngôn ngữ: PHP, Node.js, Python, Go, Java, Ruby, Rust, .NET
• Multi-version: Chạy nhiều phiên bản đồng thời
• Database đa dạng: MySQL, PostgreSQL, MongoDB, Redis, v.v.
• SSL tự động: Không cần cấu hình, không cần mua certificate
• AI Integration: Ollama cho local LLM development
• GUI đẹp: Không cần command line phức tạp
• Cross-platform: macOS và Windows

ServBay giúp bạn tiết kiệm hàng giờ đồng hồ cấu hình và tập trung vào việc code. So với Docker—nhẹ hơn, nhanh hơn. So với MAMP/XAMPP—linh hoạt hơn, hiện đại hơn. So với Homebrew—dễ dàng hơn, không làm “bẩn” hệ thống.

Bạn đã thử ServBay chưa? Chia sẻ trải nghiệm của bạn trong phần bình luận bên dưới! Có câu hỏi về cài đặt hay sử dụng? Đừng ngần ngại hỏi—cộng đồng ServBay luôn sẵn sàng hỗ trợ!