Caddy и руководство по устранению неполадок веб-сервиса

ServBay использует Caddy в качестве умолчательного веб-сервера, и в процессе повседневного использования пользователи могут столкнуться с проблемами, такими как недоступность сайта. Ниже представлены решения некоторых распространенных проблем.

Использование встроенных инструментов ServBay для диагностики

ServBay имеет очень мощный инструмент диагностики неполадок, и мы настоятельно рекомендуем использовать встроенные инструменты для устранения неполадок для самостоятельной диагностики и решения проблем.

Откройте приложение ServBay, найдите в левом навигационном меню troubleshooting, чтобы получить доступ к встроенному инструменту диагностики.

Проверка Caddyfile

Если вы хотите самостоятельно устранить неполадки вручную, вы можете следовать приведенным ниже шагам.

Используйте встроенную функцию проверки Caddy для проверки правильности Caddyfile. Запустите следующую команду:

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

Если выводится Valid configuration, значит, все в порядке. Если возвращается другой код ошибки, выполните следующие действия в соответствии с подсказками кода ошибки. (Обратите внимание, что вышеуказанная команда может генерировать INFO и WARN вывода, что является нормальным и не повлияет на нормальную работу сервиса.)

Ошибка сертификата

Если вы видите сообщение об ошибке, подобное loading certificates: open xxxxx: no such file or directory, это означает, что файл сертификата не существует. Пожалуйста, проверьте правильность адреса файла сертификата.

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

Ошибка каталога сайта

Если вы видите сообщение об ошибке parsing caddyfile tokens for 'root': too many arguments, проверьте, есть ли пробелы в пути к каталогу сайта. Это очень распространенная ошибка.

Например, в root * /Applications/ServBay/www/public web между public и web есть пробел, который интерпретируется как два аргумента, что приводит к ошибке. Правильный способ настройки — использовать двойные кавычки (") для обертывания пути. Например, root * "/Applications/ServBay/www/public web".

Мы настоятельно рекомендуем избегать пробелов и специальных символов в именах файлов и путях. Для разделения слов можно использовать символы - или _, например: 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

Ошибка правил переписывания

Использование неправильных правил переписывания в Caddy, например, использование правил NGINX напрямую, также может привести к ошибкам.