Caddy và Hướng dẫn Khắc phục sự cố Dịch vụ Web

ServBay sử dụng Caddy làm máy chủ Web mặc định, trong quá trình sử dụng hàng ngày, người dùng có thể gặp phải một số vấn đề như không thể truy cập trang web, dưới đây là một số phương pháp giải quyết các vấn đề thường gặp.

Sử dụng công cụ tích hợp của ServBay để khắc phục sự cố

ServBay tích hợp một công cụ chẩn đoán lỗi rất mạnh mẽ, chúng tôi khuyên bạn nên sử dụng công cụ khắc phục sự cố tích hợp của ServBay để tự chẩn đoán và giải quyết.

Mở ứng dụng ServBay, tìm Chẩn đoán lỗi trong thanh điều hướng bên trái để vào công cụ chẩn đoán lỗi tích hợp của ServBay.

Kiểm tra Caddyfile

Nếu bạn muốn tự khắc phục lỗi bằng cách thủ công, có thể tham khảo một số bước dưới đây.

Sử dụng chức năng xác minh tích hợp của Caddy để xác thực Caddyfile có chính xác hay không. Vui lòng chạy lệnh dưới đây.

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

Nếu trả về Valid configuration, điều đó có nghĩa là mọi thứ đều bình thường. Nếu trả về mã lỗi khác, hãy thực hiện theo gợi ý của mã lỗi để tiếp tục bước tiếp theo. (Lưu ý: lệnh trên sẽ có nhiều thông báo INFO và WARN, điều này là bình thường và không ảnh hưởng đến hoạt động bình thường của dịch vụ)

Lỗi chứng chỉ

Nếu xuất hiện lỗi tương tự như sau loading certificates: open xxxxx: no such file or directory, điều đó có nghĩa là tệp chứng chỉ không tồn tại. Vui lòng kiểm tra xem địa chỉ tệp chứng chỉ có đúng không.

2024/12/09 17:24:16.970 INFO using config from file {"file": "/Applications/ServBay/etc/caddy/Caddyfile"}
2024/12/09 17:24:16.991 INFO adapted config to JSON {"adapter": "caddyfile"}
2024/12/09 17:24:16.991 WARN Caddyfile input is not formatted; run 'caddy fmt --overwrite' to fix inconsistencies {"adapter": "caddyfile", "file": "/Applications/ServBay/etc/caddy/Caddyfile", "line": 8}
2024/12/09 17:24:16.999 INFO tls.cache.maintenance started background certificate maintenance {"cache": "0x1400121f300"}
2024/12/09 17:24:17.006 INFO tls.cache.maintenance stopped background certificate maintenance {"cache": "0x1400121f300"}

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

Lỗi thư mục website

Nếu xuất hiện lỗi dưới đây parsing caddyfile tokens for 'root': too many arguments, hãy kiểm tra xem đường dẫn thư mục website có chứa khoảng trắng hay không. Đây là một lỗi rất phổ biến.

Ví dụ root * /Applications/ServBay/www/public web, có một khoảng trắng giữa public và web, điều này sẽ được coi là hai tham số, dẫn đến lỗi. Cách thiết lập đúng là sử dụng dấu ngoặc kép (") để bao quanh đường dẫn. Ví dụ root * "/Applications/ServBay/www/public web".

Chúng tôi cực kỳ khuyên bạn không nên chứa khoảng trắng và ký tự đặc biệt trong bất kỳ tên tệp nào, đường dẫn. Để phân tách các từ, bạn có thể sử dụng dấu - hoặc _, chẳng hạn như: public-folder, public_dir.

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 quy tắc Rewrite

Sử dụng quy tắc Rewrite không chính xác trong Caddy, chẳng hạn như sử dụng trực tiếp quy tắc của NGINX, cũng sẽ dẫn đến lỗi.