دليل استكشاف أخطاء Caddy وخدمات الويب
يستخدم ServBay Caddy كـ خادم الويب الافتراضي ، وفي الاستخدام اليومي، قد يواجه المستخدمون بعض المشكلات مثل عدم فتح مواقع الويب. فيما يلي بعض الحلول للمشكلات الشائعة.
استخدام الأدوات المدمجة في ServBay لاستكشاف الأخطاء
تأتي ServBay مزودة بأداة تشخيص قوية جداً، وننصح باستخدام أداة استكشاف الأخطاء المدمجة لمساعدتك في التشخيص وحل المشكلات.
افتح تطبيق ServBay، وابحث في الشريط الجانبي الأيسر عن استكشاف الأخطاء
للدخول إلى أداة التشخيص المدمجة.
تحقق من 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
أخطاء قواعد Rewrite
استخدمت قواعد Rewrite غير صحيحة في Caddy، مثل استخدام قواعد NGINX مباشرة ، يمكن أن يؤدي ذلك أيضًا إلى حدوث أخطاء.