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
2
3
4
5
6
7
Ошибка каталога сайта
Если вы видите сообщение об ошибке 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
2
3
Ошибка правил переписывания
Использование неправильных правил переписывания в Caddy, например, использование правил NGINX напрямую, также может привести к ошибкам.