ServBay

Tiếng Việt

English
简体中文
繁體中文
Español
العربية
Português
Русский
日本語
Deutsch
Français
Türkçe
Italiano
हिन्दी
Bahasa Indonesia
Bahasa Melayu
Polski
Nederlands
Українська
ไทย
한국어

Tiếng Việt

English
简体中文
繁體中文
Español
العربية
Português
Русский
日本語
Deutsch
Français
Türkçe
Italiano
हिन्दी
Bahasa Indonesia
Bahasa Melayu
Polski
Nederlands
Українська
ไทย
한국어

Appearance

Hướng Dẫn Khắc Phục Sự Cố Máy Chủ Web Trên ServBay ​

ServBay hỗ trợ sử dụng Caddy, NGINX và Apache làm máy chủ Web mặc định, mang lại cho bạn môi trường phát triển linh hoạt trên máy tính cá nhân. Trong quá trình sử dụng, bạn có thể gặp các vấn đề như không truy cập được website, tải trang chậm hoặc xuất hiện lỗi (ví dụ 500 Internal Server Error). Hướng dẫn này nhằm giúp bạn chẩn đoán và giải quyết các sự cố máy chủ Web thường gặp trong môi trường ServBay.

Sử Dụng Công Cụ Chẩn Đoán Sự Cố Tích Hợp Của ServBay ​

ServBay cung cấp một công cụ chẩn đoán sự cố mạnh mẽ, tự động phát hiện và thông báo các vấn đề cấu hình hoặc lỗi dịch vụ phổ biến. Bạn nên sử dụng công cụ này làm bước đầu tiên khi gặp sự cố, giúp tiết kiệm thời gian kiểm tra.

Mở ứng dụng ServBay, nhấp vào mục Chẩn đoán sự cố ở thanh điều hướng bên trái để truy cập giao diện chẩn đoán tích hợp của ServBay.

Chẩn đoán sự cố với công cụ tích hợp của ServBay

Công cụ sẽ kiểm tra trạng thái các thành phần cốt lõi của ServBay, kiểm tra cổng kết nối, cú pháp tệp cấu hình... đồng thời đưa ra khuyến nghị giúp bạn nhanh chóng xác định nguyên nhân sự cố.

Kiểm Tra Tệp Cấu Hình Máy Chủ Web ​

Lỗi trong tệp cấu hình máy chủ Web là nguyên nhân phổ biến khiến website không thể hoạt động bình thường. ServBay cung cấp công cụ kiểm tra cú pháp cho từng loại máy chủ Web nhằm tránh lỗi này.

Kiểm Tra Caddyfile ​

Sử dụng lệnh validate tích hợp của Caddy để xác minh độ đúng đắn của tệp cấu hình Caddyfile.

bash
/Applications/ServBay/bin/caddy validate -c /Applications/ServBay/etc/caddy/Caddyfile

Nếu cú pháp đúng, lệnh sẽ trả về kết quả Valid configuration. Nếu có lỗi, sẽ có mô tả chi tiết dựa trên loại lỗi gặp phải.

Lưu ý: Lệnh caddy validate có thể xuất hiện nhiều thông tin INFO hoặc WARN, đó là thông tin nội bộ về quá trình tải cấu hình của Caddy, không phải là lỗi cú pháp; chỉ cần có dòng Valid configuration cuối cùng thì cấu hình là hợp lệ.

Một Số Lỗi Thường Gặp Với Caddyfile: ​

  • Lỗi không tìm thấy tệp chứng chỉ:

    bash
    2024/12/09 17:24:16.970 INFO using config from file {"file": "/Applications/ServBay/etc/caddy/Caddyfile"}
... (Thông tin INFO/WARN khác) ...
Error: loading http app module: provision http: getting tls app: loading tls app module: provision tls: loading certificates: open /Applications/ServBay/ssl/private/tls-certs/mail.servbay.host/mail.servbay.host.1crt: no such file or directory

    Nếu xuất hiện lỗi dạng loading certificates: open xxxxx: no such file or directory, điều đó có nghĩa là đường dẫn tệp chứng chỉ SSL bạn khai báo trong Caddyfile không đúng hoặc tệp không tồn tại. Vui lòng kiểm tra lại đường dẫn đến tệp chứng chỉ (đuôi .crt/.cer/.pem) và tệp private key (.key) trong cấu hình, đồng thời xác nhận các tệp này thực sự có mặt ở đúng vị trí. ServBay hỗ trợ nhập thủ công hoặc đăng ký SSL tự động qua ACME, hãy kiểm tra lại phần cấu hình SSL trên ServBay.

  • Lỗi đường dẫn thư mục gốc website (có khoảng trắng):

    bash
    2024/12/09 17:26:37.371 INFO using config from file {"file": "/Applications/ServBay/etc/caddy/Caddyfile"}
Error: adapting config using caddyfile: parsing caddyfile tokens for 'root': too many arguments; should only be a matcher and a path, at /Applications/ServBay/etc/caddy/Caddyfile:1388

    Lỗi parsing caddyfile tokens for 'root': too many arguments thường xảy ra khi đường dẫn thư mục gốc của website có chứa khoảng trắng, ví dụ: root * /Applications/ServBay/www/public web thì public web sẽ bị coi là hai tham số khác nhau. Cách chính xác là sử dụng dấu " để bao đường dẫn có khoảng trắng, ví dụ: root * "/Applications/ServBay/www/public web".

    Khuyến nghị: Tránh dùng khoảng trắng hoặc ký tự đặc biệt khi đặt tên file và thư mục. Hãy sử dụng dấu gạch ngang - hoặc gạch dưới _ như public-folder hoặc public_dir cho dễ quản lý.

  • Lỗi quy tắc Rewrite không đúng:

    Nếu bạn sao chép nguyên tắc rewrite từ NGINX hoặc sử dụng quy tắc không hợp lệ với Caddy, quá trình xác thực sẽ thất bại. Vui lòng tham khảo tài liệu về module Rewrite của Caddy hoặc hướng dẫn chuyển website từ NGINX sang ServBay để đảm bảo cú pháp đúng chuẩn.

Kiểm Tra Cấu Hình NGINX ​

Sử dụng tham số -t tích hợp để kiểm tra cú pháp và tính hợp lệ của file cấu hình NGINX.

bash
/Applications/ServBay/bin/nginx -t

Nếu cấu hình hợp lệ, màn hình sẽ hiện:

nginx: the configuration file /Applications/ServBay/etc/nginx/nginx.conf syntax is ok
nginx: configuration file /Applications/ServBay/etc/nginx/nginx.conf test is successful

Nếu có lỗi, NGINX sẽ chỉ rõ file và vị trí dòng lỗi. Một số lỗi cấu hình phổ biến ở NGINX:

  1. Lỗi cú pháp: Ví dụ thiếu dấu ;, đóng ngoặc không khớp }...
  2. Sai đường dẫn file: Tham số include hoặc các chỉ thị khác trỏ vào file hoặc thư mục không tồn tại.
  3. Trùng cổng: Cổng được cấu hình đã bị ứng dụng khác chiếm giữ.

Kiểm Tra Cấu Hình Apache ​

Dùng lệnh apachectl configtest để xác thực cú pháp cấu hình Apache.

bash
/Applications/ServBay/bin/apachectl configtest

Nếu cấu hình hợp lệ, sẽ hiện Syntax OK. Nếu có lỗi, dòng thông báo sẽ mô tả chi tiết lỗi gặp phải. Một số sự cố Apache thường gặp:

  1. Lỗi khi load module: Module (LoadModule) chỉ định trong cấu hình không tồn tại hoặc sai đường dẫn.
  2. Lỗi cú pháp trong file .htaccess: Khi website có file .htaccess với cú pháp sai, có thể làm hỏng toàn bộ cấu hình hoặc gây lỗi riêng cho thư mục đó.
  3. Sai quyền truy cập thư mục: Cấu hình chỉ thị Directory, Files với quyền (Require, Allow, Deny) ngặt, khiến không truy cập được nội dung website.

Xử Lý Lỗi 500 Internal Server Error ​

500 Internal Server Error là mã trạng thái HTTP chung, báo hiệu server gặp sự cố không xử lý được yêu cầu. Trong ứng dụng Web, nguyên nhân phổ biến là script phía backend (PHP, Python, Node.js,...) lỗi hoặc gặp sự cố.

Các Bước Xử Lý Chung ​

Khi thấy trang báo lỗi 500, hãy thực hiện lần lượt những bước sau:

  1. Kiểm tra log lỗi của máy chủ Web: Đây là bước quan trọng nhất. Log lỗi thường chứa thông tin chi tiết về sự cố, như script lỗi, file không tồn tại hoặc vấn đề phân quyền...

    • Caddy: /Applications/ServBay/var/logs/caddy/error.log
    • NGINX: /Applications/ServBay/var/logs/nginx/error.log
    • Apache: /Applications/ServBay/var/logs/apache/error.log Xem các dòng log mới nhất có chứa error hoặc critical.

  2. Kiểm tra dịch vụ backend (ví dụ PHP-FPM) có đang chạy không: Nếu website dùng PHP, hãy chắc chắn dịch vụ PHP-FPM đang hoạt động.

    bash
    ps aux | grep php-fpm

    Tìm dòng có php-fpm: master process hoặc php-fpm: pool www. Nếu không thấy, PHP-FPM đã bị dừng hoặc crash. Có thể khởi động lại qua ServBay UI hoặc lệnh servbayctl.

  3. Kiểm tra log lỗi của script backend (ví dụ PHP): Nếu log máy chủ Web báo lỗi FastCGI hay script backend, cần xem log lỗi của ngôn ngữ backend.

    • PHP: /Applications/ServBay/var/logs/php/php_error.log Kiểm tra các dòng chứa Fatal error, Parse error, Warning, Notice liên quan đến script vừa truy cập. Đảm bảo display_errors tắt khi dùng production, nhưng có thể bật tạm bằng cấu hình php.ini khi phát triển để dễ kiểm tra.

  4. Kiểm tra quyền truy cập file & thư mục: Thường các tiến trình máy chủ Web chạy dưới user riêng (ví dụ _www), cần có quyền đọc file, thư mục website và ghi vào thư mục upload hoặc log.

    bash
    ls -la /Applications/ServBay/www/your-site/

    Hãy xác nhận user của Web server có quyền đọc các file và thư mục website. Nếu cần ghi upload hoặc log, cần có thêm quyền ghi. Sử dụng chmod, chown để chỉnh quyền cho phù hợp nhưng thao tác cần thận trọng.

Điểm Cần Lưu Ý Theo Từng Máy Chủ Web Khi Xảy Ra Lỗi 500 ​

  • Caddy:

    1. Cấu hình FastCGI: Kiểm tra chỉ thị php_fastcgi hoặc reverse_proxy trong Caddyfile đã trỏ đúng đến địa chỉ lắng nghe của PHP-FPM (thường là 127.0.0.1:9000 hoặc unix:/path/to/php-fpm.sock).
    2. Trạng thái PHP-FPM: Đảm bảo phiên bản PHP tương ứng trong ServBay cũng như dịch vụ PHP-FPM đều được khởi động.
    3. Thiết lập reverse proxy: Khi dùng reverse_proxy tới backend khác (ví dụ Node.js), kiểm tra lại địa chỉ/port proxy, backend có đang hoạt động không.

  • NGINX:

    1. Cấu hình fastcgi_pass: Kiểm tra chỉ thị fastcgi_pass trong nginx.conf hoặc cấu hình site đã trỏ đúng đến PHP-FPM.
    2. Thiết lập client_max_body_size: Upload file lớn mà báo lỗi 500 rất có thể do giới hạn này quá thấp.
    3. Cấu hình try_files: Đảm bảo chỉ thị này đã đúng, chuyển truy vấn tới FastCGI hoặc file index tương ứng.

  • Apache:

    1. Module mod_rewrite: Nếu dùng .htaccess rewrite URL, hãy bật module mod_rewrite.
    2. Nội dung file .htaccess: Lỗi chỉ thị trong file này sẽ gây lỗi 500. Kiểm tra cú pháp nhất là các dòng RewriteRule.
    3. Thiết lập AllowOverride: Đảm bảo chỉ thị AllowOverride cho thư mục website đã cho phép sử dụng các chỉ thị cần thiết trong .htaccess (nên để All hoặc tối thiểu gồm FileInfo và Limit).

Quản Lý Dịch Vụ ​

Sau khi chỉnh lại file cấu hình hoặc khắc phục vấn đề backend, thường bạn sẽ cần khởi động lại máy chủ Web hoặc dịch vụ liên quan để cập nhật thay đổi.

Khởi Động Lại Dịch Vụ ​

Dùng lệnh servbayctl restart để khởi động lại dịch vụ máy chủ Web tương ứng.

bash
# Khởi động lại dịch vụ Caddy
servbayctl restart caddy -all

# Khởi động lại dịch vụ NGINX
servbayctl restart nginx -all

# Khởi động lại dịch vụ Apache
servbayctl restart apache -all

Tham số -all sẽ khởi động lại cả các dịch vụ liên quan, như PHP-FPM nếu có cấu hình FastCGI đi kèm.

Kiểm Tra Trạng Thái Dịch Vụ ​

Dùng lệnh servbayctl status để kiểm tra trạng thái hoạt động của dịch vụ mong muốn.

bash
# Kiểm tra trạng thái dịch vụ Caddy
servbayctl status caddy -all

# Kiểm tra trạng thái dịch vụ NGINX
servbayctl status nginx -all

# Kiểm tra trạng thái dịch vụ Apache
servbayctl status apache -all

Kết quả sẽ cho biết dịch vụ đang ở trạng thái running (đang chạy), stopped (đã dừng) hoặc trạng thái khác. Điều này giúp xác nhận xem dịch vụ đã hoạt động trở lại chưa.

Các Bước Kiểm Tra Nâng Cao ​

Nếu các hướng dẫn trên không giải quyết được sự cố, bạn có thể thử các cách dưới đây:

  1. Kiểm tra công cụ phát triển trình duyệt: Mở công cụ dành cho nhà phát triển trên trình duyệt (F12), chuyển sang tab Console (Bảng điều khiển) và Network (Mạng). Kiểm tra xem có lỗi JavaScript phía client, mã trạng thái HTTP, header và response body nào bất thường không, giúp xác định sự cố thuộc về frontend hay backend.
  2. Dùng lệnh curl -v: Tại Terminal, chạy curl -v your-website.servbay.demo để kiểm tra phản hồi đầy đủ, gồm request, response header và thông tin SSL/TLS. Thay your-website.servbay.demo bằng tên miền thực tế của bạn trên ServBay.
  3. Tạm tắt tường lửa để thử nghiệm: Tường lửa của macOS hoặc phần mềm bảo mật bên thứ 3 có thể ngăn chặn kết nối đến các port. Hãy thử tắt tường lửa, nếu truy cập được thì cần cấu hình lại để mở các cổng như 80, 443 cho ServBay.
  4. Thử trên trình duyệt/thiết bị khác: Kiểm tra website trên trình duyệt khác hoặc thiết bị khác để xem vấn đề có phải do cache trình duyệt hoặc cấu hình đặc biệt không.
  5. Kiểm tra cấu hình DNS nội bộ hoặc file hosts: Nếu bạn dùng tên miền tùy chỉnh (không phải localhost hay IP), hãy mở file /etc/hosts hoặc cấu hình DNS nội bộ để xác nhận tên miền đã trỏ về 127.0.0.1 hoặc ::1.

Tổng Kết ​

Lỗi máy chủ Web là thử thách phổ biến trong quá trình phát triển nội bộ. Nếu bạn kiểm tra hệ thống cấu hình, phân tích log lỗi, xác nhận trạng thái dịch vụ hỗ trợ cũng như phân quyền file cẩn thận thì đa phần sự cố đều giải quyết được. Công cụ chẩn đoán của ServBay và các lệnh dòng lệnh servbayctl là trợ thủ đắc lực cho bạn. Khi gặp lỗi quá phức tạp, đừng ngần ngại tra thêm tài liệu của ServBay hoặc liên hệ với đội ngũ hỗ trợ kỹ thuật để được giúp đỡ.