إن ظهور "الشاشة البيضاء" في ownCloud هو عرض وليس تشخيصًا. يعتمد الحل الأمثل على ما إذا كان المتصفح قد تلقى خطأً من الخادم، أو تلقى رمز HTML صحيحًا لكنه فشل في تحميل JavaScript أو CSS، أو وصل إلى خادم وكيل عكسي لم يتمكن من الوصول إلى ownCloud على الإطلاق.
هذا التمييز مهم لأن المفاضلات مختلفة تمامًا. تعطيل تطبيق تابع لجهة خارجية يُعدّ منخفض المخاطر نسبيًا عندما يُشير خطأ PHP إلى هذا التطبيق. أما تغيير ملكية الملفات في جميع أنحاء النظام فهو إجراء أكثر تدخلاً، ولا ينبغي أن يكون الحل الأول لخطأ في جافا سكريبت. وبالمثل، قد يؤدي إعادة تشغيل جميع الخدمات إلى إخفاء المشكلة مؤقتًا دون تحديد مصدرها، سواءً كان PHP أو خادم وكيل أو تحديثًا أو تطبيقًا.
يغطي هذا الدليل منصة ownCloud Classic. وفقًا لوثائق ownCloud Classic 11 الحالية، يدعم الإصدار 11 النشر باستخدام Docker، حيث يتم تثبيت نظام التشغيل وبيئة تشغيل PHP وقاعدة البيانات وخادم Apache داخل الحاويات التي توفرها ownCloud. قد تستخدم الإصدارات الأقدم 10.x خادم ويب تقليديًا مع PHP-FPM. استخدم فرع الأوامر المناسب لبيئة النشر الخاصة بك. راجع متطلبات نظام ownCloud Classic 11 .
افتح أدوات مطوري المتصفح وافحص علامتي التبويب "الشبكة" و "وحدة التحكم" . اختبر نقطة النهاية أيضًا من خلال سطر الأوامر.
curl -I https://cloud.example.com/
curl -sS -o /dev/null -w '%{http_code}\n' https://cloud.example.com/
التعليق: يشير رد الخادم 500 إلى مشكلة في ownCloud أو PHP أو قاعدة البيانات أو حزمة الويب بدلاً من مشكلة عرض المتصفح البسيطة.
إذا أعاد المستند الرئيسي رمز الخطأ 500 أو 502/503 ، فامنح الأولوية لسجلات الخادم والوكيل. أما إذا أعاد المستند الرئيسي رمز الخطأ 200 ، ولكن فشلت حزم جافا سكريبت برمز الخطأ 404 أو 403 أو استثناءات برمجية، فامنح الأولوية لمسارات الأصول، وإعادة كتابة الوكيل العكسي، والسمات، وذاكرة التخزين المؤقت، أو توافق التطبيق. إذا تأثر متصفح واحد فقط، فاختبر نافذة التصفح الخاص ومتصفحًا آخر مدعومًا قبل تغيير الخادم.
يُعدّ هذا أحد أهمّ الأسئلة لأنه يُساعد على تحديد نطاق المشكلة بدقة. تشير ملاحظات الإصدار الحالية لـ ownCloud إلى أن ownCloud Classic 11 رفع الحد الأدنى لإصدار PHP إلى 8.3، وأن ownCloud Classic 11 مُخصّص لـ Docker فقط. يتبع تثبيت ownCloud 10.x القديم قواعد توافق PHP مختلفة، لذا يُرجى عدم نسخ إرشادات PHP من إصدار رئيسي آخر.
لتثبيت ownCloud 10.x بالطريقة التقليدية، قم بتشغيل الأمر من دليل ownCloud:
sudo -u www-data ./occ status
php -vبالنسبة لـ ownCloud Classic 11، قم بتشغيل OCC من خلال عملية النشر Compose:
docker compose exec owncloud occ status
docker compose exec owncloud php -v
التعليق: يعد التحقق من إصدارات ownCloud و PHP المثبتة أمرًا بالغ الأهمية بشكل خاص عندما تبدأ الشاشة البيضاء مباشرة بعد الترقية.
قارن النتيجة بملاحظات الإصدار الخاصة بالنسخة التي تستخدمها فعليًا. تُعدّ ملاحظات إصدار ownCloud الرسمية المصدر الأمثل لمعرفة الحد الأدنى للإصدارات الحالية والتغييرات الجذرية. لا يُعدّ الرجوع إلى إصدار أقدم حلاً عامًا آمنًا، إذ تُحذّر وثائق ownCloud من أن الرجوع إلى إصدار أقدم غير مدعوم لأنه قد يُتلف البيانات.
تُعدّ سجلات النظام عادةً أكثر فائدة من تغييرات التكوين التي تعتمد على التجربة والخطأ. يوصي دليل إدارة ownCloud باستخدام سجل ownCloud لتشخيص المشكلات؛ ويتم تخزين السجل افتراضيًا في دليل البيانات المُكوّن ما لم logfileيتم تحديد دليل مختلف.
في التركيبات التقليدية، تشمل الأمثلة ما يلي:
tail -n 100 /path/to/owncloud/data/owncloud.log
journalctl -u php-fpm --since "15 minutes ago"
journalctl -u apache2 --since "15 minutes ago"
journalctl -u nginx --since "15 minutes ago"في ownCloud Classic 11، قم بفحص خدمات Compose بدلاً من ذلك:
docker compose logs --tail=200 owncloud
docker compose ps
التعليق: خطأ فادح في PHP أو تتبع المكدس الذي يحدد تطبيقًا أو فئة يوفر هدفًا أكثر أمانًا لاستكشاف الأخطاء وإصلاحها من تغيير إعدادات الخادم غير ذات الصلة.
ابحث عن أول خطأ فادح مرتبط بالطلب الفاشل، وليس فقط سلسلة الأخطاء الأخيرة. تشمل الفئات الشائعة: فئة PHP مفقودة، تطبيق غير متوافق، فشل الاتصال بقاعدة البيانات، إعدادات غير قابلة للقراءة، ملفات برمجية مفقودة، أو خطأ أثناء ترقية غير مكتملة.
تشير وثائق تسجيل البيانات في ownCloud إلى أن تسجيل بيانات التصحيح (DEBUG) قد يُفيد أثناء التشخيص، ولكنه يُنتج بيانات كثيرة وقد يؤثر على الأداء. إذا رفعت مستوى التسجيل مؤقتًا، فأعده إلى مستوى أقل تفصيلًا بعد جمع البيانات. راجع إعدادات تسجيل البيانات في ownCloud .
اختر هذا المسار عندما يشير الخطأ إلى تطبيق غير أساسي، أو عندما تبدأ الصفحة الفارغة بعد تثبيت تطبيق أو تحديثه، أو عندما يظهر الخطأ أثناء ترقية ownCloud. توصي إرشادات استكشاف الأخطاء وإصلاحها في ownCloud صراحةً بتعطيل تطبيقات الطرف الثالث لاستكشاف الأخطاء وإصلاحها وقبل إجراء الترقيات.
قم بإدراج التطبيقات أولاً. على ownCloud 10.x:
sudo -u www-data ./occ app:list
sudo -u www-data ./occ app:disable APP_IDعلى ownCloud 11:
docker compose exec owncloud occ app:list
docker compose exec owncloud occ app:disable APP_ID
التعليق: إن تعطيل التطبيق المتأثر فقط بالسجلات أقل إزعاجًا من تعطيل العديد من المكونات أو تغيير مجموعة الويب الكاملة.
يتمثل المقابل في فقدان المستخدمين لوظائف التطبيق حتى يتم تحديثه أو إعادة تفعيله. وعادةً ما يكون هذا الخيار أفضل من تعطيل خدمات ownCloud الأساسية. كما تشير وثائق OCC إلى أنه لا يمكن تعطيل العديد من التطبيقات الأساسية، بما في ذلك DAV وFederatedFileSharing وFiles وFiles_External. يُرجى مراجعة دليل استكشاف الأخطاء وإصلاحها العام الرسمي ومرجع أوامر OCC .
تُعدّ الأذونات مصدر شك قوي عندما يحتوي السجل على خطأ Permission denied، مثل قيام عملية نشر حديثة بنسخ ملفات التطبيق/الإعدادات باسم مستخدم خاطئ، أو استبدال ملفات بملكية غير صحيحة أثناء الترقية. أما إذا كان الدليل الوحيد هو خطأ في جافا سكريبت من جانب المتصفح، فيُعتبر مصدر شك ضعيف.
ضع النظام في وضع الصيانة قبل إجراء أي أعمال إصلاح مُعطِّلة. بالنسبة لـ ownCloud 11:
docker compose exec owncloud occ maintenance:mode --onبالنسبة لعملية نشر تقليدية من الإصدار 10.x:
sudo -u www-data ./occ maintenance:mode --on
التعليق: يقلل وضع الصيانة من نشاط المستخدم أثناء قيامك بالتحقيق في أخطاء الملكية أو أذونات الملفات التي تدعمها بالفعل أدلة السجل.
لا تُشغّل وصفات أذونات النسخ chmod 777أو التكرار الشاملة من إصدار آخر. يُوثّق دليل ownCloud 11 الحالي ملكية الملفات وأنماطها المُضافة يدويًا في المجلدات المُثبّتة بواسطة Docker، بما في ذلك apps: configالملكية www-data:root، وملفات التطبيق 0644، ومجلدات التطبيق 0751، وملفات التكوين المُضافة 0644. كما يُوثّق أيضًا التغييرات 0640التي أُجريت يدويًا . استخدم وثائق الترقية اليدوية لـ ownCloud 11 كمرجع خاص بهذا الإصدار..htaccess.user.ini
لا يحدث هذا إلا عندما تشير سجلات النظام أو فحوصات التوافق إلى ذلك. لهذا المسار تأثير أوسع نطاقًا من تعطيل تطبيق واحد معطوب. فقد يؤدي نقص امتداد PHP مطلوب إلى منع تشغيل التعليمات البرمجية، بينما قد يؤثر تكوين PHP غير صحيح على جميع تطبيقات PHP على الخادم.
بالنسبة لمجموعة برامج PHP القديمة التي يديرها المضيف، تحقق مما يقوم وقت تشغيل الويب بتحميله فعليًا:
php -m
php --ini
php -r 'phpinfo();' | grep opcache.enable
التعليق: تعتبر عمليات فحص وحدة PHP و OPcache مفيدة عندما تشير سجلات الخادم إلى وجود ملحقات مفقودة أو عدم توافق وقت التشغيل، ولكن لا ينبغي أن تكون أول تغيير بدون دليل.
في إصدار ownCloud 11، تتولى الصورة الرسمية إدارة بيئة تشغيل PHP، لذا فإن تغيير حزم PHP على المضيف يُعدّ عمومًا خيارًا غير مناسب. تُوثّق ownCloud تفعيل OPcache افتراضيًا في صورة Docker الخاصة بها. راجع وثائق التخزين المؤقت للذاكرة في ownCloud .
إذا كنت تشك في وجود ذاكرة تخزين مؤقتة قديمة لرموز العمليات (OPcache) بعد استبدال ملفات PHP يدويًا في نظام تشغيل قديم، فإن إعادة تشغيل PHP-FPM أو خدمة الويب/PHP ذات الصلة قد تُزيل ذاكرة التخزين المؤقتة لرموز العمليات المحلية. لكن هذا قد يؤدي إلى انقطاع قصير في الأداء وانخفاض في كفاءة ذاكرة التخزين المؤقتة. يُنصح بالقيام بذلك بعد تصحيح الملفات الأساسية، وليس كبديل لتحديد الخطأ.
إذا ظهرت الصفحة البيضاء أثناء الترقية أو بعدها مباشرة، فتحقق أولاً من حالة الترقية. توصي وثائق الترقية الخاصة بـ ownCloud باستخدام OCC لمسار الترقية والإصلاح بدلاً من التعامل مع قاعدة البيانات يدويًا.
لـ ownCloud 11:
docker compose exec owncloud occ status
docker compose exec owncloud occ upgrade
docker compose exec owncloud occ maintenance:repair
docker compose exec owncloud occ integrity:check-coreبالنسبة لـ ownCloud 10.x، استخدم أوامر OCC المكافئة ضمن مستخدم خادم الويب:
sudo -u www-data ./occ status
sudo -u www-data ./occ maintenance:repair
sudo -u www-data ./occ integrity:check-core
التعليق: إصلاح OCC مناسب للترقية المتقطعة أو غير المتناسقة، بينما يمكن لفحوصات السلامة تحديد ملفات النواة الموقعة المعدلة أو المفقودة.
نتائج فحص سلامة الكود تحتاج إلى تفسير. راجع وثائق ownCloud INVALID_HASH، FILE_MISSINGو، و EXTRA_FILEكشروط منفصلة. لا تقم بالتعديل signature.jsonلإخفاء التحذيرات. كما أن وثائق ownCloud 11 الحالية تجعل توقيع تطبيقات الطرف الثالث إلزاميًا للتثبيت والتحديثات والتفعيل. راجع وثائق توقيع كود ownCloud .
لا يقتصر التعافي الجيد على مجرد "اختفاء اللون الأبيض من الصفحة". تحقق من مسار الطلب بالكامل:
occ statusيُشير التقرير إلى وجود نسخة مثبتة وعدم وجود متطلبات ترقية غير متوقعة.لـ ownCloud 11:
docker compose exec owncloud occ maintenance:mode --off
docker compose exec owncloud occ status
curl -I https://cloud.example.com/
التعليق: يجب تأكيد التعافي على كلا المستويين: تحميل واجهة ownCloud، وبقاء حالة جانب الخادم وفحوصات HTTP سليمة.
| الدليل الذي لديك | الخيار الأول الأفضل | مقايضة |
|---|---|---|
| يعرض متصفح واحد فقط الصفحة الفارغة | نافذة خاصة، متصفح ثانٍ مدعوم، وحدة تحكم المتصفح | أقل المخاطر؛ لا يعالج عطلًا حقيقيًا في الخادم إذا تأثر جميع المستخدمين |
| المستند الرئيسي هو HTTP 500 | سجلات ownCloud و PHP/container وخادم الويب وقاعدة البيانات | أسرع طريق للوصول إلى السبب الجذري؛ يتطلب الوصول إلى سجلات النظام أو النظام الأساسي |
| يشير الخطأ إلى تطبيق تابع لجهة خارجية | قم بتعطيل هذا التطبيق فقط باستخدام OCC | عادةً ما يكون خطر التشغيل منخفضًا، ولكن وظائف هذا التطبيق غير متاحة مؤقتًا |
| بدأت المشكلة مباشرة بعد التحديث | تحقق من مصفوفة الإصدارات المدعومة، وحالة الترقية، وتوافق التطبيق، وإصلاح OCC | أكثر تحكمًا من التراجع؛ وقد يتطلب فترة صيانة |
| تشير السجلات إلى رفض الإذن بعد نسخ الملفات | قم بتصحيح الملكية/الأوضاع الموثقة فقط للإصدار المتأثر | يجب تحديد متى توجد الأدلة بدقة؛ إذ يمكن أن تؤدي تغييرات الأذونات المتكررة الشاملة إلى مشاكل أمنية ومشاكل في الترقية. |
| تقارير فحص سلامة الملفات الأساسية: الملفات المعدلة/المفقودة | استعد ملفات الإصدار الصحيحة أو اتبع إجراءات الترقية/الاستعادة المدعومة | يحافظ على سلامة النظام؛ تجنب إجراء تعديلات يدوية على العديد من ملفات النظام الأساسية في مكانها |
| HTTP 200 لكن JS/CSS يفشل | شبكة المتصفح/وحدة التحكم، مسارات البروكسي، أصول السمة/التطبيق، ذاكرة التخزين المؤقت | يتجنب التغييرات غير الضرورية في قاعدة البيانات/PHP؛ قد يتطلب الوصول إلى إعدادات الوكيل |
display_errorsعلى موقع إنتاج عام لمجرد عرض آثار الأخطاء للمتصفح؛ استخدم سجلات الخادم بدلاً من ذلك.signature.jsonلمجرد إخفاء أخطاء التكامل.توقف عن إجراء التغييرات عندما تشير السجلات إلى تلف قاعدة البيانات، أو مشاكل في مفتاح التشفير، أو فشل متكرر في سلامة البيانات الأساسية بعد استعادة نظيفة، أو حالة ترقية لا يمكن إكمالها باستخدام سير عمل OCC الموثق. قم أيضًا بتصعيد الأمر عندما تؤثر الصفحة الفارغة على مجموعة إنتاجية ولا يمكنك عزل عقدة واحدة دون المخاطرة بسلامة البيانات.
قبل فتح طلب دعم، توصي ownCloud بجمع تقرير التكوين والسجلات ذات الصلة. بالنسبة لإصدار ownCloud 10.x، الأمر الموثق هو:
sudo -u www-data ./occ configreport:generate > config_report.txtاستخدم طريقة تنفيذ OCC المناسبة لنشرك، وراجع المخرجات بحثًا عن أي بيانات سرية قبل مشاركتها خارج مؤسستك. يشرح دليل جمع سجلات وتكوينات ownCloud ما يحتاجه مهندسو الدعم عادةً.
قارن بين 10 أدوات مسح الشبكة المحلية (Ping) لاكتشاف الشبكات المحلية بسرعة، وإجراء مسح شامل للأنظمة الأساسية المختلفة، وإدارة عناوين IP. تعرّف على ما يمكن أن يكشفه لك المسح وما لا يمكنه كشفه.
قارن بين ست أدوات لإدارة الشبكة لمراقبة الأداء، بما في ذلك تغطية SNMP، ورسم الخرائط، والتنبيهات، ونماذج النشر، والمفاضلات المتعلقة بالتكلفة.
قارن بين أفضل برامج تحليل شبكة Wi-Fi لأنظمة Windows و iPhone و Android، بما في ذلك أدوات ازدحام القنوات وتغطية الإشارة والخرائط الحرارية واستكشاف أخطاء الشبكة وإصلاحها.
قارن بين سبعة برامج مراقبة زمن الاستجابة المجانية والمفتوحة المصدر، بدءًا من مجموعات الشبكة الكاملة وحتى مجسات زمن الاستجابة المركزة، واختر البرنامج المناسب من حيث التوافر وفقدان الحزم والسجل.
تعرف على معنى جودة الخدمة في الشبكات، وكيف تحدد علامات DSCP وقوائم انتظار حركة المرور أولويات تطبيقات الصوت والفيديو والأعمال، وما لا تستطيع جودة الخدمة إصلاحه.
قم ببناء نظام مراقبة شبكة عملي مع تغطية واضحة للأجهزة، ومقاييس أداء مفيدة، وتنبيهات قابلة للتنفيذ، ومقارنة بين SolarWinds NPM وPRTG وOpManager.
قارن بين برامج خوادم SFTP الموثوقة لأنظمة ويندوز ولينكس، بما في ذلك OpenSSH وBitvise وSolarWinds وSFTPGo. اعثر على الخيار الأمثل الذي يلبي احتياجاتك الأمنية واحتياجات نقل الملفات.
قارن بين سبع أدوات لإدارة عناوين IP لاكتشاف الشبكات الفرعية، وتنسيق DNS وDHCP، وجرد الشبكة، وIPAM مفتوح المصدر.
قارن بين أدوات فحص الشبكة لاكتشاف الأجهزة بسرعة، وعمليات فحص IP عبر الأنظمة الأساسية، وإدارة عناوين IP للمؤسسات، مع إرشادات حول مطابقة كل خيار مع شبكتك.
استخدم خيار --traceroute في Nmap لرسم خرائط القفزات إلى مضيف مصرح به، وفهم مخرجات القفزة وRTT، واستكشاف الأخطاء وإصلاحها في الاستجابات المفقودة دون الإفراط في المسح.
