‏الانتقال من ‏Bitwarden‏ السحابي إلى ‏Vaultwarden‏ على ‏VPS

‏لماذا الانتقال إلى ‏Vaultwarden‏ باستضافة ذاتية

‏ما يوفره ‏Vaultwarden‏ مقارنةً بـ ‏Bitwarden‏ السحابي

• ‏تكلفة شهرية ثابتة: سعر ‏VPS‏ فحسب، لا اشتراك لكل مستخدم أو ميزة.
• ‏خزائن المؤسسات والمجموعات بلا تكلفة إضافية: متاحة من لحظة التثبيت.
• ‏‏TOTP‏ مدمج: رموز المصادقة الثنائية مخزنة في ‏Vaultwarden‏ دون الحاجة لخطة ‏Bitwarden Premium‏.
• ‏البيانات على بنيتك التحتية: لا يمكن لأي طرف ثالث الوصول إلى خزانتك المشفرة أو سجلات الاتصال.
• ‏توافق تام مع عملاء ‏Bitwarden‏ الرسميين: لا تغيير في العادات لمستخدميك.
• ‏استهلاك منخفض جداً: أقل من 50 ميغابايت من ‏RAM‏ في وضع الراحة.

‏المتطلبات الأساسية قبل البدء

SMTP_HOST=smtp.example.com
[email protected]
SMTP_PORT=587
SMTP_SECURITY=starttls
[email protected]
SMTP_PASSWORD=yourpassword

‏الانتقال من ‏Bitwarden‏ السحابي إلى ‏Vaultwarden‏: الإجراء الكامل

1. 01

   ‏المصادقة على ‏Bitwarden‏ السحابي بالـ ‏CLI

   ‏افتح طرفية وسجّل الدخول إلى حسابك السحابي في ‏Bitwarden‏. الـ ‏CLI‏ يتصل بالخادم الرسمي افتراضياً — لا تغيّر هدف server بعد، يجب أن يستهدف هذا الأمر ‏Bitwarden‏ السحابي:

   bw login

   ‏أدخل بريدك الإلكتروني وكلمة المرور الرئيسية. بعد المصادقة، افتح الخزانة وصدِّر مفتاح الجلسة:

   export BW_SESSION=$(bw unlock --raw)

   ‏الخيار --raw ضروري: بدونه يعرض bw unlock رسالة متعددة الأسطر بدلاً من المفتاح الخام، وستفشل الأوامر التالية.

   ‏تحقق من صلاحية الجلسة:

   bw status

   ‏يجب أن تُظهر الاستجابة "status": "unlocked".

2. 02

   ‏تصدير خزانتك الشخصية بصيغة ‏Bitwarden JSON

   ‏التصدير بصيغة ‏JSON‏ الأصلية لـ ‏Bitwarden‏ (bitwardenjson) يحتفظ بجميع البيانات الوصفية: أنواع الإدخالات، الحقول المخصصة، ‏URIs‏، الملاحظات، ‏TOTP‏. لا تستخدم صيغة ‏CSV‏ التي تفقد هذه المعلومات.

   bw export --format bitwardenjson --output ./bitwarden-personal.json

   ‏Attention : هذا الملف لا يتضمن مرفقاتك. الفجوة الأكبر في التصدير القياسي. يجب تنزيل المرفقات بشكل منفصل (الخطوة 4).

   ‏ملف ‏JSON‏ مشفر من طرف العميل — يحتوي بياناتك في نص واضح. خزّنه في مجلد خاص واحذفه بعد الاستيراد.

3. 03

   ‏تصدير كل مؤسسة بشكل منفصل

   ‏بيانات المؤسسة غير مدرجة في تصدير الخزانة الشخصية. يجب تصدير كل مؤسسة بمعرِّفها الخاص.

   ‏اعرض قائمة مؤسساتك أولاً:

   bw list organizations

   ‏لكل مؤسسة معروضة، دوّن id وصدِّرها:

   bw export --organizationid <id-المؤسسة> --format bitwardenjson --output ./bitwarden-org-<اسم>.json

   ‏كرّر هذا الأمر لكل مؤسسة. في حال ظهور خطأ صلاحيات، تحقق من أنك مالك أو مسؤول المؤسسة.

4. 04

   ‏تنزيل المرفقات

   ‏هذه الخطوة التي تتجاهلها معظم الأدلة. يسرد تصدير ‏JSON‏ الإدخالات لكن لا يتضمن الملفات المرفقة.

   ‏لكل إدخال يمتلك مرفقاً، استخدم الأمر bw get attachment:

   bw list items | jq '.[] | select(.attachments != null) | {id, name, attachments}'

   ‏لتنزيل كل مرفق:

   bw get attachment <اسم-الملف> --itemid <id-الإدخال> --output ./attachments/

   ‏إذا كانت لديك مرفقات كثيرة، يمكن لهذا السكريبت أتمتة التنزيل:

   mkdir -p ./attachments
   bw list items | jq -c '.[] | select(.attachments != null)' | while read item; do
     ITEM_ID=$(echo $item | jq -r '.id')
     ITEM_NAME=$(echo $item | jq -r '.name')
     echo $item | jq -c '.attachments[]' | while read att; do
       ATT_ID=$(echo $att | jq -r '.id')
       ATT_NAME=$(echo $att | jq -r '.fileName')
       bw get attachment "$ATT_NAME" --itemid "$ITEM_ID" --output "./attachments/${ITEM_ID}_${ATT_NAME}"
     done
   done

5. 05

   ‏الاستيراد إلى ‏Vaultwarden

   ‏أولاً، وجِّه الـ ‏CLI‏ نحو نسخة ‏Vaultwarden‏ الخاصة بك:

   bw config server https://vault.yourdomain.com

   ‏سجّل الدخول إلى ‏Vaultwarden‏:

   bw logout
   bw login
   export BW_SESSION=$(bw unlock --raw)

   ‏استورد الخزانة الشخصية:

   bw import bitwardenjson ./bitwarden-personal.json

   ‏للمؤسسات، يجب أولاً إنشاء المؤسسة في واجهة ‏Vaultwarden‏ الويب، ثم استرجاع معرفها:

   bw list organizations

   ‏ثم استورد كل ملف مؤسسة بالمعرف الجديد:

   bw import bitwardenjson ./bitwarden-org-<اسم>.json --organizationid <معرف-جديد>

   ‏أعِد إرفاق المرفقات يدوياً عبر واجهة ‏Vaultwarden‏ الويب.

6. 06

   ‏التحقق من الاستيراد وتحديث العملاء

   ‏قبل اعتبار الانتقال مكتملاً، نفِّذ هذه الفحوصات:

   ‏في واجهة ‏Vaultwarden‏ الويب:
   - عدد الإدخالات يطابق ما كان على ‏Bitwarden‏ السحابي;
   - الحقول المخصصة موجودة على إدخالات مرجعية;
   - رموز ‏TOTP‏ تعمل;
   - المؤسسات ومجموعاتها مرئية.

   ‏على عملاء ‏Bitwarden‏ (إضافة المتصفح، تطبيق الجوال):
   - سجّل الخروج من حساب ‏Bitwarden‏ السحابي;
   - في إعدادات العميل، غيّر ‏URL‏ الخادم إلى https://vault.yourdomain.com;
   - أعد تسجيل الدخول بنفس بيانات الاعتماد.

   ‏انتظر المزامنة الكاملة قبل حذف أي شيء من الحساب القديم.

‏الإعداد بعد الانتقال

0 3 * * * tar -czf /backup/vaultwarden-$(date +%Y%m%d).tar.gz /opt/vaultwarden/data/ 2>/dev/null

‏استكشاف الأخطاء: الأخطاء الشائعة

export BW_SESSION=$(bw unlock --raw)

‏خزانتك المستضافة ذاتياً جاهزة للعمل