Caddy と Web サービスのトラブルシューティングガイド
ServBay は デフォルトの Web サーバーとして Caddy を使用しており、日常的な使用の中で、ユーザーはウェブサイトが開けないといった問題に直面することがあります。以下は、いくつかの一般的な問題の解決方法です。
ServBay 付属のツールでのトラブルシューティング
ServBay は非常に強力な診断ツールを備えており、私たちは ServBay 付属の トラブルシューティングツール を使用して自己診断と問題解決を行うことをお勧めします。
ServBay アプリを開き、左側のナビゲーションから 故障診断 を見つけると、ServBay 付属の診断ツールにアクセスできます。
Caddyfile の確認
手動でトラブルシューティングを行いたい場合は、以下の手順を参考にしてください。
Caddy に内蔵された検証機能を使用して、Caddyfile が正しいかどうか確認します。次のコマンドを実行してください。
$ /Applications/ServBay/bin/caddy validate -c /Applications/ServBay/etc/caddy/CaddyfileValid 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 の間にスペースがあると、これは2つの引数として扱われ、エラーを引き起こします。正しい設定方法は、ダブルクオーテーション（"）でパスを囲むことです。例えば、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 のルールを直接使用した場合にもエラーが発生することがあります。