26 سبتمبر 2026المنشئ

تثبيت وكيل قاعدة البيانات صار أمرًا واحدًا مع دليل واضح

أصبحت خطوة التثبيت في Settings › Data دليلًا قصيرًا بخطوات مرقّمة مع الأمر كاملًا، ويطلب مثبّت Windows صلاحيات المسؤول بنفسه بدل أن يتوقف برسالة "Access to the path is denied".

في هذا التحديث

أمر PowerShell واحد يثبّت الوكيل ويطلب عنوان قاعدة البيانات ويشغّل خدمة Windows
عند تشغيله من نافذة PowerShell عادية، يفتح المثبّت نافذة بصلاحيات المسؤول بعد موافقتك في Windows
يوضّح الدليل مكان عنوان قاعدة البيانات: سطر mysql_connection_string في server.cfg
صار أمر Linux يطلب عنوان قاعدة البيانات ويكمل الإعداد، بدل أن يتوقف بعد التنزيل
قسم "Something went wrong?" يشرح الأخطاء الشائعة وطريقة فحص الاتصال

الوكيل برنامج صغير يربط قاعدة بيانات سيرفرك بلوحتك. كان تثبيته الخطوة التي يتعثر عندها أغلب المالكين، فصار الآن أمرًا واحدًا مع دليل يمكنك اتباعه دون الرجوع إلى التوثيق.

الدليل

افتح Settings › Data واضغط Connect a database. تبدأ خطوة التثبيت الآن على Windows، بجانب Linux و Docker، وتمر بك بالترتيب:

افتح PowerShell بصلاحيات المسؤول
الصق الأمر، وهو معروض كاملًا مع زر Copy
الصق عنوان قاعدة البيانات عندما يُطلب منك. تجده في سطر mysql_connection_string داخل server.cfg
عُد إلى الصفحة، فهي تنتقل وحدها إلى الخطوة التالية عندما يتصل الوكيل

كان الأمر القديم يتوقف برسالة "Access to the path 'FivePanel' is denied" عندما لا يعمل PowerShell بصلاحيات المسؤول. صار المثبّت يتحقق من ذلك أولًا. من نافذة عادية يفتح نافذة بصلاحيات المسؤول بعد موافقتك في Windows ويكمل فيها. ثم يثبّت الوكيل ويختبر قاعدة البيانات والـ token، ويثبّت الخدمة ويشغّلها، فيعود الوكيل للعمل بعد إعادة التشغيل أيضًا.

Linux

كان أمر Linux يثبّت الوكيل ثم يتوقف، لأنه يملك الـ token دون عنوان قاعدة البيانات. صار الآن يطلب العنوان في الطرفية ويكمل الإعداد، بما في ذلك الخدمة.

عندما يحدث خطأ

تحت الدليل، يعرض قسم Something went wrong? الأخطاء الأكثر شيوعًا وطريقة حل كل منها. ويفحص fivepanel-agent test قاعدة البيانات والاتصال بـ FivePanel ويخبرك أيهما فشل.