ربط NAS عبر Reverse SSH وDocker كوحدة تخزين خاصة (مثال QNAP)

موضوع هذا المقال

عند استخدام Reverse SSH، يقوم NAS الخاص بكم بإنشاء اتصال صادر مشفر (نفق) إلى PaperOffice من تلقاء نفسه. لا حاجة لفتح منافذ في جهاز التوجيه. يقوم PaperOffice AI بعد ذلك بحفظ المستندات المشفرة الخاصة بـWorkspaces على NAS الخاص بكم.

قوموا بإنشاء وحدة التخزين قبل إنشاء Workspace. لا يمكن تغيير وضع التخزين الخاص بـWorkspaces بعد إنشائه.

الخطوة 1: تجهيز NAS (مثال QNAP)

قد تختلف القوائم في QTS اختلافًا طفيفًا حسب إصدار QTS.

  1. قوموا بإنشاء مجلد مشاركة خاص، على سبيل المثال paperoffice، وليس مجلد PaperOffice Classic أو مجلد MariaDB.
  2. اسمحوا بـ SSH وSFTP ضمن لوحة التحكم › خدمات الشبكة والملفات › Telnet / SSH.
  3. أضيفوا هناك ضمن "تعديل صلاحية الوصول" مستخدم NAS الذي ستسجلون الدخول به. إذا لم يكن موجودًا في هذه القائمة، سيرفض NAS تسجيل الدخول عبر SSH.
  4. ثبّتوا Container Station (Docker). يمكنكم الإبقاء على مجلد المشاركة المقترح للحاويات.

Synology: Container Manager، مع تفعيل خدمة المجلد الرئيسي للمستخدم، وأن يكون المستخدم ضمن مجموعة administrators. ASUSTOR: محرك Docker. UGREEN: Docker.

الخطوة 2: إنشاء وحدة تخزين في PaperOffice AI

  1. افتحوا Document AI › Storage Mounts وانقروا على إضافة Storage Mount.
  2. الحقول المميزة بنجمة حمراء (*) هي حقول إلزامية.
  3. اسم لـ Storage Mount هذا: قابل للتحديد بحرية.
  4. مرجع الدفع: استخدام كـ BYOS-Storage.
  5. نوع الاتصال: توصيل مجلد محلي عبر Reverse-SSH.
  6. خادم التخزين (NAS): اختاروا QNAP. سيقترح التطبيق بعد ذلك /share/paperoffice (Synology وASUSTOR وUGREEN: /volume1/paperoffice).
  7. مستخدم SSH المحلي: اسم المستخدم الخاص بكم على NAS. يجب أن يكون عضوًا في مجموعة المسؤولين.
  8. المجلد المحلي: المسار الكامل إلى المجلد، على QNAP /share/<Name des Freigabeordners>. بدون علامات اقتباس أو شرطة مائلة عكسية أو * ? [ ]. لا يمكن تغيير المجلد والمستخدم لاحقًا.
  9. كلمة مرور التشفير وتأكيد كلمة المرور: 16 حرفًا على الأقل، أو إنشاء كلمة مرور آمنة (رمز المفتاح).
  10. انقروا على تنزيل كملف .txt. فقط بعد ذلك يمكن إنشاء وحدة التخزين. احتفظوا بالملف في مكان آمن: بدون كلمة المرور لا توجد إمكانية للاسترداد.
  11. فعّلوا علامة التأكيد واحفظوا.

الخطوة 3: اختيار كتلة الإعداد الصحيحة

بعد الحفظ، يفتح النافذة إعداد Reverse-SSH مع اسم مستعار للنفق الخاص بكم. في الأعلى تختارون النسخة:

  • خادم NAS مع Docker: كتلة تبدأ حاوية tunnel صغيرة. هذا هو الخيار الصحيح لـ QNAP مع Container Station.
  • خادم NAS بدون Docker: الكتلة 1 مرة واحدة عبر SSH، والكتلة 2 في التشغيل التلقائي.
  • Linux / macOS و Windows: لأجهزة الكمبيوتر.

انسخوا الكتلة باستخدام نسخ الإعداد. في حالة خادم NAS بدون Docker، يحتوي كل من الكتلتين على زر خاص به.

الخطوة 4: تسجيل الدخول إلى NAS ولصق الكتلة

على نظام Windows، على سبيل المثال باستخدام PuTTY (قد تختلف التسميات قليلاً حسب الإصدار):

  1. أدخلوا عنوان IP الخاص بـ NAS في الشبكة المحلية في خانة Host، والمنفذ 22، ثم افتحوا الاتصال.
  2. سجّل الدخول باستخدام مستخدم NAS من الخطوة 2. عند إدخال كلمة المرور، لن تظهر أي أحرف. هذا أمر طبيعي.
  3. إذا عرض QNAP قائمة وحدة التحكم (مثل "Console Management") بعد تسجيل الدخول، اخرج منها إلى سطر الأوامر العادي، وذلك حسب إصدار QTS باستخدام Q ثم Y.
  4. انقروا بزر الماوس الأيمن داخل النافذة للصق الكتلة. ثم اضغطوا على Enter.

على جهاز Mac: افتحوا برنامج Terminal، ثم ssh <Benutzer>@<IP-Adresse des NAS>.

تنتمي الكتلة فقط إلى هذه النافذة في NAS. يحتاج NAS إلى اتصال بالإنترنت: يتم إنشاء Tunnel من NAS الخاص بكم إلى الخارج، وتقوم الحاوية بتحميل حزمة Linux صغيرة عند البدء.

الخطوة 5: اختبار الاتصال

  1. افتحوا التخزين تحت Storage Mounts باستخدام تعديل.
  2. انقروا على اختبار الاتصال (يتاح ذلك فقط بعد الحفظ).
  3. النجاح: "Tunnel نشط: يمكن الوصول إلى NAS والمجلد قابل للكتابة." بعد ذلك، أنشئوا Workspace باستخدام التخزين الخاص بكم (BYOS).

إذا أبلغ الاختبار عن رفض تسجيل الدخول، تحققوا من مستخدم NAS وقائمة الوصول من الخطوة 1. ثم أعدوا إدخال الإعداد كمستخدم NAS المسجل واختبروا مرة أخرى.

ما يظهره التتبع

يبدأ اختبار الاتصال في نظرة عامة تتبع PaperOffice مع الخريطة. بالنسبة لـ Reverse SSH، فإن هدف خادم النفق هو خوادم PaperOffice، وليس خوادم NAS الخاصة بكم. تشير مواقع الكائنات إلى عقد الشبكة في هذا المسار، وليس إلى موقع ملفاتكم.

بعد إعادة التشغيل

يبدأ حاوية النفق تلقائيًا بعد كل إعادة تشغيل بمجرد تشغيل Docker. إذا انقطعت الاتصال، فسيتم إعادة الاتصال بعد 10 ثوانٍ. بدون Docker، يتولى الكتلة 2 في بدء التشغيل التلقائي المهمة.

الأمان: يحتوي كتلة الإعداد على مفتاح خاص

تحتوي الكتلة على مفتاح خاص وتسجله كمفتاح تسجيل الدخول لمستخدم NAS الخاص بكم. يمتلك الشخص الذي يملك الكتلة القدرة على انتحال شخصية نفقكم وتسجيل الدخول كمستخدم NAS الخاص بكم حيث يكون خدمة SSH الخاصة بـ NAS متاحة له. لا يظهر كلمة مرور التشفير الخاصة بكم في الكتلة.

  • لا تضيفوا الكتلة أبدًا إلى الدردشات، أو مساعدي الذكاء الاصطناعي، أو رسائل البريد الإلكتروني، أو تذاكر الدعم.
  • لا يحتاج فريق الدعم إلى الكتلة. بدلاً من ذلك، قدموا رسالة الخطأ الخاصة بالاختبار.

Wenn es doch passiert ist:

  1. احذفوا الرسالة حيثما أمكن ذلك.
  2. لا يوجد زر لإعادة إنشاء المفتاح. عند التحرير، يبقى المفتاح كما هو.
  3. إذا لم يستخدم Workspace التخزين بعد: احذفوا Storage Mount. يقوم PaperOffice بإزالة المفتاح من خادم النفق؛ تبقى الملفات على NAS. أنشئوا التخزين مرة أخرى (مفتاح جديد، اسم مستعار للنفق الجديد)، باستخدام نفس كلمة مرور التشفير أو مجلد فارغ.
  4. أزلوا المفتاح القديم على NAS: في مجلد .ssh الخاص بمستخدم NAS، احذفوا السطر في authorized_keys الذي ينتهي بـ "PaperOffice" واسم المستعار القديم للنفق، والملف paperoffice_<alter Tunnel-Alias>. باستخدام Docker: احذفوا الحاوية القديمة من واجهة Docker الخاصة بكم (QNAP: Container Station)، والتي يبدأ اسمها بـ paperoffice-tunnel-. بدون Docker: احذفوا السكربت paperoffice_tunnel_<alter Tunnel-Alias>.sh في نفس مجلد .ssh وأزِلوا الإدخال القديم من بدء التشغيل التلقائي.
  5. إذا كان Workspace يستخدم التخزين بالفعل، فلا يمكن حذفه. أنشئوا بعد ذلك تذكرة دعم في التطبيق تحت الدعم واكتبوا أن المفتاح قد تسرب إلى الخارج. لا تضيفوا الكتلة أثناء ذلك.

المزيد