استخدم واجهة الويب في ZimaOS لتغيير المنافذ بشكل اعتيادي
يوضح الدليل الرسمي للمجتمع أنه ينبغي عادةً تغيير منفذ لوحة تحكم ZimaOS من واجهة الويب. أما إجراء سطر الأوامر أدناه، فهو مخصص لحالات الطوارئ أو الإنقاذ، مثل تغيير المنفذ عن طريق الخطأ أو إجراء تغيير متعمد أدى إلى تعذر الوصول إلى لوحة التحكم.
متى تكون طريقة الإنقاذ عبر سطر الأوامر مفيدة؟
يحدد الدليل حالتين شائعتين: تغيير منفذ لوحة التحكم عن طريق الخطأ، أو تغييره عمدًا ثم توقف الإعداد الجديد عن العمل كما هو متوقع. ويستهدف الإجراء الاستردادي المنفذ 80 بهدف استعادة الوصول إلى لوحة تحكم ZimaOS.
نُشر هذا الدليل في أبريل 2025. قد تتغير مسارات الإعدادات وأسماء الخدمات في الإصدارات اللاحقة، لذا تحقّق من السلوك الحالي في صفحة ZimaOS الحالية قبل استخدام إجراء الإنقاذ التاريخي هذا على إصدار أحدث بفارق كبير.
إعادة ضبط منفذ لوحة التحكم من سطر الأوامر المحلي
يغيّر هذا الإجراء ملف إعدادات للنظام ويعيد تشغيل إحدى خدمات ZimaOS. سجّل الإعداد الحالي قبل تعديله، وتأكد من نسخ البيانات المهمة احتياطيًا قبل تنفيذ أعمال الاسترداد على مستوى النظام.
1. وصّل لوحة مفاتيح وشاشة
يبدأ الدليل بالوصول الفعلي المباشر إلى جهاز ZimaOS. وصّل لوحة مفاتيح وشاشة حتى تتمكن من العمل محليًا حتى عندما تكون لوحة التحكم غير متاحة عبر الشبكة.
2. افتح سطر الأوامر وانتقل إلى المستخدم الجذر
اضغط على Alt + F3 للانتقال إلى واجهة سطر الأوامر، ثم سجّل الدخول وارفع الامتيازات إلى المستخدم الجذر:
sudo -i3. افتح إعدادات البوابة
استخدم محرر VI لفتح ملف إعدادات البوابة:
vi /etc/casaos/gateway.iniحدّد السطر الذي يعرّف منفذ لوحة التحكم. يستخدم الدليل قيمة متغيرة مثل:
port = 8080أعد ضبطه إلى:
port = 80لحفظ الملف في VI، اضغط على Esc، واكتب :wq، ثم اضغط على Enter.
4. أعد تشغيل خدمة بوابة ZimaOS
طبّق تغيير الإعداد بإعادة تشغيل خدمة البوابة:
systemctl restart zimaos-gateway.serviceبعد إعادة تشغيل الخدمة، حاول فتح لوحة التحكم مرة أخرى باستخدام المنفذ المستعاد.
لماذا يُستخدم المنفذ 80 في هذا الدليل؟
يعيد دليل الاسترداد ضبط لوحة التحكم تحديدًا إلى المنفذ 80 باعتباره هدفًا معروفًا لاستعادة الوصول. وهذا لا يعني أن كل عملية نشر يجب أن تستخدم المنفذ 80 بشكل دائم؛ فبعد استعادة الوصول، ينبغي إدارة المنافذ بشكل اعتيادي عبر واجهة الويب الموضحة في الدليل.
الأسئلة الشائعة
هل ينبغي استخدام سطر الأوامر في كل مرة أريد فيها تغيير منفذ لوحة تحكم ZimaOS؟
لا. يقدّم الدليل واجهة الويب صراحةً باعتبارها الطريقة الاعتيادية، بينما يقدّم سير عمل سطر الأوامر باعتباره خيارًا للطوارئ أو الإنقاذ.
ما ملف الإعدادات الذي يعدّله الدليل؟
يعدّل إجراء أبريل 2025 الملف /etc/casaos/gateway.ini. ونظرًا إلى أن هذا مسار نظام خاص بإصدار معين، تحقّق منه قبل تطبيق الخطوة نفسها على إصدار أحدث من ZimaOS.
ما الخدمة التي يُعاد تشغيلها بعد تغيير المنفذ؟
يعيد الدليل تشغيل zimaos-gateway.service باستخدام systemctl حتى يصبح إعداد البوابة الجديد ساريًا.
ماذا أفعل إذا لم تُحمّل لوحة التحكم بعد؟
لا يقدّم الدليل المصدر تسلسلًا تشخيصيًا أعمق بعد إعادة تشغيل البوابة. تجنّب تغيير إعدادات نظام أخرى لا علاقة لها بالمشكلة بشكل متكرر؛ وبدلًا من ذلك، تحقّق من إرشادات ZimaOS الخاصة بالإصدار، واطلب الدعم مع تقديم المنفذ الدقيق والإعداد وحالة الخدمة التي لاحظتها.
