ورقة مرجعية Envii - نسخ احتياطي مشفر لمتغيرات البيئة
ورقة مرجعية Envii - نسخ احتياطي مشفر لمتغيرات البيئة
Section titled “ورقة مرجعية Envii - نسخ احتياطي مشفر لمتغيرات البيئة”أداة سطر أوامر للنسخ الاحتياطي الآمن واستعادة ملفات .env عبر الأجهزة. تستخدم تشفيرًا من النهاية إلى النهاية (AES-256-GCM) مع عبارة استرداد مكونة من 12 كلمة — الخادم لا يرى أبدًا أسرارك النصية.
التثبيت
Section titled “التثبيت”من npm (عام)
Section titled “من npm (عام)”npm install -g enviiمن المصدر
Section titled “من المصدر”git clone https://github.com/akinloluwami/envii.git
cd envii/envii-cli
npm install
npm run build
npm linkالمتطلبات: Node.js 18+
التهيئة (المرة الأولى فقط)
Section titled “التهيئة (المرة الأولى فقط)”envii initهذا ينشئ عبارة استرداد مكونة من 12 كلمة. احفظها بشكل آمن — إنها الطريقة الوحيدة لفك تشفير نسخك الاحتياطية. لا توجد كلمات مرور، ولا رسائل بريد إلكتروني، ولا حسابات.
حاسم: اكتب عبارة الاسترداد واحفظها في مكان آمن (مدير كلمات المرور، نسخة احتياطية فعلية). إذا فقدتها، نسخك الاحتياطية غير قابلة للاسترداد بشكل دائم.
الأوامر الأساسية
Section titled “الأوامر الأساسية”| الأمر | الوصف |
|---|---|
envii init | تهيئة envii، توليد عبارة الاسترداد |
envii backup | فحص شجرة الدليل الحالية والنسخ الاحتياطي لجميع ملفات .env |
envii restore | تنزيل وفك تشفير جميع ملفات .env المحفوظة |
envii restore --force | الاستعادة والكتابة فوق ملفات .env الموجودة بدون مطالبة |
envii list | قائمة جميع المشاريع ذات النسخ الاحتياطية النشطة |
كيف يعمل
Section titled “كيف يعمل”سير عمل النسخ الاحتياطي
Section titled “سير عمل النسخ الاحتياطي”cd ~/projects # الانتقال إلى جذر مشاريعك
envii backup # يفحص جميع ملفات .env في الأدلة الفرعية- يفحص Envii شجرة الدليل الحالية للمشاريع (محددة بـ
.gitأوpackage.jsonإلخ.) - يتم العثور على جميع ملفات
.env*(.env،.env.local،.env.production، إلخ.) - يتم تشفير كل ملف محليًا باستخدام AES-256-GCM مع اشتقاق المفتاح PBKDF2 (600,000 تكرار)
- يتم إرسال البيانات المشفرة فقط إلى الخادم
- يتم تحديد المشروع بواسطة عنوان URL البعيد لـ Git، أو اسم الحزمة، أو اسم المجلد
سير عمل الاستعادة
Section titled “سير عمل الاستعادة”cd ~/projects # على جهازك الجديد
envii restore # تنزيل وفك تشفير جميع النسخ الاحتياطية- يقوم Envii بتنزيل نسخك الاحتياطية المشفرة
- فك تشفيرها محليًا باستخدام عبارة الاسترداد الخاصة بك
- وضع ملفات
.envمرة أخرى في مساراتها الأصلية للمشروع - المطالبة قبل الكتابة فوق الملفات الموجودة (استخدام
--forceللتخطي)
بنية الأمان
Section titled “بنية الأمان”| الميزة | التفاصيل |
|---|---|
| التشفير | AES-256-GCM |
| اشتقاق المفتاح | PBKDF2 مع 600,000 تكرار |
| IVs فريدة | كل نسخة احتياطية لها متجه تهيئة فريد |
| علامات المصادقة | اكتشاف التلاعب في كل نسخة احتياطية |
| عدم المعرفة | الخادم لا يرى أبدًا عبارة الاسترداد أو النص أو مفاتيح التشفير |
| الاسترداد | عبارة 12 كلمة هي طريقة المصادقة الوحيدة |
وضع التطوير
Section titled “وضع التطوير”| الأمر | الوصف |
|---|---|
envii init --dev | التهيئة ضد API محلي (localhost:4400) |
envii backup --dev | النسخ الاحتياطي باستخدام خادم API محلي |
envii restore --dev | الاستعادة من خادم API محلي |
envii list --dev | قائمة النسخ الاحتياطية من API محلي |
التكوين
Section titled “التكوين”يخزن Envii تكوينه في:
| العنصر | الموقع |
|---|---|
| ملف التكوين | ~/.envii/config.json |
| هاش عبارة الاسترداد | مخزن في التكوين (وليس العبارة نفسها أبدًا) |
سير العمل الشائعة
Section titled “سير العمل الشائعة”# الإعداد الأولي على جهازك الرئيسي
envii init
# ⚠️ احفظ عبارة الاسترداد المكونة من 12 كلمة!
# نسخ احتياطي لجميع ملفات env من دليل المشروع
cd ~/projects
envii backup
# إعداد جهاز جديد
envii init # أدخل نفس عبارة الاسترداد
cd ~/projects
envii restore # جميع ملفات .env مستعادة
# التحقق مما تم نسخه احتياطيًا
envii list
# تحديث النسخ الاحتياطية بعد تغيير متغيرات env
envii backup # إعادة التشفير والتحميل للملفات المحدثةما يتم نسخه احتياطيًا
Section titled “ما يتم نسخه احتياطيًا”يفحص Envii جميع ملفات البيئة التي تطابق الأنماط الشائعة:
.env.env.local.env.development.env.production.env.staging.env.test- متغيرات
.env*الأخرى
يتم اكتشاف المشاريع بوجود:
- دليل
.git(يستخدم عنوان URL البعيد كمعرف) package.json(يستخدم اسم الحزمة)- يعود إلى اسم المجلد
استكشاف الأخطاء وإصلاحها
Section titled “استكشاف الأخطاء وإصلاحها”| المشكلة | الحل |
|---|---|
| ”لم يتم العثور على مشاريع” | تأكد من أنك في دليل به مشاريع (يجب أن يكون به .git أو package.json) |
| فشل الاستعادة | تحقق من أنك تستخدم نفس عبارة الاسترداد كالتهيئة الأصلية |
| عبارة الاسترداد مفقودة | النسخ الاحتياطية غير قابلة للاسترداد — أعد التهيئة وأعد النسخ الاحتياطي |
| رفض الإذن | تأكد من أن دليل ~/.envii/ قابل للكتابة |
| خطأ في الشبكة | تحقق من اتصال الإنترنت؛ يتطلب envii الوصول إلى خادم API |
أفضل الممارسات
Section titled “أفضل الممارسات”- احفظ عبارة الاسترداد في مدير كلمات المرور (1Password، Bitwarden، إلخ.)
- شغل
envii backupقبل التبديل بين الأجهزة أو إعادة التهيئة - لا تلتزم بملفات
.envفي Git — استخدم envii بدلاً من ذلك - شغل نسخ احتياطية دورية بعد تحديث متغيرات البيئة
- استخدم
envii listللتحقق من أن نسخك الاحتياطية حالية