انتقل إلى المحتوى الرئيسي

خطوات إعادة تعيين كلمة مرور مسؤول Portainer

عندما تنسى كلمة مرور حساب مسؤول Portainer وتتعذّر عليك تسجيل الدخول إلى Portainer، يدعم نظام TerraMaster TNAS إعادة تعيين كلمة مرور الحساب عبر أوامر طرفية SSH، وبهذه الطريقة يمكنك إعادة تعيين كلمة مرور تسجيل الدخول admin دون أي خسارة، وبالتالي تسجيل الدخول إلى Portainer بشكل طبيعي من دون إعادة تثبيت التطبيق وفقدان بيانات الإعدادات الحالية.

المتطلبات المسبقة​

  1. افتح طرفية SSH الخاصة بجهاز TNAS
  2. تأكد من أن Portainer في حالة متوقف في مركز التطبيقات على TNAS (يجب إيقافه، وإلا سيكون ملف قاعدة البيانات مشغولًا وستفشل إعادة التعيين)

الخطوات​

1. العثور على مجلد بيانات Portainer​

أولًا، علينا العثور على مجلد بيانات Portainer، الذي يحتوي على portainer\.db.

نفّذ الأمر التالي:

find /Volume1/@apps/Portainer -name "portainer.db"

بعد التنفيذ، سترى ناتجًا مشابهًا لما يلي:

/Volume1/@apps/Portainer/portainer.db

دوّن المسار /Volume1/@apps/Portainer، فهو مجلد البيانات الخاص بك.

2. تنفيذ أمر إعادة التعيين الرسمي​

استبدل /path/to/portainer في الأمر التالي بـ مسار مجلد البيانات الذي وجدته في الخطوة السابقة، ثم انسخه ونفّذه في الطرفية:

docker run --rm -v /path/to/portainer:/data portainer/helper-reset-password

مثال:

إذا كان مجلد البيانات الخاص بك هو /Volume1/@apps/Portainer، فسيكون الأمر الكامل كما يلي:

docker run --rm -v /Volume1/@apps/Portainer:/data portainer/helper-reset-password

3. الحصول على كلمة المرور الجديدة​

بعد تنفيذ الأمر، ستُخرج الطرفية محتوى مشابهًا لما يلي:

2025/04/22 12:00:00 Password successfully updated for user: admin
2025/04/22 12:00:00 Use the following password to login:  aBcD1234!@#$
  • السطر الأول يعني أن إعادة التعيين قد نجحت
  • كلمة المرور aBcD1234!@#$ في السطر الثاني هي كلمة المرور المؤقتة الجديدة، فانسخها!

4. تشغيل Portainer وتسجيل الدخول​

  1. عد إلى مركز التطبيقات على TNAS، وأعد تشغيل Portainer
  2. افتح صفحة Portainer الإلكترونية (العنوان الافتراضي: http://your_TNAS_IP:9000)
  3. أدخل admin في حقل اسم المستخدم، والصق كلمة المرور المؤقتة التي نسختها في الخطوة السابقة، وستتمكن من تسجيل الدخول!

5. (يُنصح بشدة) تغيير كلمة المرور إلى كلمة مرورك الخاصة فور تسجيل الدخول​

  1. بعد تسجيل الدخول إلى Portainer، انقر على صورة المستخدم في الزاوية العلوية
  2. اختر My Account → Change Password
  3. أدخل كلمة المرور المؤقتة، وعيّن كلمة مرورك الجديدة، ثم احفظ

الأسئلة الشائعة​

1. لماذا يجب إيقاف Portainer أولًا؟​

لأن Portainer يقفل الملف portainer.db أثناء تشغيله، ولا تستطيع أداة إعادة التعيين تعديله. وبعد الإيقاف يُحرَّر الملف، وعندها تنجح إعادة التعيين.

2. هل ستبقى المستخدمون والإعدادات التي أنشأتها سابقًا بعد إعادة التعيين؟​

تقتصر هذه العملية على إعادة تعيين كلمة مرور حساب admin فقط، ولن تحذف أو تغيّر المستخدمين الآخرين أو بيئة التشغيل أو ملفات القوالب أو أي من معاملات إعدادات النظام.

3. يظهر الأمر الرسالة docker: command not found؟​

هذا يعني أن محرك Docker غير مفعّل على جهاز TNAS. توجه أولًا إلى مركز التطبيقات على TNAS، وثبّت Docker Engine وفعّله، ثم عد ونفّذ الأمر.

4. لم تظهر كلمة المرور بعد تنفيذ الأمر؟​

  • تحقق من صحة مسار مجلد البيانات
  • تأكد من أن Portainer قد توقف تمامًا
  • نفّذ الأمر مرة أخرى